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.