validate

Current workflow state: Auto-detected from ${BASE_DIR}/*/state.yaml

Feature spec exists: Auto-detected (epics//epic-spec.md OR specs//spec.md)

Plan exists: Auto-detected (epics//plan.md OR specs//plan.md)

Tasks exist: Auto-detected (epics//tasks.md OR specs//tasks.md)

Engineering Principles: !test -f docs/project/engineering-principles.md && echo "✅ Found" || echo "❌ Missing (run /init-project)"

Previous validation: Auto-detected from ${BASE_DIR}/*/analysis-report.md

Analyzes:

• Spec ↔ Plan ↔ Tasks consistency
• Constitution compliance (8 engineering principles)
• Breaking changes (API, schema, env vars)
• Test coverage completeness
• Implementation readiness

Outputs:

• analysis-report.md with CRITICAL/MAJOR/MINOR findings
• Recommendation: PROCEED | FIX_CRITICAL | FIX_ALL

Operating constraints:

• STRICTLY READ-ONLY — Never modify spec, plan, or tasks files
• Constitution Authority — Constitution violations auto-CRITICAL
• Token Efficient — Max 50 findings, aggregate overflow
• Deterministic — Consistent finding IDs across runs

Dependencies:

• Git repository initialized
• spec.md, plan.md, tasks.md completed
• Optional: docs/project/engineering-principles.md for principle validation

Step 0: WORKFLOW DETECTION

Detect workflow using centralized skill (see .claude/skills/workflow-detection/SKILL.md):

1. Run detection: bash .spec-flow/scripts/utils/detect-workflow-paths.sh
2. Parse JSON: Extract type, base_dir, slug from output
3. If detection fails (exit code != 0): Use AskUserQuestion fallback
4. Set paths:
   • Feature: SPEC_FILE="${BASE_DIR}/${SLUG}/spec.md"
   • Epic: SPEC_FILE="${BASE_DIR}/${SLUG}/epic-spec.md"
   • Common: PLAN_FILE, TASKS_FILE, REPORT_FILE all in ${BASE_DIR}/${SLUG}/

Fallback prompt (if detection fails):

• Question: "Which workflow are you working on?"
• Options: "Feature" (specs/), "Epic" (epics/)

---