Add optional CMUX multi-agent orchestration runbooks - #3
Conversation
Ports two generic Jobs/ runbooks for driving a CMUX-style terminal multiplexer as an ephemeral runtime layer on top of the vault's durable memory (workspace-level initiative delegation, pane-level subagent fan-out), plus the two-interface model as a new optional-extensions paragraph in meta/AGENTS.md.
| owner: {{NAME}} | ||
| status: active | ||
| tags: [job, env] | ||
| aliases: [Delegate to a workspace, Spin up a CMUX workspace, Delegate an initiative] |
There was a problem hiding this comment.
Schema consistency: this Job adds a new note with aliases:, but meta/link-map.md wasn't regenerated (meta/bin/build-link-map.sh). Per meta/AGENTS.md § Conventions: "Regenerate after adding/renaming any concept, person, or job." Right now none of this job's aliases (or the sibling Spawn subagent panes... job's aliases) resolve via the link map. Same applies to Jobs/Spawn subagent panes in a CMUX workspace.md.
| aliases: [Delegate to a workspace, Spin up a CMUX workspace, Delegate an initiative] | ||
| --- | ||
|
|
||
| ## Model — orchestrator: a capable model (Claude Code lead). Delegated workspace agent: a capable or cheaper model by task weight. |
There was a problem hiding this comment.
Minor schema deviation: the ## Model — line sits before the # Job — ... title (h2 before h1), and Jobs/Jobs TEMPLATE.md has no "Model" section at all. Every other job in Jobs/ follows frontmatter → # Job — Title → ## When to run this → ... Consider either folding this into the frontmatter/blockquote header or moving it under the title so the heading hierarchy and template shape stay consistent. Same pattern in Jobs/Spawn subagent panes in a CMUX workspace.md:13.
| tools: cmux, Claude Code, git, Initiatives/ | ||
| owner: {{NAME}} | ||
| status: active | ||
| tags: [job, env] |
There was a problem hiding this comment.
Nit: tags: [job, env] — the one existing precedent for a second tag mirrors domain: (Optimize the knowledge base.md has domain: kb-meta / tags: [job, kb-meta]). Here domain: kb-meta but the tag is env, which is inconsistent with that pattern. Not blocking, just worth aligning. Same on Jobs/Spawn subagent panes in a CMUX workspace.md:9.
|
VERDICT: ISSUES Reviewed against Privacy: clean. Both new Jobs use Schema consistency issues (non-blocking, please fix):
Doc coherence: good — Left inline comments with specifics. Regenerating the link map is the one I'd actually want fixed before merge; the rest are polish. |
- Regenerate meta/link-map.md so the two new CMUX jobs and their aliases resolve - Fold the pre-title "## Model" line into each job's summary blockquote, restoring the template's frontmatter → title → sections shape - Mirror domain in tags: [job, env] → [job, kb-meta] Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
VERDICT: PASS Reviewed the CMUX runbook addition ( Privacy: No personal/instance-specific content. Schema consistency: Both new Jobs are indexed in Doc coherence: The new AGENTS.md paragraph was appended under the existing "## Optional extensions" heading, in the same style as the Excalidraw/automation paragraphs above it. No issues found. |
Two refinements to the CMUX orchestration runbooks landed in #3: - Launch pane workers lean (`--strict-mcp-config` + empty mcp-config) so a large MCP fleet's tool schemas don't crowd out a worker's context — the same bloat that can make an in-process subagent/Task tool unusable, which is why explicit pane workers are the reliable path. Documented in both runbooks + the AGENTS.md § Optional extensions model note. - Reframe the control-socket wording as a routine, no-setup sanity check (the in-pane socket works out of the box under the default cmuxOnly); config only matters to drive CMUX from outside a pane. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Two refinements to the CMUX orchestration runbooks landed in #3: - Launch pane workers lean (`--strict-mcp-config` + empty mcp-config) so a large MCP fleet's tool schemas don't crowd out a worker's context — the same bloat that can make an in-process subagent/Task tool unusable, which is why explicit pane workers are the reliable path. Documented in both runbooks + the AGENTS.md § Optional extensions model note. - Reframe the control-socket wording as a routine, no-setup sanity check (the in-pane socket works out of the box under the default cmuxOnly); config only matters to drive CMUX from outside a pane. Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Summary
Jobs/runbooks for driving a CMUX-style terminal multiplexer as an ephemeral runtime layer on top of the vault's durable memory: workspace-level initiative delegation, and pane-level subagent fan-out.meta/AGENTS.md§ Optional extensions, following the same pattern as the existing Excalidraw extension.concepts/jobs.md.Entirely opt-in — nothing else in the KB depends on this; skip it if you're not running a multi-agent terminal tool.
Test plan
[[Delegate an initiative to a CMUX workspace]]and[[Spawn subagent panes in a CMUX workspace]]resolve viameta/bin/lint.sh/ link-map tooling