[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76WW4CF6MWAZFXCF68PX8WW":3,"skill-same:01M76WW4CF6MWAZFXCF68PX8WW":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":25,"repositoryHtmlUrl":26,"repositoryHomepageUrl":27,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M76WW4CF6MWAZFXCF68PX8WW","magus-commit-composition",null,"egladman\u002Fmagus","egladman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F8713153?v=4","01M75H42QB5A4X82APZF4H44GM","Eli Gladman","01M75H42R1K59Z7JWAP621J849",3,"GPL-3.0","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-commit-composition\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"{{if .Full}}# Composing unpushed commits into reviewable chunks{{else}}# Commit composition{{end}}\n\n{{if .Full}}A reviewer reads commits, not diffs. Work committed in the order it occurred to\nyou arrives as a log nobody can review: a rename spread over four commits, a fix\nburied in a regeneration, notes-to-self between two real changes. This skill decides\nwhat belongs in each commit, so every commit is one idea a reviewer can accept or\nreject alone. The workspace models its own boundaries: use them, not directory\nnames.\n\nmagus does not rewrite history for you, the same way it reports what a\nchange affects without editing it. It shows the seams and proves afterwards that\nnothing was lost; your VCS performs the edit.{{else}}Reviewer reads commits, not diffs.\nDecide what belongs in each commit: every commit one idea, accepted or rejected alone.\nUse workspace's own boundaries, not directory names.\nmagus does not rewrite history: shows seams, proves afterwards nothing lost; your VCS edits.{{end}}\n\n{{if .Full}}## Two constraints that decide most groupings{{else}}## Two constraints{{end}}\n\n{{if .Full}}**Only unpushed work is eligible.** Published commits are fixed. Establish what is\nunpushed before planning; a branch with no upstream has\npublished nothing.{{else}}Only unpushed work eligible; published commits fixed.\nEstablish unpushed set before planning.{{end}}\n\n{{if .Full}}**Generated output belongs with the source that moved it.** Split them and the\nsource commit fails its own drift gate.{{else}}Generated output belongs with source that moved it; split -> source commit fails drift gate.{{end}}\n\n```sh\nmagus describe file \u003Cchanged-path>...\n```\n\n{{if .Full}}Every `output` path joins the `source` change that invalidated it. A commit that is\nall regeneration missed that pairing: fold it into the change that caused it.{{else}}Every `output` path joins `source` change that invalidated it.\nCommit of all regeneration missed pairing -> fold into causing change.{{end}}\n\n{{if .Full}}## Ask the workspace where the seams are{{else}}## Ask workspace for seams{{end}}\n\n```sh\nmagus ls                             # the projects: the coarsest real boundary\nmagus describe project \u003Cpath>        # its declared sources, outputs, depends_on\nmagus affected --impact              # what a candidate group actually reaches\nmagus refs \u003Csymbol> --occurrences    # every site of a rename, uncapped\n```\n\nThree signals, strongest first:\n{{if .Full}}\n- **Project ownership.** Changes in projects with no dependency edge between them\n  are separate commits. Read the edges from `{{cmd \"describe project\"}}`,\n  which frequently disagrees with what the directory layout suggests.{{else}}- Project ownership: projects with no dependency edge between them -> separate commits; edges from `{{cmd \"describe project\"}}`.{{end}}\n{{if .Full}}- **Blast radius.** Groups that reach disjoint project sets are separable; groups\n  that reach the same set usually want one commit.{{else}}- Blast radius: groups reaching disjoint project sets -> separable; same set -> usually one commit.{{end}}\n{{if .Full}}- **Symbol coupling.** A rename's sites belong together, however many directories\n  they span. If refs reports a project not-indexed, run\n  `{{cmd \"graph build\"}}` first: `unknown, not absent` is not an empty result.{{else}}- Symbol coupling: rename's sites together, however many directories.{{end}}\n\n{{if .Full}}## Where this stops{{else}}## Limits{{end}}\n\n{{if .Full}}**Two changes inside one file cannot be separated by path.** A file carrying a\nrename and a behavior fix needs hunk-level work, or they ship together. Recognize it\nwhile planning; discovering it\nmid-restructure turns a cleanup into a recovery.{{else}}Two changes inside one file cannot be separated by path.\nFile with rename and behavior fix -> hunk-level work, or ship together; recognize while planning.{{end}}\n\n{{if .Full}}Prefer the cheapest operation that makes the branch reviewable. In rising order of\nrisk:\n{{else}}Prefer cheapest operation making branch reviewable. Rising risk:{{end}}\n{{if .Full}}1. Reword a message.{{else}}1. Reword message.{{end}}\n{{if .Full}}2. Fold a regeneration into its neighbor.{{else}}2. Fold regeneration into neighbor.{{end}}\n{{if .Full}}3. Drop a commit whose content the final tree does not keep.{{else}}3. Drop commit whose content final tree does not keep.{{end}}\n4. Reorder independent commits.\n{{if .Full}}5. Split one commit into several.{{else}}5. Split one commit into several.{{end}}{{if .Full}}\n\nMost branches need only the first three.{{end}}\n\n{{if .Full}}## Before you start, and after you finish{{else}}## Before start, after finish{{end}}\n\n{{if .Full}}Record the identity of the state you are about to rewrite:{{else}}Record state identity before rewriting:{{end}}\n\n```sh\nmagus vcs checkpoint          # revision, branch, dirty flag, patch digest; writes nothing\n```\n\n{{if .Full}}Restructure with your VCS. When it stops on a conflicted generated file, settle it\nwith magus, not by hand:{{else}}Restructure with your VCS.\nWhen it stops on conflicted generated file -> settle with magus, not by hand:{{end}}\n\n```sh\nmagus vcs resolve             # settles the conflicted declared outputs, regenerates once\n```\n\n{{if .Full}}**Prove the content survived.** A restructure changes history and nothing else, and\na lost commit still leaves a tree that builds, which is why\na green suite is not evidence here:{{else}}Prove content survived: restructure changes history and nothing else; lost commit still leaves building tree.{{end}}\n\n```sh\nmagus graph diff --rev \u003Ccheckpoint-revision>\n```\n\n{{if .Full}}Everything it reports must be a change you intended. Missing nodes you did not\nremove mean the restructure dropped work: return to the recorded revision and start\nagain, never reconcile by hand.{{else}}Everything reported must be intended change.\nMissing nodes you did not remove -> work dropped -> return to recorded revision, restart; never reconcile by hand.{{end}}\n\n{{if .Full}}Finish by listing what the commit wants, staging that list, and re-running the gate:{{else}}Finish: list what the commit wants, stage it, re-run gate:{{end}}\n\n```sh\nmagus vcs ls-files -o name | git add --pathspec-from-file=-\nmagus affected ci\n```\n\n{{if .Full}}## What does not belong in a commit at all{{else}}## Not commit content at all{{end}}\n\n{{if .Full}}Session notes and scratch plans are not repository content unless the repository\nalready tracks them; check the path's history on the base branch\nbefore assuming either way. Untracked session state belongs in your harness's\nmemory, not the branch, and dropping those commits is\noften the single largest reduction available.{{else}}Session notes, scratch plans: not repository content unless repository already tracks them.\nUntracked session state: harness memory, not branch.{{end}}\n\n## See also\n\n{{if .Full}}- {{skill \"vcs-hygiene\"}} covers classifying paths and staging one commit safely.{{else}}- {{skill \"vcs-hygiene\"}}: classifying paths, staging one commit safely.{{end}}\n",{},"main","5f0df014d9eaf4aea1a930b0bd13c3338e2642de","internal\u002Fagent\u002Fskills\u002Fmagus-commit-composition",0,"https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus","http:\u002F\u002Feli.gladman.cc\u002Fmagus\u002F","https:\u002F\u002Fgithub.com\u002Fegladman","eli.gladman.cc","2026-11-14 12:23:44",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add egladman\u002Fmagus --skill magus-commit-composition",{"tool":37,"command":38},"bunx","bunx skills add egladman\u002Fmagus --skill magus-commit-composition",{"tool":40,"command":41},"pnpm","pnpm dlx skills add egladman\u002Fmagus --skill magus-commit-composition","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-commit-composition\u002FSKILL.md",true,[],[46,52,58,64,70,76],{"skillNo":47,"name":48,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":18},"01M76WWZ75J70NCG0TR23XDDE6","magus-workspace-rules","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-workspace-rules\u002FSKILL.md",[],[],{"skillNo":53,"name":54,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":18},"01M76WWX72SY78KG03AVYFE768","magus-vcs-hygiene","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-vcs-hygiene\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":18},"01M76WWTJYGRCKKXH948KN6RR3","magus-upstream-source","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-upstream-source\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M76WWRTBBAPNKM0PA2NG5Q3N","magus-upstream-docs","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-upstream-docs\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":18},"01M76WWNTF03H9S5CN22QBX5ZK","magus-test-design","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-test-design\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M76WWJX1FPSWYD1RB8JXNF3C","magus-sdk","https:\u002F\u002Fgithub.com\u002Fegladman\u002Fmagus\u002Fblob\u002Fmain\u002Finternal\u002Fagent\u002Fskills\u002Fmagus-sdk\u002FSKILL.md",[],[]]