Resolves misalignment between user intent and expression through structured, dialogue-driven clarification.
Hermeneia is an epistemic protocol for Claude Code designed to close the intent-expression gap by ensuring Claude understands what you mean, not just what you said. When a user's request is ambiguous, contradictory, or lacks precision, the skill initiates a structured dialogue to extract clarified intent before any execution begins. By prioritizing articulation over assumption, Hermeneia prevents incorrect actions and wasted development cycles by verifying the underlying goals through a multi-phase convergence loop.
Key Features
01Structured gap detection taxonomy covering expression, precision, and coherence
02Hybrid-initiated dialogue for resolving ambiguous prompts
03Automatic AI-detection of ambiguous scope or entity references
04Transformation trace to demonstrate how intent was clarified
0588 GitHub stars
06Multi-phase convergence loop to ensure intent is fully captured
Use Cases
01Refining high-level architectural requests that lack specific detail
02Defining precise boundaries for scope and variable references before coding
03Resolving internal contradictions in complex multi-step instructions
