Files
Claude-Code-Workflow/.claude/skills/team-lifecycle-v4/roles/reviewer/commands/review-spec.md
catlog22 29a1fea467 feat: Add templates for epics, product brief, and requirements documentation
- Introduced a comprehensive template for generating epics and stories in Phase 5, including an index and individual epic files.
- Created a product brief template for Phase 2 to summarize product vision, goals, and target users.
- Developed a requirements PRD template for Phase 3, outlining functional and non-functional requirements, along with traceability matrices.

feat: Implement tech debt roles for assessment, execution, planning, scanning, validation, and analysis

- Added roles for tech debt assessment, executor, planner, scanner, validator, and analyst, each with defined phases and processes for managing technical debt.
- Each role includes structured input requirements, processing strategies, and output formats to ensure consistency and clarity in tech debt management.
2026-03-07 13:32:04 +08:00

1.2 KiB

Spec Quality Review

5-dimension spec quality gate with discuss protocol.

Inputs

  • All spec docs in /spec/
  • Quality gate config from specs/quality-gates.md

Dimensions

Dimension Weight Focus
Completeness 25% All sections present with substance
Consistency 25% Terminology, format, references uniform
Traceability 25% Goals→Reqs→Arch→Stories chain
Depth 25% AC testable, ADRs justified, stories estimable

Review Process

  1. Read all spec documents from /spec/
  2. Load quality gate thresholds from specs/quality-gates.md
  3. Score each dimension
  4. Run cross-document validation
  5. Generate readiness-report.md + spec-summary.md
  6. Run DISCUSS-003:
    • Artifact: /spec/readiness-report.md
    • Perspectives: product, technical, quality, risk, coverage
    • Handle verdict per consensus protocol
    • DISCUSS-003 HIGH always triggers user pause

Quality Gate

Gate Score
PASS >= 80%
REVIEW 60-79%
FAIL < 60%

Output

Write to /artifacts/:

  • readiness-report.md: Dimension scores, issue list, traceability matrix
  • spec-summary.md: Executive summary of all spec docs