formatting-audits
Design document review format definition with 100-point scoring system. Provides quality evaluation criteria, scoring items, and pass/fail logic for SOW/Spec documents. Combined with confidence markers (✓/→/?) to clarify evaluation evidence. Triggers: SOW review, Spec review, document review, design review, ドキュメントレビュー, 設計レビュー, 90 points, scoring, grading, 品質評価, スコアリング, 合否判定.
When & Why to Use This Skill
This Claude skill automates the rigorous auditing of Statement of Work (SOW) and Technical Specification documents using a standardized 100-point scoring system. It evaluates document quality across four critical dimensions—Accuracy, Completeness, Relevance, and Actionability—providing objective pass/fail judgments to ensure project requirements are clear, testable, and free of technical debt.
Use Cases
- SOW Quality Assurance: Evaluate Statement of Work documents before project kickoff to ensure all acceptance criteria are testable and project goals align with proposed solutions.
- Technical Spec Auditing: Review software design specifications to identify missing sections, vague requirements, or YAGNI (You Ain't Gonna Need It) violations using evidence-based confidence markers.
- Standardized Peer Reviews: Implement a consistent 100-point grading scale across engineering teams to provide objective feedback and clear 'Pass/Fail' thresholds for design document approvals.
| name | formatting-audits |
|---|---|
| description | > |
| allowed-tools | [Read, Grep, Glob] |
| agent | sow-spec-reviewer |
| context | fork |
| user-invocable | false |
SOW/Spec Scoring (100-point)
Scoring
| Category | Score | Focus |
|---|---|---|
| Accuracy | 0-25 | ✓/→/? markers, evidence |
| Completeness | 0-25 | All sections, testable AC |
| Relevance | 0-25 | Goals ↔ solutions, no YAGNI |
| Actionability | 0-25 | Specific steps, feasibility |
Deductions
| Issue | Points |
|---|---|
| No confidence marker | -5 |
| Missing required section | -10 |
| AC without test scenario | -5 |
| Vague action item | -5 |
| YAGNI violation | -5 |
| Inconsistent AC-FR map | -10 |
Thresholds
| Score | Judgment | Action |
|---|---|---|
| 90-100 | PASS | Proceed to next phase |
| 70-89 | CONDITIONAL | Re-review after fixes |
| 0-69 | FAIL | Major revision needed |