Detect and resolve incoherence in documentation, code, specs vs implementation.
apm install @solatis/incoherence[](https://apm-p1ls2dz87-atlamors-projects.vercel.app/packages/@solatis/incoherence)---
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
<invoke working-dir=".claude/skills/scripts" cmd="python3 -m skills.incoherence.incoherence --step-number 1 --thoughts '<context>'" />
| Argument | Required | Description |
| --------------- | -------- | ----------------------------------------- |
| `--step-number` | Yes | Current step (starts at 1) |
| `--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.