speckit-reconcile-run

Reconcile feature drift by updating spec.md, plan.md, and tasks.md in place.

60|12|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/ahmedemad3/super-ai-agency-framework --skill speckit-reconcile-run-ahmedemad3
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-reconcile-run
Source: https://github.com/ahmedemad3/super-ai-agency-framework/tree/main/.agent/skills/speckit-reconcile-run
Command: npx skills add https://github.com/ahmedemad3/super-ai-agency-framework --skill speckit-reconcile-run-ahmedemad3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reconcile drift between a feature's implemented behavior and its formal artifacts (spec, plan, and tasks) within a gated, in-place workflow.

Core Features & Use Cases

  • Surgical, in-place updates to spec.md, plan.md, and tasks.md to align artifacts with shipped behavior.
  • Gate-driven validation against constitution constraints to prevent MUST-violation drift.
  • Traceable revision notes and support for generation of integration tests to verify remediation.

Quick Start

Run speckit.reconcile.run with a gap report to update the feature's spec, plan, and tasks in place.

Frequently Asked Questions about speckit-reconcile-run

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

FAQPage Schema
How do I reconcile drift between my feature implementation and its spec?▼

To reconcile drift, run the reconciliation process with a gap report to apply surgical, in-place updates to your spec.md, plan.md, and tasks.md, ensuring your artifacts align with shipped behavior.

What is spec drift reconciliation in a spec-kit project?▼

Spec drift reconciliation is the process of identifying discrepancies between implemented behavior and formal artifacts, then updating the feature's spec, plan, and tasks in place to restore alignment.

How do I update spec.md and plan.md without creating new branches?▼

You can update spec.md and plan.md without branching by applying surgical, in-place edits to the existing files within the .specify/ structure, directly aligning artifacts with shipped behavior.

Does the reconciliation process validate updates against constitution constraints?▼

Yes, drift reconciliation uses gate-driven validation against constitution constraints to prevent MUST-level violations, flagging any conflicts for clarification before finalizing updates.

Can I generate integration tests after reconciling spec drift?▼

Yes, after reconciling spec drift, the workflow supports the generation of integration tests to verify remediation and provides traceable revision notes for the applied updates.

What are the limitations of in-place drift reconciliation?▼

The main limitation is that it requires a spec-kit project with a .specify/ structure, and it will flag rather than resolve MUST-level conflicts, requiring manual clarification for those violations.