build
Installation
SKILL.md
build
Implement an approved plan, never committing. Argument: a plan <path>, or none: the plan approved in this conversation, else the newest in ${TMPDIR:-/tmp}/plans/<repo>/, then in docs/plans/. A step without Verify uses the repo's test command.
- Work where the session is. Only if
git statusshows changes other than the plan file, work in a worktree from HEAD namedbuild/<slug>,<slug>being the plan's file name without its date, with the dependencies installed. - Each step is its Change, within its Files, then its Verify; on failure, fix and rerun. After two failed runs the step is
blocked, and every step that needs itskipped. - With a subagent tool, you never write or read the code: hand all the steps at once to the
subagentrole, as one workflow when the host has a workflow tool, no workflow tool: one subagent. Brief it in a few lines: the tree, the plan path, rules 2 and 4; have it return JSON{step, exit, note}per step. Steps it never answers for areunproven. No subagent tool: write it yourself. - Never: skip, weaken or delete a test, change an expected value to fit, add a suppression comment, widen a type to any, swallow an error, or edit a gate, a CI file or the plan. Touch nothing outside the steps' Files that no
FAILline calls for.
A role comes from .agents/models.json in the repo, else ~/.agents/models.json (the repo wins role by role), under your agent's key (claude, codex…). It is { "model", "effort" } or a model name; pass what it sets to the subagent tool when it takes them. A role left unset runs on the lightest model the subagent tool offers, else on the session's.
Print one line per step, before anything else:
S-001 done 0
S-002 unproven - no answer
S-003 blocked 1 src/a.ts:3 — missing branch
S-004 skipped - needs S-003