traverspec-reconcile

Compare spec nodes against codebase implementation to identify drift.

3|Updated Jul 18, 2026
One-click install
npx skills add https://github.com/alvazone/traverspec --skill traverspec-reconcile
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: traverspec-reconcile
Source: https://github.com/alvazone/traverspec/tree/main/templates/skills/traverspec-reconcile
Command: npx skills add https://github.com/alvazone/traverspec --skill traverspec-reconcile

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the silent decay of technical documentation by identifying discrepancies between your spec graph and the actual implementation, preventing the common issue of stale documentation.

Core Features & Use Cases

  • Drift Detection: Systematically compares existing spec nodes against code to identify matches, drift, or new undocumented features.
  • Human-in-the-loop Verification: Flags discrepancies for human decision-making rather than making risky, automated assumptions.
  • Use Case: Run this at the start of a session or after a major refactor to ensure your architecture documentation accurately reflects the current state of the codebase.

Quick Start

Use the traverspec-reconcile skill to verify the spec nodes related to the recently modified user authentication feature.

Frequently Asked Questions about traverspec-reconcile

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

FAQPage Schema
How do I detect documentation drift between my architecture spec and the codebase?

To detect documentation drift, you can compare existing spec nodes against your codebase implementation to identify discrepancies, verify architectural integrity, and flag undocumented features for human review.

When should I verify spec-to-code alignment in my development workflow?

You should verify spec-to-code alignment at the start of a session or after a major refactor to ensure your architecture documentation accurately reflects the current state of the codebase.

What is the best way to check for undocumented features after a codebase refactor?

The best way to check for undocumented features is to systematically compare your spec graph against the modified code to identify matches, drift, or new features that lack documentation.

Does this spec-driven verification tool automatically update my documentation when it finds drift?

No, spec-driven verification applies a human-in-the-loop approach, flagging discrepancies for human decision-making rather than making risky automated assumptions or synchronizing documentation automatically.

Can I manually verify architectural integrity without relying on error-prone automated synchronization?

Yes, you can manually verify architectural integrity by comparing spec nodes against the implementation, satisfying requirements for manual verification of spec-to-code mapping without automated synchronization.

What are the limitations of using spec-driven development for drift detection?

The primary limitation is that it requires manual human intervention to resolve flagged discrepancies, meaning it does not automatically correct stale documentation or synchronize the spec graph with code changes.