| name | mutagent-builder |
| description | The ADL ② BUILD stage: implements a validated agentspec.yaml into a target framework or harness.
Owns *build + the two agents (ai-engineer Actor · ai-architect Verifier); *build dispatches them
through a TDD + coverage loop. The *sync-spec COMMAND is owned by mutagent-agentspec — builder
provides the ai-architect #sync-spec MODE (the single implementation-reader) that agentspec's
*sync-spec delegates to (Helix-mediated), and that *build reuses build-internally when code drifted
ahead. ai-engineer applies any resulting gated spec writes.
|
| license | Apache-2.0 |
| compatibility | Designed for Claude Code, Codex, Cursor, OpenCode and similar coding-agent runtimes; works with git, gh CLI, and Bun/pnpm/npm runtimes. |
| metadata | {"author":"mutagent","version":"0.1.0-alpha.1"} |
mutagent-builder
The ADL ② BUILD stage. Invoke this skill after mutagent-agentspec has emitted and validated an
agentspec.yaml. BUILD consumes the Definition, implements it into the chosen target, and hands the
result to EVALUATE.
§0 — Setup Detection
mutagent-builder ships the write-capable ai-engineer Actor and read-only ai-architect Verifier.
The parent session routes *build here through Helix; BUILD ownership stays in this package. The
*sync-spec COMMAND lives in mutagent-agentspec and delegates its code-read to this package's
ai-architect #sync-spec mode (Helix-mediated) — builder owns the reader, agentspec owns the command.
§0.1 — Star-commands
| Command | Kind | Owner | Binds | Purpose |
|---|
*build | agent-chain | own (full) | references/workflows/build-protocol.md + assets/agents/* | Implement a schema-valid agentspec.yaml into the pinned target framework/harness with TDD + coverage gates. |
*sync-spec is NOT a builder command — mutagent-agentspec owns it. Builder provides the
ai-architect #sync-spec MODE (the single implementation-reader): the deterministic freshness probe
scripts/sync-spec/check-sync-spec.ts + assets/agents/ai-architect.md#sync-spec (read-only draft) +
assets/agents/ai-engineer.md (gated write). AgentSpec's *sync-spec delegates to this mode; *build
reuses it build-internally on drift. Reverse-generate = drift-from-nothing → cold construct + warm
reconcile are one op.
Star-command resolution contract
When you encounter a *<name> token:
- RESERVED —
* marks a command. NOT prose, NOT a file path, NOT an external shortcut.
- RESOLVE — look up
<name> in the table above. Not found ⇒ ERROR + ask the operator.
- BINDING — read
Kind + Binds:
script ⇒ call the bound script via scripts/cli/run.sh.agent-chain ⇒ load + run the bound workflow steps in order.hybrid ⇒ call script(s) for deterministic parts, then use the bound agent contract for judgment/writes.
- PRE-GATE — load any pre-gate references the workflow declares.
- EXECUTE — run the steps in order. Invent nothing.
§1 — Triggers
This skill activates on:
mutagent-builder · /mutagent-builder*build · build · implement the spec · build the agent · scaffold the agent
*sync-spec intents (spec sync · sync the spec · code drifted from spec · …) route to
mutagent-agentspec, which delegates the code-read to this package's ai-architect #sync-spec.
§2 — Architecture
flowchart LR
spec["agentspec.yaml validated by SPEC"] --> sync{"ai-architect #sync-spec drift? (build-internal)"}
sync -->|missing-spec or needs-sync| arch["ai-architect #sync-spec reads impl + drafts reconcile plan"]
arch --> engSync["ai-engineer applies spec update under gate"]
sync -->|in-sync| build["*build"]
engSync --> build
build --> eng["ai-engineer implements + TDD + coverage"]
eng --> reviewer["ai-architect independently reviews + coverage"]
reviewer -->|PROCEED| eval["handoff bundle to EVALUATE"]
reviewer -->|STEER| eng
reviewer -->|ABORT| parent["parent escalation"]
§3 — Bill of materials
| Surface | Path |
|---|
| Authoritative BUILD protocol | references/workflows/build-protocol.md |
| OPTIMIZE handoff contract | references/workflows/optimize-handoff.md |
| BUILD Actor | assets/agents/ai-engineer.md |
| BUILD Verifier / sync-spec analyst | assets/agents/ai-architect.md |
| Spec-sync freshness probe | scripts/sync-spec/check-sync-spec.ts |
| Build input preflight | scripts/handoff/validate-build-input.ts |
| Spec implementation coverage gate | scripts/verify/spec-impl-coverage.ts |
| Build report template | assets/templates/build-report.md.tpl |
§4 — Boundary
- SPEC emits and validates
agentspec.yaml; it does not own executable BUILD.
- BUILD owns implementation, drift resync, TDD, and
spec-impl-coverage.
- EVALUATE judges and may emit EDD change requests.
- DIAGNOSE performs RCA; agentspec-backed implementation remedies return to BUILD.
- BUILD ownership stays in this package and is routed as ADL BUILD.
