Coding Flow

<coding_flow>

<description_and_purpose>

Problem: Unstructured coding leads to scope drift, missing validation, autonomous runaway, and misaligned deliverables. Solution: Sequential workflow with reviewer gates, HITL gates, subagent delegation, and skill-driven execution scaled per Request size classification. Validation: Each phase produces verifiable outputs; reviewer catches issues before user; HITL gates prevent autonomous runaway; final validation confirms implementation matches approved intent.

</description_and_purpose>

<workflow_phases>

1. All Rosetta prep steps MUST be FULLY completed
2. MUST USE SKILL load-project-context (required: all), orchestration (all except trivial), hitl (all, unless No HITL or Fully Autonomous)
3. MUST ALWAYS use todo tasks ledger, ASAP. Phases are sequential. Independent tasks can run in parallel.
4. No rush, take your time, MUST FOLLOW WORKFLOW ENTIRELY, no skipping, if in doubt - select the safest / longest path, no deviation from the workflow is allowed
5. When debugging is needed, INVOKE SUBAGENT engineer with debugging skill to save LLM context
6. INVOKE SUBAGENT executor for building, running tests, installing packages, and similar mechanical actions.
7. MUST just-in-time load each phase's skills
8. If workflow is for REQUIREMENTS, MUST USE SKILL requirements-use and LOAD all affected requirements. Use refs to requirements for subagents.
9. If /goal is set repeat phases 7-12 postponing user_review_impl and final_validation until goal is met.
10. If migrate/modernize: implementation phase MUST use tiny batches ONLY (1-3 files), never bulk-read (other phases may); specs/plan enforce; FS-copy RECOMMENDED; no behavior change/new code; mirror source; subagents same; REQUIRED TO log started/completed; Use impl subagents like MAP-REDUCE;
11. Run architect subagent with required model in the background and consult with it if already supported or prefer advisor if already available
12. Coding workflow state MUST be saved to agents/TEMP/<FEATURE>/coding-flow-state.md file.
13. If context already contains request for TDD => implement properly red and green adjusting this workflow, including by moving execution of phases tests and review_tests to be after user_review_plan and before implementation.

1. Gather project context, affected areas, dependencies, constraints, requirements. SMALL: orchestrator handles inline.
2. Input: user request + CONTEXT.md + ARCHITECTURE.md + IMPLEMENTATION.md. Output: discovery-notes.md in FEATURE PLAN folder.
3. Required skills: load-project-context
4. Recommended skills: codemap (structural project discovery)
5. If REQUIREMENTS in use: requirements-use skill is required.
6. Additionally request to discover existing libraries, packages, search web for similar problems/tasks (if this make sense)
7. Update coding-flow-state.md
8. Do not stop until 100% clear