mutagent-builder

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:

1. RESERVED — * marks a command. NOT prose, NOT a file path, NOT an external shortcut.
2. RESOLVE — look up <name> in the table above. Not found ⇒ ERROR + ask the operator.
3. 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.
4. PRE-GATE — load any pre-gate references the workflow declares.
5. 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.