gabriel / muse public
docs BREAKING task/add-agent-guide #1 / 1
gabriel · 168 days ago · Apr 7, 2026 · Diff

docs: add agent-guide.md — public shareable ecosystem context for AI agents

Extracts the full ecosystem workflow guide (previously private in ~/.claude/CLAUDE.md) into docs/agent-guide.md so it can be versioned, shared, and referenced by all three repos' CLAUDE.md files.

Covers: ecosystem layout, no-git rule, sub-agent boilerplate, core workflow commands, code intelligence, coord, worktrees, workspace, Muse Flow, deploy procedure, provenance, MSign auth, living docs rule, no-legacy rule.

CLAUDE.md now composes @docs/agent-guide.md + @AGENTS.md.

sha256:2f807c59c03280de26b1a4f277e05904eb3e9821cd3c81c70fbaf225a26d9305 sha
sha256:dc8c6246aa6380946cae4206578c5092ff4c38efb36e9b589aa2176f28671cd9 parent
+56 symbols
sha256:27c0aa5dba01b2043be4acd01107f2c4cacff0b46acaad8bd9cc9dda168d506b snapshot
+56
symbols added
0
dead code introduced
Semantic Changes 56 symbols
~ docs/agent-guide.md .md 56 symbols added
+ Muse Ecosystem — Agent Guide section Muse Ecosystem — Agent Guide L1–511
+ Deploying to Staging and Production section Deploying to Staging and Production L308–356
+ 211) section Production (musehub.ai, IP 98.89.99.211) L336–356
+ code[bash]@L340 variable variable code[bash]@L340 L340–351
+ 39) section Staging (staging.musehub.ai, IP 23.22.27.39) L312–336
+ code[bash]@L314 variable variable code[bash]@L314 L314–335
+ Living Documentation — Type Contracts and Tests Must Stay Current section Living Documentation — Type Contracts and Tests Must Stay Current L478–501
+ Muse Auth — MSign (Ed25519 per-request signing) section Muse Auth — MSign (Ed25519 per-request signing) L387–478
+ Agent subprocess key injection section Agent subprocess key injection L465–478
+ code[bash]@L469 variable variable code[bash]@L469 L469–473
+ How MSign works section How MSign works L412–429
+ code@L416 variable variable code@L416 L416–419
+ code@L421 variable variable code@L421 L421–424
+ Identity store section Identity store L391–404
+ code[toml]@L395 variable variable code[toml]@L395 L395–403
+ Making raw API calls section Making raw API calls L429–461
+ code[python]@L431 variable variable code[python]@L431 L431–460
+ Setup (first time on a new hub) section Setup (first time on a new hub) L404–412
+ code[bash]@L406 variable variable code[bash]@L406 L406–411
+ When a push returns 404 ("Repository not found on remote") section When a push returns 404 ("Repository not found on remote") L461–465
+ Muse Code Intelligence — Replace Your Reflexes section Muse Code Intelligence — Replace Your Reflexes L217–266
+ Pre-task ritual section Pre-task ritual L242–266
+ code[bash]@L244 variable variable code[bash]@L244 L244–263
+ Three questions, three tools — do not confuse them section Three questions, three tools — do not confuse them L236–242
+ table@L223 section table@L223 L223–235
+ Muse Coord — Multi-Agent Coordination section Muse Coord — Multi-Agent Coordination L148–174
+ code[bash]@L152 variable variable code[bash]@L152 L152–171
+ Muse Core Workflow — Replace Your Git Reflexes section Muse Core Workflow — Replace Your Git Reflexes L63–148
+ Commands section Commands L94–127
+ table@L96 section table@L96 L96–126
+ Cross-repo operations — always use -C section Cross-repo operations — always use -C L67–94
+ code[bash]@L71 variable variable code[bash]@L71 L71–76
+ code[bash]@L78 variable variable code[bash]@L78 L78–83
+ code[bash]@L85 variable variable code[bash]@L85 L85–93
+ MuseHub Connection section MuseHub Connection L138–148
+ code[bash]@L140 variable variable code[bash]@L140 L140–145
+ Tags and Releases section Tags and Releases L127–138
+ code[bash]@L129 variable variable code[bash]@L129 L129–137
+ Muse Flow — Branch Topology section Muse Flow — Branch Topology L266–308
+ The standard cycle section The standard cycle L281–308
+ code[bash]@L283 variable variable code[bash]@L283 L283–305
+ code@L268 variable variable code@L268 L268–278
+ Muse Provenance — First-Class Agent Metadata class section Muse Provenance — First-Class Agent Metadata L356–387
+ code[bash]@L360 variable variable code[bash]@L360 L360–367
+ code[bash]@L377 variable variable code[bash]@L377 L377–384
+ Muse Workspace — Multi-Repo Composition section Muse Workspace — Multi-Repo Composition L191–217
+ code[bash]@L195 variable variable code[bash]@L195 L195–205
+ code[bash]@L207 variable variable code[bash]@L207 L207–214
+ Muse Worktree — Parallel Branch Work section Muse Worktree — Parallel Branch Work L174–191
+ code[bash]@L178 variable variable code[bash]@L178 L178–186
+ section No Legacy. No Deprecated. No Exceptions. L501–511
+ section Non-Negotiable: No git. No GitHub. Ever. L29–41
+ Sub-Agents Must Use Muse Too section Sub-Agents Must Use Muse Too L41–63
+ code@L53 variable variable code@L53 L53–60
+ The Ecosystem — Three Repos, One Platform section The Ecosystem — Three Repos, One Platform L13–29
+ table@L17 section table@L17 L17–22
~ CLAUDE.md .md
← Older Oldest on task/add-agent-guide
All commits
Newer → Latest on task/add-agent-guide

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:2f807c59c03280de26b1a4f277e05904eb3e9821cd3c81c70fbaf225a26d9305 --body "your comment"