evolve

Detect spec/code divergences and categorize mismatches for guided resolution.

107|15|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/rhuss/cc-superpowers-sdd --skill evolve
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evolve
Source: https://github.com/rhuss/cc-superpowers-sdd/tree/main/skills/evolve
Command: npx skills add https://github.com/rhuss/cc-superpowers-sdd --skill evolve

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the inevitable divergence between specifications and code. It intelligently analyzes mismatches, recommends whether to update the spec or fix the code, and executes the resolution, ensuring your documentation and implementation always reflect the same truth.

Core Features & Use Cases

  • Mismatch Detection: Identifies all differences between the current spec and the implemented code.
  • AI-Guided Resolution: Analyzes each mismatch (e.g., missing in code, extra in code, different behavior) and recommends the best path: update spec, fix code, or clarify spec.
  • User Control & Auto-Updates: Allows you to decide the resolution or automatically update minor spec changes based on configuration.
  • Use Case: During a code review, a new updated_at field is found in the API response that wasn't in the spec. This skill will detect it, recommend updating the spec, and (if configured) automatically make the change.

Quick Start

To reconcile any spec/code mismatches, simply say: Evolve the spec and code to resolve any differences.

Frequently Asked Questions about evolve

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

FAQPage Schema
How do I detect differences between my code and specification?

Spec-code drift detection identifies all mismatches between your current specification and implemented code, categorizing them as missing in code, extra in code, different behavior, or ambiguous. This reveals what diverged and where alignment is needed.

When should I update the spec versus fixing the code?

Mismatch analysis evaluates each divergence and recommends the best resolution path: update spec, fix code, or clarify ambiguous requirements. The recommendation depends on whether the code correctly implements intent or the spec is outdated.

Can I automatically reconcile spec and code changes?

Auto-update thresholds allow minor spec changes to be applied automatically based on configuration, while complex or high-impact mismatches remain user-driven. This balances automation with control during code reviews and verification.

How does spec-code reconciliation fit into code review?

During code review, reconciliation detects undocumented API fields, missing implementation details, or behavior changes. It generates recommended resolutions and updates documentation and changelogs automatically when configured.

What happens after mismatches are resolved?

Resolution execution updates specs, fixes code, or defers decisions with documented reasoning. Changelog and documentation are automatically updated to reflect the reconciliation, keeping truth aligned.

How is ambiguity handled in spec-code mismatches?

Ambiguous mismatches are flagged separately during analysis, prompting clarification of requirements before resolution. This prevents incorrect automatic updates and ensures intentional alignment decisions.