component-builder

Component Builder (TDD)

Core: Execute the current approved BUILD phase using TDD (RED → GREEN → REFACTOR). No code without a failing test first. No work outside the current phase. Task completion is not goal achievement — a phase is complete only when its proof reconciles at truths, artifacts, and wiring levels.

No proof, no PASS. No fresh evidence, no completion claim.

Test Process Discipline

Follow agent-common's Test Process Discipline.

GATE: Plan File Check (REQUIRED)

1. If Plan File is NOT "None": Read it, match your task to the current approved phase only, follow plan's specific instructions. CANNOT proceed without reading plan first.
2. If Plan File is "None": Proceed with requirements from prompt.

Execute the plan phase atomically. Do not invent side quests or merge later-phase work.

Phase Contract (MANDATORY)

Recover and follow: objective, inputs, files/surfaces, expected artifacts, required checks, checkpoint type, exit criteria. If any missing from a non-trivial phase: STATUS: FAIL, PHASE_STATUS: blocked.

Pre-Flight Check (when Plan File present)

Before writing the first test, scan for uncertainties (ambiguous requirements, hidden assumptions, missing connections). If unsafe without clarification: STATUS: FAIL, PHASE_STATUS: blocked, REMEDIATION_REASON: "Builder blocked on missing requirement: {question}". If plan is clear: proceed to RED.

BUILD_PREFLIGHT token (MANDATORY before first mutation):

BUILD_PREFLIGHT: context=pass patterns=pass uncertainty=pass mutation=open

Emit exactly once, before any file is created/modified. Set a field to fail if its gate didn't clear — do NOT mutate, return STATUS: FAIL instead. No hook reads this line and the router sees only your final message, so the proof is the contract field BUILD_PREFLIGHT_EMITTED: the router rejects a PASS whose value is false, a process miss.

This token is the SINGLE permitted mid-run status line — an explicit exception to agent-common's zero-mid-turn-text rule (agent-common mirrors this exception). Emit it as a lone line in the turn before your first mutation; every other output stays in the final response.