reconcile

Detect and remediate drift between specification documents and system implementation.

3|Updated Feb 17, 2026

Search Tags:#documentation #drift detection #implementation #code maintenance #sync #reconciliation

Ready to run

npx skills add https://github.com/martineserios/thebrana --skill reconcile-martineserios

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: reconcile
Source: https://github.com/martineserios/thebrana/tree/main/system/skills/reconcile
Command: npx skills add https://github.com/martineserios/thebrana --skill reconcile-martineserios

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that your system's implementation accurately reflects its documented specifications, preventing drift and maintaining consistency.

Core Features & Use Cases

Drift Detection: Compares specification documents against the actual code and configuration.
Automated Fixes: Applies minor corrections to implementation files based on spec discrepancies.
Use Case: After updating documentation for a new feature, use this Skill to automatically update the corresponding code comments and configuration files to match the new spec, ensuring everything stays in sync.

Quick Start

Run the reconcile skill to compare current documentation against the system implementation and apply any necessary fixes.

Frequently Asked Questions about reconcile

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

FAQPage Schema

How do I detect drift between specification documents and code implementation?▼

To detect specification drift, scan spec surfaces and compare them against system files to identify missing, stale, or incomplete implementations. This process logs findings to documentation and proposes fixes for any discrepancies found.

What is the best way to sync specs with implementation after updating documentation?▼

The best way to sync specs with implementation is by scanning the updated documents against the codebase and applying auto-fixable changes. It operates on a dedicated worktree branch to safely propose fixes and log discrepancies without affecting your main workspace.

Can I automatically apply fixes when code maintenance documentation falls out of sync?▼

Yes, you can automatically apply minor corrections to implementation files when documentation drift is detected. The process identifies discrepancies and applies auto-fixable changes to code comments and configuration files to match the new spec.

Does spec reconciliation require a dedicated git worktree branch to operate?▼

Yes, specification reconciliation operates on a dedicated worktree branch to safely apply auto-fixable changes and log findings. This isolated environment ensures your main system implementation remains stable while discrepancies are reviewed and remediated.

Why does my system implementation have stale or missing components compared to the spec?▼

Your system implementation has stale or missing components because specification drift occurs when documents are updated without corresponding code maintenance. Scanning spec surfaces against system files identifies these gaps and proposes necessary fixes to resync the project.