---
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

```bash
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.
