| 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 --total-steps 21 --thoughts ''" />
| 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.