Does this skill automatically change my code?

It can be configured to auto-update minor changes based on your settings, but major or critical changes always require a user decision to ensure safety.

What happens if a spec is ambiguous?

The skill identifies ambiguity and offers a 'Clarify Spec' option, which adds detail to the documentation to match the reasonable assumptions made during coding.

What is spec/code divergence?

Spec/code divergence occurs when the project's documentation (the spec) and the actual source code describe different behaviors, requirements, or implementation details.

Can I use this if I don't have a spec yet?

No, this skill is designed for reconciling existing specs. You should use the sdd:spec skill to create a specification first.

How does it help with my Git history?

It generates detailed, standardized commit messages that explain why a spec was updated or why code was modified to match the intended design.

Spec Evolution & Reconciliation

Name: Spec Evolution & Reconciliation
Author: rhuss

byrhuss

•

Learning & Documentation

Synchronizes specifications and source code by analyzing mismatches and providing AI-guided resolutions.

About

Spec Evolution & Reconciliation is a specialized tool for Specification-Driven Development (SDD) that ensures project documentation and implementation remain perfectly aligned. As codebases grow, specifications often diverge from the actual code; this skill identifies these deviations, analyzes their impact, and recommends whether to update the spec, fix the code, or clarify ambiguities. It offers a structured workflow for maintaining a 'single source of truth' while providing developers with granular control over automated updates versus manual intervention.

Key Features

1 GitHub stars
Impact and severity analysis for architectural and behavioral mismatches
Configurable auto-update thresholds for minor or trivial documentation changes
Automated detection of spec/code divergences across the codebase
Automated git commit generation with detailed reasoning for reconciliations
Guided resolution workflows to update specs, fix code, or clarify intent

Use Cases

Aligning outdated project documentation with a refined implementation during code reviews
Identifying and fixing missing requirements in code during final verification cycles
Rapidly updating API specifications when implementation reveals a more efficient design pattern

About

Key Features

1 GitHub stars
Impact and severity analysis for architectural and behavioral mismatches
Configurable auto-update thresholds for minor or trivial documentation changes
Automated detection of spec/code divergences across the codebase
Automated git commit generation with detailed reasoning for reconciliations
Guided resolution workflows to update specs, fix code, or clarify intent

Use Cases

Aligning outdated project documentation with a refined implementation during code reviews
Identifying and fixing missing requirements in code during final verification cycles
Rapidly updating API specifications when implementation reveals a more efficient design pattern