incoherence
Detect and resolve incoherence in documentation, code, specs vs implementation.
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.
| name | incoherence |
|---|---|
| description | Detect 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
- Detection (steps 1-12): Survey codebase, explore dimensions, verify candidates
- Resolution (steps 13-15): Present issues via AskUserQuestion, collect user decisions
- Application (steps 16-21): Apply resolutions, present final report
Resolution is interactive - user answers structured questions inline. No manual file editing required.