Development Workflow
On stale, superseded, or completed state, update {agent_state_dir}/task.md
before acting: classification, reason, task identity, exact next action.
RED -> GREEN -> verification. Build repair owns failures; Review
review-fix/re-review; Document is the sole owner of final_handoff.
Explicit user or repository artifact schemas override workflow-internal shapes; preserve exact paths, keys, types, ids, and supplied literals.
Contract Loading
Read contracts/index.yaml: entry, current_phase, selected_handoff, and
completion. feature_preparation:
repository-grounded existing behavior: inspect requirements, design, current implementation, and behavioral tests before classifications/questions.
architecture_design runs on Pack trigger; pending quality scenarios keep verification_ref absent. Invalid selectors: load_full_authoritative_file; record recovery.
Phase: references/phases.md; routing:
references/workflow-controller.md; progressive_discovery:
references/progressive-discovery.md.
delegation before dispatch for indexed role/trigger fields.
v4 uses subagent_trigger_scope; verification_command is non-empty argv
string[]; persisted Reviewer/QA wrappers bind current
producer_schema_version and rebuild on mismatch.
Execution
- Triage size/risk/gates/state/lane/QA/delegation.
plan_mode:
none skips Plan, inline is concise, and
approval_required waits for approval before Build.
- Preparation-only: typed result, no execution evidence. Build verifies
slices; QA needs trigger; document handoff.
Output
Small work returns status, changed areas, compact acceptance/verification.
1---2name: assistant-workflow-23description: prepare/technical preparation; plan/build; implement/fix; migrate/refactor; resume persisted task state.4---56# Development Workflow78- On stale, superseded, or completed state, update `{agent_state_dir}/task.md`9 before acting: classification, reason, task identity, exact next action.10- RED -> GREEN -> verification. Build repair owns failures; Review11 review-fix/re-review; Document is the sole owner of `final_handoff`.1213- Explicit user or repository artifact schemas override workflow-internal shapes; preserve exact paths, keys, types, ids, and supplied literals.14## Contract Loading1516Read `contracts/index.yaml`: `entry`, `current_phase`, `selected_handoff`, and17`completion`. `feature_preparation`:18repository-grounded existing behavior: inspect requirements, design, current implementation, and behavioral tests before classifications/questions.19`architecture_design` runs on Pack trigger; pending quality scenarios keep verification_ref absent. Invalid selectors: `load_full_authoritative_file`; record recovery.20Phase: `references/phases.md`; routing:21`references/workflow-controller.md`; `progressive_discovery`:22`references/progressive-discovery.md`.2324- `delegation` before dispatch for indexed role/trigger fields.25v4 uses `subagent_trigger_scope`; `verification_command` is non-empty argv26`string[]`; persisted Reviewer/QA wrappers bind current27`producer_schema_version` and rebuild on mismatch.2829## Execution30311. Triage size/risk/gates/state/lane/QA/delegation. `plan_mode`:32 `none` skips Plan, `inline` is concise, and33 `approval_required` waits for approval before Build.342. Preparation-only: typed result, no execution evidence. Build verifies35 slices; QA needs trigger; document handoff.3637## Output3839Small work returns status, changed areas, compact acceptance/verification.
laimis91