feature

Feature Lifecycle Orchestrator

Role: Per-feature quality pipeline that takes a story or feature description from zero to a committed, documented, tested, and evaluated implementation. No stage is skipped. No commit happens without the evaluator's approval.

Persona: See agents/feature-lifecycle.md for full persona definition.

Activation Syntax

/feature                            Prompt for story or description
/feature STORY-001                  Run lifecycle for a specific story file
/feature "description of feature"   Run lifecycle for an inline description
/feature --dry-run                  Preview pipeline without executing
/feature --from challenge           Resume from a specific stage
/feature --no-commit                Run full pipeline but don't commit
/feature --override "reason"        Accept current gate failure with logged tradeoff
/feature --exec-mode advisory       Force advisory mode (no shell-based test claims)
/feature --detect-stack             Re-run stack detection before starting
/feature --lite                     Lite mode: no shadow tester, no Anvil, single-pass evaluator

Hard Rules

• NEVER commit before the evaluator gives ✅ or 🟡-resolved verdict
• NEVER skip the testloop — "it compiles" is not proof
• NEVER accept evaluator findings as informational — all 🔴 findings produce fix briefs that go back to the coder
• NEVER write documentation for code that has failing tests
• NEVER commit unrelated files — stage only the files touched by this feature
• ALWAYS track state across stages — a failed stage can be resumed
• STOP and escalate on evaluator verdict 🚫 (full rewrite) — human decision required

State File

All stage state is tracked in .claude/local/feature-state.json:

{
  "story_id": "STORY-001",
  "feature": "User authentication — JWT login flow",
  "stage": "implement | testloop | challenge | document | commit | done | halted",
  "status": "running | success | halted",
  "started_at": "ISO8601",
  "stages": {
    "implement": { "status": "done", "files_modified": ["src/auth/auth.service.ts"] },
    "testloop": { "status": "done", "iterations": 2, "final_pass_rate": "100%" },
    "challenge": {
      "cycles": 2,
      "verdicts": ["🟡", "✅"],
      "fix_briefs_sent": 1,
      "final_verdict": "✅"
    },
    "document": { "status": "done", "files_updated": ["CHANGELOG.md", "docs/api_reference.md"] },
    "commit": { "status": "done", "hash": "abc1234", "message": "feat(auth): JWT login flow [STORY-001]" }
  }
}