analyze-spec

This skill operates in two modes:

• Local mode (invoked via /analyze-spec in Claude Code): Full interactive Socratic interview — one question at a time, iterative refinement with the spec author.
• Remote mode (triggered externally via the claude-spec-review-request label): Single-pass analysis — all questions posted at once as a single PR comment. Reads prior PR comments as context to account for already-answered questions.

Adapted from the Ouroboros-inspired deep interview methodology — specification quality is the primary bottleneck in AI-assisted development.

<Execution_Policy>

• Gather codebase facts via explore agent BEFORE asking about them
• Cite repo evidence (file path, symbol, or pattern) instead of asking the spec author to rediscover it
• Score ambiguity transparently
• Do not approve until ambiguity ≤ threshold (default 0.2)
• Allow early approval with a clear warning if ambiguity is still high </Execution_Policy>

<Mode_Detection>