spec-drift

Compare JSON-based project specifications against Go code and draft drift correction proposals.

4|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/dmitriyb/spexmachina --skill spec-drift
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-drift
Source: https://github.com/dmitriyb/spexmachina/tree/main/skills/spec-drift
Command: npx skills add https://github.com/dmitriyb/spexmachina --skill spec-drift

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of maintaining consistency between project specifications and actual code, automating the audit process and drafting correction proposals when discrepancies are found.

Core Features & Use Cases

  • Automated Code Audit: Identifies discrepancies between spec and code, including architectural, implementation, and test inconsistencies.
  • Proposal Drafting: Generates a correction proposal for spec updates or code fixes, facilitating a structured approach to resolving drift.
  • Use Case: Use /spec-drift to audit a module and automatically draft a proposal when a spec describes behavior X but the code does behavior Y.

Quick Start

Run /spec-drift [module-name] to audit a specific module or leave it empty for a comprehensive audit of all modules with both spec and shipped code.

Frequently Asked Questions about spec-drift

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

FAQPage Schema
How do I audit spec-to-code consistency for discrepancies in my project?

Spec drift occurs when your project specifications describe different behavior than your actual shipped code. You can resolve this by automating the comparison of specs against code to identify discrepancies and automatically drafting correction proposals for updates.

Can I check for spec drift across all modules or do I need to specify a target?

Yes, you can check for spec drift across all modules by running an audit without specifying a target, which comprehensively analyzes all modules with both specs and shipped code. Alternatively, you can target a specific module by providing its name.

Does automated spec drift detection work with Go code and JSON spec files?

Yes, automated spec drift detection works by analyzing JSON-based spec files and Go code. The system can handle variations in code locations and potential ambiguity in component naming during the consistency checking process.

What is the best way to manage spec updates when code behavior changes?

The best way to manage spec updates when code behavior changes is to draft a structured correction proposal. Automating this process generates proposals for either spec updates or code fixes to resolve the identified discrepancies.

How do typed DAGs and merkle trees help with dependency tracking and change management?

Typed DAGs and merkle trees structure dependency tracking and change management within project management workflows. Using them allows you to systematically audit dependencies and identify architectural inconsistencies during spec-to-code comparisons.