spec-first:sync

Synchronize traceability matrix statuses and detect orphaned traceability items.

72|9|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/sunrain520/spec-first --skill spec-first-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-first:sync
Source: https://github.com/sunrain520/spec-first/tree/main/skills/spec-first/16-sync
Command: npx skills add https://github.com/sunrain520/spec-first --skill spec-first-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that your project's traceability matrix is up-to-date by synchronizing status information and identifying any orphaned or missing links between requirements, design, and tasks.

Core Features & Use Cases

  • Traceability Matrix Synchronization: Automatically updates the traceability-matrix.md file with the latest status of RFCs and defects.
  • Orphaned Item Detection: Identifies and reports on traceability IDs (like DS or TASK) that lack a corresponding upstream link (like FR).
  • Use Case: After updating the status of several requirements in your system, run this Skill to ensure the traceability-matrix.md reflects these changes and to catch any newly created design documents that haven't been linked back to a requirement.

Quick Start

Run the spec-first sync command to update the traceability matrix.

Frequently Asked Questions about spec-first:sync

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

FAQPage Schema
How do I update a traceability matrix with the latest RFC and defect statuses?

To update a traceability matrix, you synchronize it by loading the latest RFC and defect states to generate a plan, which then updates the traceability-matrix.md file with current statuses.

What is orphan detection in requirements traceability?

Orphan detection in requirements traceability identifies traceability items, like design or task IDs, that lack a corresponding upstream link like a feature requirement, ensuring all artifacts are properly connected.

How do I resolve feature IDs when synchronizing a traceability matrix?

You resolve feature IDs during synchronization through explicit parameters, a current feature file, or interactive selection, allowing the system to accurately map statuses and detect orphans.

Can I log audit trails for traceability matrix status updates?

Yes, you can log audit trails for traceability matrix updates; the synchronization process records these updates and detected orphans directly to a findings.md file for tracking.

When should I run traceability matrix synchronization?

You should run traceability matrix synchronization after updating the status of requirements or creating new design documents to ensure the matrix reflects changes and catches unlinked artifacts.