Skip to main content

/specweave:qa Command

The /specweave:qa command runs comprehensive AI-powered quality assessment with risk scoring using the Probability x Impact method.

What It Does​

Key assessments:

  • 7 quality dimensions with weighted scoring
  • Risk assessment (Probability x Impact)
  • Quality gate decisions (PASS/CONCERNS/FAIL)
  • Actionable recommendations
  • Optional export to tasks.md

Usage​

# Quick assessment
/specweave:qa 0007

# Pre-implementation check
/specweave:qa 0007 --pre

# Quality gate (before closing)
/specweave:qa 0007 --gate

# Export blockers to tasks
/specweave:qa 0007 --export

7 Quality Dimensions​

DimensionWeightWhat It Checks
Clarity18%Clear, unambiguous requirements
Testability22%Acceptance criteria are testable
Completeness18%All sections present
Feasibility13%Technical approach is sound
Maintainability9%Code will be maintainable
Edge Cases9%Boundary conditions covered
Risk Assessment11%Risks identified and mitigated

Risk Scoring​

Uses Probability x Impact method:

Risk LevelScoreAction
CRITICAL>= 9.0Immediate action required
HIGH6.0-8.9Address before release
MEDIUM3.0-5.9Monitor
LOW< 3.0Acceptable

Gate Decisions​

Based on overall score:

ScoreDecisionMeaning
>= 70PASSReady to proceed
50-69CONCERNSShould fix before release
< 50FAILMust fix before proceeding

Output Example​

$ /specweave:qa 0007 --gate

📊 Quality Assessment: 0007-user-authentication

📈 Overall Score: 85/100 (PASS)

Dimension Scores:
  ✅ Clarity: 90/100
  ✅ Testability: 88/100
  ✅ Completeness: 85/100
  ✅ Feasibility: 82/100
  ⚠️  Maintainability: 75/100
  ✅ Edge Cases: 80/100
  ✅ Risk Assessment: 78/100

🔴 Risks Identified:
  - Security: Password storage (Score: 6.5 HIGH)
  - Performance: Token validation (Score: 3.2 MEDIUM)

🎯 Gate Decision: PASS

📝 Recommendations:
  - Consider bcrypt rounds increase (security)
  - Add token caching (performance)