gabriel / muse public
docs minor task/json-field-reference #1 / 1
AI Agent gabriel · 171 days ago · Apr 10, 2026 · Diff

docs: add JSON field reference section to eliminate agent Gitisms

Every major muse --json command now has a verified output schema with real field names, captured from live muse output. Includes a Global Gitism Glossary mapping the wrong Git-era keys agents reach for by muscle memory to the correct Muse keys.

Added to both AGENTS.md and docs/agent-guide.md (which is @-included in all three repos via CLAUDE.md and the private global context).

Covers: status, log, show, branch, diff, rev-parse, symbolic-ref, reflog, stash, merge --dry-run, snapshot-diff, workspace status, code symbols, code grep, code cat, code impact, code deps, code dead, code gravity, code compare, code breakage, code hotspots, code codemap, code api-surface, code semantic-test-coverage, code clones, code languages, code test, code find-symbol, code symbol-log.

sha256:1405769b375d2c14c25b533eb070731b48da99595c40a93ba826198a54183386 sha
sha256:1b06c30c3c1ef33d54b84efed3ab027d0ddc2cb89af9d46b2bdd79687a038c56 parent
+52 ~3 symbols
sha256:b7882977af480ff5f8a514ff457bc36c998b6aed75a8a0a21e6d0476782d4040 snapshot
+52
symbols added
~3
symbols modified
0
dead code introduced
Semantic Changes 55 symbols
~ AGENTS.md .md 32 symbols added, 1 symbol modified
+ JSON Field Reference — Agent-Exact Output Schemas section JSON Field Reference — Agent-Exact Output Schemas L1194–1927
+ Global Gitism Glossary section Global Gitism Glossary L1903–1927
+ muse branch --json section muse branch --json L1302–1327
+ muse code api-surface --json section muse code api-surface --json L1729–1755
+ muse code breakage --json section muse code breakage --json L1670–1691
+ muse code cat "<address>" --json section muse code cat "<address>" --json L1536–1559
+ muse code clones --json section muse code clones --json L1795–1818
+ muse code codemap --json section muse code codemap --json L1709–1728
+ muse code compare <ref_a> <ref_b> --json section muse code compare <ref_a> <ref_b> --json L1645–1669
+ muse code dead --json section muse code dead --json L1599–1626
+ muse code deps "<file>" --json section muse code deps "<file>" --json L1582–1598
+ muse code find-symbol --name "<name>" --json section muse code find-symbol --name "<name>" --json L1855–1878
+ muse code gravity --explain "<address>" --json section muse code gravity --explain "<address>" --json L1627–1644
+ muse code grep "<pattern>" --json section muse code grep "<pattern>" --json L1511–1535
+ muse code hotspots --json section muse code hotspots --json L1692–1708
+ muse code impact "<address>" --json section muse code impact "<address>" --json L1560–1581
+ muse code languages --json section muse code languages --json L1819–1837
+ muse code semantic-test-coverage --json section muse code semantic-test-coverage --json L1756–1794
+ muse code symbol-log "<address>" --json section muse code symbol-log "<address>" --json L1879–1902
+ muse code symbols --json section muse code symbols --json L1483–1510
+ muse code test --dry-run --json section muse code test --dry-run --json L1838–1854
+ muse diff --json section muse diff --json L1328–1349
+ muse log --json section muse log --json L1236–1272
+ muse merge --dry-run <branch> --json section muse merge --dry-run <branch> --json L1427–1447
+ muse reflog --json section muse reflog --json L1372–1393
+ muse rev-parse <ref> --json section muse rev-parse <ref> --json L1350–1357
+ muse show --json section muse show --json L1273–1301
+ muse snapshot-diff <commit_a> <commit_b> --json section muse snapshot-diff <commit_a> <commit_b> --json L1448–1462
+ muse stash --json / muse stash list --json section muse stash --json / muse stash list --json L1394–1426
+ muse status --json section muse status --json L1201–1235
+ muse symbolic-ref HEAD --json section muse symbolic-ref HEAD --json L1358–1371
+ muse workspace status --json section muse workspace status --json L1463–1482
~ Muse — Agent Contract
~ docs/agent-guide.md .md 20 symbols added, 2 symbols modified
+ JSON Field Reference — Agent-Exact Output Schemas section JSON Field Reference — Agent-Exact Output Schemas L532–954
+ Global Gitism Glossary section Global Gitism Glossary L935–954
+ muse branch --json section muse branch --json L628–651
+ muse code cat "<address>" --json section muse code cat "<address>" --json L828–851
+ muse code compare <ref_a> <ref_b> --json section muse code compare <ref_a> <ref_b> --json L912–934
+ muse code dead --json section muse code dead --json L886–911
+ muse code deps "<file>" --json section muse code deps "<file>" --json L873–885
+ muse code grep "<pattern>" --json section muse code grep "<pattern>" --json L803–827
+ muse code impact "<address>" --json section muse code impact "<address>" --json L852–872
+ muse code symbols --json section muse code symbols --json L775–802
+ muse diff --json section muse diff --json L652–670
+ muse log --json section muse log --json L570–604
+ muse merge --dry-run <branch> --json section muse merge --dry-run <branch> --json L734–754
+ muse reflog --json section muse reflog --json L693–714
+ muse rev-parse <ref> --json section muse rev-parse <ref> --json L671–678
+ muse show --json section muse show --json L605–627
+ muse stash list --json section muse stash list --json L715–733
+ muse status --json section muse status --json L538–569
+ muse symbolic-ref HEAD --json section muse symbolic-ref HEAD --json L679–692
+ muse workspace status --json section muse workspace status --json L755–774
~ Muse Ecosystem — Agent Guide
~
← Older Oldest on task/json-field-reference
All commits
Newer → Latest on task/json-field-reference

0 comments

No comments yet. Be the first to start the discussion.

To add a comment, use the Muse CLI: muse hub commit comment sha256:1405769b375d2c14c25b533eb070731b48da99595c40a93ba826198a54183386 --body "your comment"