incoherence

Detect and resolve incoherence in documentation, code, specs vs implementation.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

The Incoherence Detector is a specialized Claude skill designed to maintain the integrity of software projects by identifying and resolving discrepancies between documentation, source code, and technical specifications. It automates the tedious process of cross-referencing implementation against requirements, ensuring that project artifacts remain synchronized and reducing technical debt caused by outdated or misleading information.

Use Cases

  • Documentation Alignment: Automatically identifying and updating README files or API docs that have fallen out of sync with recent code changes.
  • Specification Verification: Ensuring that the final implementation strictly adheres to the initial technical design documents and business requirements.
  • Refactoring Audit: Detecting stale code comments or logic descriptions that were not updated during major codebase refactors.
  • Compliance and QA: Performing deep-dive audits to ensure that security protocols or architectural constraints defined in specs are actually present in the implementation.
nameincoherence
descriptionDetect and resolve incoherence in documentation, code, specs vs implementation.

Incoherence Detector

When this skill activates, IMMEDIATELY invoke the script. The script IS the workflow.

Invocation

python3 scripts/incoherence.py \
  --step-number 1 \
  --total-steps 21 \
  --thoughts "<context>"
Argument Required Description
--step-number Yes Current step (1-21)
--total-steps Yes Always 21
--thoughts Yes Accumulated state from all previous steps

Do NOT explore or detect first. Run the script and follow its output.

Workflow Phases

  1. Detection (steps 1-12): Survey codebase, explore dimensions, verify candidates
  2. Resolution (steps 13-15): Present issues via AskUserQuestion, collect user decisions
  3. Application (steps 16-21): Apply resolutions, present final report

Resolution is interactive - user answers structured questions inline. No manual file editing required.