skills.rest
martineserios
martineseriosCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/martineserios/thebrana --skill reconcile-martineserios
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
bomdaybomday

policy-monitor

Compare AI practices against policy documents to detect drift.

Community
Advanced
victor-brechbillvictor-brechbill
1

prepare-pr

Rebase a GitHub pull request onto main, apply review fixes, and push.

Official
Advanced
gabriellpequenogabriellpequeno
8

manual-updater

Synchronize agent and skill documentation with repository state using a Python script.

Community
Intermediate
ronniepinnellronniepinnell

drift

Compare specification files against code to detect discrepancies.

Community
Intermediate