traceability

Analyze cross-references between PRD business rules and feature specifications.

1|1|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/heltondoria/claude-code-sdd-kit --skill traceability-heltondoria
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: traceability
Source: https://github.com/heltondoria/claude-code-sdd-kit/tree/main/global/skills/traceability
Command: npx skills add https://github.com/heltondoria/claude-code-sdd-kit --skill traceability-heltondoria

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies inconsistencies and gaps between your high-level Business Rules/Shared Requirements (BRs/SRs) defined in a Product Requirements Document (PRD) and their actual implementation in feature specifications. It prevents "dangling references," "orphan" requirements, and ensures all specified rules are accounted for.

Core Features & Use Cases

  • Cross-reference Analysis: Compares BRs/SRs from a PRD against references found in feature specification files (.specs/*.md).
  • Issue Detection: Flags dangling references (specs referencing non-existent rules), orphan rules (rules not referenced by any spec), and coverage gaps (rules that should apply to a feature but aren't referenced).
  • Staleness Check: Identifies feature specs modified before the PRD, suggesting potential outdatedness.
  • Use Case: After defining BR1 and SR1 in your PRD, this skill will verify that all feature specs intended to cover BR1 and SR1 actually include references to them, and that no spec accidentally mentions a non-existent BR9.

Quick Start

Analyze the cross-references between the PRD and feature specifications.

Frequently Asked Questions about traceability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check PRD alignment with feature specifications?

To check PRD alignment, you analyze cross-references between Business Rules and Shared Requirements in a PRD and their usage in feature specifications. This detects dangling references, orphan rules, and coverage gaps to ensure all specified rules are accounted for.

What is requirement traceability in product management?

Requirement traceability is the mechanism of tracking Business Rules and Shared Requirements from a PRD to their specific implementation in feature specs. It works by parsing rule IDs and feature IDs to build a traceability matrix, preventing orphan requirements and ensuring full specification coverage.

How do I find dangling references in .specs markdown files?

You find dangling references by parsing PRD section 4 and .specs/*.md files to extract rule IDs and feature IDs. Comparing these IDs builds a traceability matrix that flags any feature spec referencing a non-existent Business Rule or Shared Requirement.

Can I detect orphan business rules in my PRD automatically?

Yes, you can detect orphan business rules by analyzing cross-references between your PRD and feature specification files. The analysis identifies any defined Business Rules or Shared Requirements that are not referenced by any feature spec, highlighting coverage gaps.

How to identify potentially stale feature specs?

You identify potentially stale feature specs by checking modification timestamps. The staleness check flags feature specifications that were modified before the PRD itself, suggesting the spec may be outdated and require review against current requirements.

Does this traceability analysis require specific PRD formatting?

Yes, this traceability analysis requires parsing PRD section 4 for Business Rules and Shared Requirements, alongside .specs/*.md files for feature specifications. Your documents must use consistent rule IDs and feature IDs to successfully build the traceability matrix.