Incoherence Detector

SkillDocs & knowledge

Lets your agent find and fix mismatches between your documentation, code, and specs.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Incoherence Detector skill

About this skill

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

What this skill tells your AI

The instructions your AI receives, as published by solatis/claude-config in skills/incoherence/SKILL.md and read by ahel’s review.

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

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.

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.

Advanced