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.