traceability
Manage requirement traceability - generate matrix, check coverage, find orphans, trace requirements
model: sonnet
$ Installieren
git clone https://github.com/majiayu000/claude-skill-registry /tmp/claude-skill-registry && cp -r /tmp/claude-skill-registry/skills/design/traceability ~/.claude/skills/claude-skill-registry// tip: Run this command in your terminal to install the skill
SKILL.md
name: traceability activation_code: TRACEABILITY_V1 phase: any command: /trace aliases: ["/traceability", "/req"] description: Manage requirement traceability - generate matrix, check coverage, find orphans, trace requirements tier: focused model: sonnet invokes: traceability-auditor
Traceability Skill
Usage
/trace - Show traceability dashboard
/trace generate - Scan artifacts and generate traceability matrix
/trace coverage - Report traceability coverage metrics
/trace orphans - Find artifacts without proper traces
/trace REQ-xxx-nnn - Show full trace chain for a requirement
/trace impact REQ-xxx-nnn - Show what would be affected if requirement changes
/trace validate - Verify all trace links are valid
/trace suggest - Auto-suggest traces for orphan artifacts
Commands
/trace (Dashboard)
Shows the current traceability health:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ TRACEABILITY DASHBOARD โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ Matrix Last Updated: 2024-01-15 10:30:00 โ
โ โ
โ ARTIFACTS โ
โ โโโ Requirements: 25 โ
โ โโโ User Stories: 23 โ
โ โโโ Tasks: 18 โ
โ โโโ Specifications: 15 โ
โ โโโ Tests: 50 โ
โ โโโ Implementations: 48 โ
โ โ
โ COVERAGE โ
โ โโโ Forward (Req โ Code): 92% โ โ
โ โโโ Backward (Code โ Req): 73% โ โ
โ โโโ Test Coverage: 84% โ โ
โ โ
โ ORPHANS: 8 artifacts need attention โ
โ โ
โ HEALTH SCORE: 82/100 โ
โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ [G] Generate [C] Coverage [O] Orphans [V] Validate โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
/trace generate
Scans all artifacts and generates the traceability matrix:
- Scans PRD for REQ-IDs
- Scans PRD/docs for User Stories (US-NNN)
- Scans .taskmaster/tasks/tasks.json for tasks
- Scans openspec/changes/*.md for specifications
- Scans tests/**/*.{ts,js,py} for @traces annotations
- Scans src/**/*.{ts,js,py} for @implements annotations
- Generates
.claude/traceability/matrix.json
/trace coverage
Reports detailed coverage metrics with drill-down:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ TRACEABILITY COVERAGE REPORT โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ FORWARD TRACEABILITY โ
โ โโโ REQ โ US: 23/25 (92%) โโโโโโโโโโโโ โ โ
โ โโโ US โ TASK: 18/23 (78%) โโโโโโโโโโโโ โ โ
โ โโโ TASK โ SPEC: 15/18 (83%) โโโโโโโโโโโโ โ โ
โ โโโ SPEC โ CODE: 14/15 (93%) โโโโโโโโโโโโ โ โ
โ โ
โ BACKWARD TRACEABILITY โ
โ โโโ TEST โ REQ: 42/50 (84%) โโโโโโโโโโโโ โ โ
โ โโโ CODE โ REQ: 35/48 (73%) โโโโโโโโโโโโ โ โ
โ โ
โ GAPS: โ
โ โโโ REQ-PERF-003: No user stories โ
โ โโโ REQ-SEC-007: No implementation โ
โ โโโ US-015, US-018, US-021, US-022, US-023: No tasks โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
/trace orphans
Lists all artifacts without proper traces:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ORPHAN ARTIFACTS โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ CRITICAL (Requirements with no path to implementation): โ
โ โโโ REQ-PERF-003: Response time < 100ms โ
โ โโโ REQ-SEC-007: Audit logging โ
โ โ
โ WARNING (Code/tests without requirement link): โ
โ โโโ tests/unit/utils/helpers.test.ts โ
โ โโโ tests/unit/api/legacy.test.ts โ
โ โโโ src/utils/deprecated.ts โ
โ โโโ src/api/v1/compat.ts โ
โ โ
โ MEDIUM (Tasks without requirement): โ
โ โโโ TASK-042: Refactor database connection โ
โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ [S] Suggest traces [M] Mark intentional [I] Ignore โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
/trace REQ-xxx-nnn
Shows the complete trace chain for a single requirement:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ TRACE: REQ-AUTH-001 โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ REQ-AUTH-001: User authentication via email/password โ
โ Priority: P0 | Source: docs/PRD.md:142 โ
โ โ
โ โโโบ US-001: User can log in โ
โ โ โโโบ TASK-003: Implement login API โ
โ โ โ โโโบ SPEC-003-01: Login endpoint spec โ
โ โ โ โ โโโบ src/api/auth/login.ts โ
โ โ โ โโโบ TEST-UNIT-015: tests/unit/auth/login.test.ts โ
โ โ โโโบ TASK-004: Implement password validation โ
โ โ โโโบ SPEC-004-01: Password rules spec โ
โ โ โ โโโบ src/services/auth.ts โ
โ โ โโโบ TEST-UNIT-016: tests/unit/auth/password.test.ts โ
โ โ โ
โ โโโบ US-002: User receives error on invalid credentials โ
โ โโโบ TASK-003: (shared) โ
โ โ
โ Coverage: FULL โ (all paths traced to code and tests) โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
/trace impact REQ-xxx-nnn
Shows impact analysis for requirement changes:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ IMPACT ANALYSIS: REQ-AUTH-001 โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ If this requirement changes: โ
โ โ
โ ARTIFACTS AFFECTED: โ
โ โโโ 2 User Stories โ
โ โโโ 3 Tasks โ
โ โโโ 2 Specifications โ
โ โโโ 3 Code files โ
โ โโโ 4 Test files โ
โ โ
โ ESTIMATED REWORK: โ
โ โโโ Complexity: HIGH โ
โ โโโ Files to modify: 9 โ
โ โโโ Tests to update: 4 โ
โ โ
โ DOWNSTREAM DEPENDENCIES: โ
โ โโโ REQ-SEC-002 (Session management) depends on this โ
โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ [F] Show full artifact list [D] Show dependency graph โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
/trace validate
Validates all trace links exist and are consistent:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ TRACE VALIDATION โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ BROKEN LINKS (referenced artifact doesn't exist): โ
โ โโโ TASK-007 references REQ-DATA-099 (not found) โ
โ โโโ TEST-UNIT-042 references US-099 (not found) โ
โ โ
โ INCONSISTENT LINKS (bidirectional mismatch): โ
โ โโโ US-015 links to TASK-012, but TASK-012 doesn't link back โ
โ โ
โ DUPLICATE IDS: โ
โ โโโ None found โ โ
โ โ
โ VALIDATION: 3 issues found โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
/trace suggest
Auto-suggests traces for orphan artifacts:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ TRACE SUGGESTIONS โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ tests/unit/auth/session.test.ts โ
โ Currently orphan (no @traces annotation) โ
โ โ
โ Suggested traces (by content similarity): โ
โ โโโ REQ-AUTH-002 (85%) - Session management โ
โ โโโ US-004 (78%) - User session handling โ
โ โโโ TASK-008 (72%) - Implement session storage โ
โ โ
โ Recommended annotation: โ
โ /** โ
โ * @traces REQ-AUTH-002, US-004, TASK-008 โ
โ */ โ
โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ [A] Apply suggestion [S] Skip [M] Manual entry โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Integration
With Audit Orchestrator
The traceability-auditor is invoked as part of audit dimension F01 (Requirements Coverage).
With Phase Gates
- Phase 5: Verify all requirements have tasks
- Phase 6: Verify all tasks have specifications
- Phase 8: Verify all tests have traces
- Phase 10: Verify full forward/backward traceability
With Plan Guardian
When Plan Guardian detects drift, it can use traceability to identify which requirements are affected.
Files
| File | Purpose |
|---|---|
.claude/traceability/matrix.json | Generated traceability matrix |
templates/requirement-traceability.schema.yaml | Schema reference |
Repository
majiayu000
Author
majiayu000/claude-skill-registry/skills/design/traceability
0
Stars
0
Forks
Updated1d ago
Added1w ago