write-code

Edit source code for the current task.

Procedure

WCD-0. Read the session facts once, before the pre-launch steps that consume them: node "$AGENTS_MAIN_ROOT/bin/workflow/read-session-facts" --session "$SESSION_ID"

• PLANS_DIR= (substitute for every <PLANS_DIR> below) and GATE_CONFIRM_CODE= (the WCD-2 gate: ON/OFF/ERROR).
• If the command exits non-zero, or PLANS_DIR=NONE, stop — do not proceed with any step that uses <PLANS_DIR>; report via /supervisor-report; never construct a path like NONE/<session-id>-.... When a hook blocks a sanctioned command, a fallback path is taken, or any unexpected outcome occurs, report via /supervisor-report (trigger conditions: rules/supervisor-reporting.md). Read rules/ops.md before any destructive or system-state-changing command (including inside WCD-4 self-repair) — on-demand-only, never auto-injected; it owns the recovery-options-first decision path.

WCD-1. Read rules/core-principles.md, rules/coding.md (on-demand-only: not auto-injected, so this Read is the only way it arrives), and the target files identified from the plan.

WCD-2. CONFIRM_CODE gate — enumerate planned edits (one line per file: path + change intent).

• Write every file you plan to edit, one path per line (repo-relative, nothing else on the line), to <PLANS_DIR>/<session-id>-write-code-files.txt with the Write tool.
• Keep that list complete: it is the sole input of the S1b and S4 signals judged in WCD-3.
• Then branch on GATE_CONFIRM_CODE from WCD-0 — OFF: proceed to WCD-3; ON or ERROR: present the planned edits via AskUserQuestion and wait for approval before continuing.

WCD-3. Always follow skills/_shared/jev-two-stage-judge.md with point=complexity-judge stage=write-code (S1b and S4 come only from the WCD-2 list, so no stored evaluation is reused); use its model= and SIGNALS_CSV — never judge the level inline. Emit in Claude text output (NOT Bash echo): > Model selected: **<model alias>** (signals: [comma-separated triggered signal IDs, or "none"]) WCD-3a. Emit echo "<<WORKFLOW_MARK_STEP_write_code_in_progress>>" via Bash immediately before the WCD-4 subagent launch.

WCD-4. Launch subagent (Agent tool, mode: "default", model: <model alias from WCD-3> — the model alias, never the level high / low) with a prompt containing:

• Target files and planned edit summary from WCD-2.
• A-layer language essence block (see below).
• Directive: "Read rules/coding.md (the hub — on-demand-only, so it does not reach you otherwise) and rules/coding/<lang>.md for each language present, before the first Edit."
• Directive: "Read rules/shell-commands.md before the first Bash command, or before writing a file — general-purpose dispatch does not inherit auto-injected rules."
• The canonical line of the rules/shell-commands.md Subagent Dispatch Prompts section, verbatim as a standalone line, with <AGENTS_MAIN_ROOT> replaced by the literal absolute path.
• Directive: "Read rules/user-escalation.md before any system-state-changing command — general-purpose dispatch does not inherit auto-injected rules."
• Directive: "Read rules/ops.md before any destructive or system-state-changing command inside self-repair — general-purpose dispatch does not inherit auto-injected rules; on-demand-only, so it does not reach you otherwise."
• (Optional) Follow agents/lib/nfr-severity-calibration.md to obtain the PROJECT NFR block and use it as an implementation constraint when relevant.
• Lint/typecheck recipe table (see below).
• Self-repair cap: 3 iterations; if still failing after 3, surface tool output verbatim.
• Lint-tool absence policy: when a tool is unavailable, skip that check AND emit <tool> not found — check skipped in the final summary. Never omit this notice.
• Scope-expansion policy: if editing reveals additional files not in the original list need changes, include them in the final summary with a reason. Do NOT prompt mid-edit; do NOT silently expand scope.
• Prohibitions: no diffs shown in the conversation; no mid-edit confirmation prompts. WCD-5. Parse the subagent summary. Surface tool output on failure. Collect all check skipped notes and scope-expansion notes.