asc-add-feature

name	asc-add-feature
description	Structured brownfield workflow. Adapted from QRSPI to prevent context rot and ensure alignment before building.

Add Feature Workflow

Structured brownfield workflow. Adapted from QRSPI to prevent context rot and ensure alignment before building.

Grounded in: RPI (Dex Horthy, HumanLayer 2025) with corrections from QRSPI 8-stage evolution (Coding Agents Conference, March 2026). Plan-reading illusion fix and instruction budget constraint applied. Stages 2/5/7 adapted; stages 1/3/4/6/8 skipped as too heavyweight for individual-developer workflow.

Gate Mechanism

This workflow nudges the agent to stop at each phase boundary, same enforcement tier as the existing decision ladder — not a hard block. Bypasses are logged to the debt ledger.

Known limitation: Bypass-to-debt-ledger logging is self-reported by the agent, not enforced by the hook. The PostToolUse hook has no MCP access — it nudges the agent to log, but cannot write the debt entry itself.

To track phase, write to workflow-gate.json via the state_write MCP tool. Format:

{
  "workflow": "asc-add-feature",
  "phase": "<current_phase>",
  "updatedAt": "<ISO-timestamp>"
}

Phase 1: Research (No Code Changes)

1. Write workflow-gate.json with phase research.
2. Map existing code: patterns, utilities, dependencies already in use.
3. Identify what must NOT be rebuilt (e.g., existing validation helpers).
4. Output a factual research summary.
5. STOP and wait for user approval. Do not plan or implement.

Phase 2: Plan

1. On approval of Phase 1, update workflow-gate.json phase to plan.
2. Create a numbered, step-by-step implementation plan with specific files, functions, and line references.
3. Include a "Don't Build" list from the research phase.
4. Callout: Plan-Reading Illusion. Ask the user to explicitly verify the plan against the codebase, not just skim it.
5. Output the plan.
6. STOP and wait for user approval. Do not implement.

Phase 3: Implement

1. On approval of Phase 2, update workflow-gate.json phase to implement.
2. Recommend a fresh context (intentional compaction) if the context window is getting full.
3. Execute the approved plan.
4. Validate: tests pass, no duplicate code introduced, plan items checked off.
5. On completion, clear the state in workflow-gate.json by overwriting it with {}.