Skip to content

Add meta/agent-roles/ named CMUX worker roles - #5

Merged
caseycapshaw merged 1 commit into
mainfrom
agent-roles-and-spawn
Jul 9, 2026
Merged

Add meta/agent-roles/ named CMUX worker roles#5
caseycapshaw merged 1 commit into
mainfrom
agent-roles-and-spawn

Conversation

@casey-capshaw-rbrk

Copy link
Copy Markdown
Contributor

Summary

  • New meta/agent-roles/ — one system-prompt fragment per KB-native worker role (research, compile, lint, initiative-worker), mapped onto this kit's own raw→compile→index→lint verbs and initiative-delegation model rather than a generic app-build split.
  • Plain markdown files, not an auto-discovered agent-type config path — keeps them from registering as available agent types in every session and avoids resting on an untested assumption about the MCP-fleet-bloat problem already documented for native in-process subagents.
  • meta/AGENTS.md § Optional extensions: notes the role-file convention and that launch steps can be wrapped behind a custom slash command/macro if your agent CLI supports one — described as guidance, not shipped as a literal command file (deliberately, since command-config directories are elsewhere excluded from this kit's copy conventions).
  • Both CMUX Jobs/ runbooks' launch steps updated to --append-system-prompt the matching role file (absolute path, since a worker's cwd may not be the vault root).

Test plan

  • Kit's own meta/bin/lint.sh green
  • Grepped for leaked personal identifiers — clean (only pre-existing hit is an untouched CI workflow file)
  • Read full diff before committing

Gives CMUX workers a named identity instead of a blank agent: one
system-prompt fragment per KB-native role (research, compile, lint,
initiative-worker) mapped onto this kit's own raw->compile->index->lint
verbs and initiative-delegation model, not a generic app-build split.

Plain files under meta/agent-roles/, not auto-discovered agent-type
config -- keeps them from leaking into ordinary sessions and avoids
resting on an untested assumption about the MCP-bloat problem already
documented for native subagents. AGENTS.md also notes that launch
steps can be wrapped behind a custom slash command/macro if the
agent CLI supports one, without shipping one as a literal file.

Both CMUX runbooks' launch steps updated to append the matching role
file (absolute path, since a worker's cwd may not be the vault).
@claude

claude Bot commented Jul 9, 2026

Copy link
Copy Markdown

VERDICT: PASS

Reviewed the diff (a8e7fb0..0895615, "Add meta/agent-roles/ named CMUX worker roles + AGENTS.md guidance").

Privacy: clean. New files (meta/agent-roles/{research,compile,lint,initiative-worker}.md) and the edits to the two CMUX Jobs/ runbooks + meta/AGENTS.md use only generic placeholders (<model-id>, <vault>, <slug>, <label>) — no real names, hosts, paths, or credentials.

Schema consistency: meta/agent-roles/ sits inside the already-structural meta/ folder, so it doesnt touch the root-inbox check, and lint.sh only scans concepts/Initiatives/Jobs/People/index.md — these new role files (their own role/model/mcp/sentinel frontmatter, not concept frontmatter) dont trip the frontmatter check. References to the new folder use backtick paths, not [[wikilinks]], so meta/link-map.md needs no regen. Sentinel formats line up between the role files and the two Jobs runbooks that launch them (e.g. "DONE: | ..." in initiative-worker.md matches the kickoff brief in "Delegate an initiative to a CMUX workspace.md"; "DONE: research- | ..." matches the pane example in "Spawn subagent panes in a CMUX workspace.md").

Doc coherence: meta/AGENTS.md section Optional extensions documents the new folder consistently with the Related sections added to both Jobs files. Minor, non-blocking note: like the pre-existing meta/optional/automation/ bundle, this new folder isnt called out in CLAUDE.mds folder table or setup.md — not introduced by this PR, just a pre-existing gap worth a follow-up pass if those docs get updated.

@caseycapshaw
caseycapshaw merged commit bac2420 into main Jul 9, 2026
2 checks passed
@caseycapshaw
caseycapshaw deleted the agent-roles-and-spawn branch July 13, 2026 19:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants