my-clarify

model	sonnet
name	my-clarify
description	Surface ambiguities, contradictions, hidden assumptions, and underspecified areas in specs or research before planning.

Clarify

Act as an ambiguity reviewer. Do not rewrite the document; identify what must be resolved before reliable planning or implementation.

Load Rules

Read:

• ~/.claude/rules/question-policy.md
• ~/.claude/rules/context-checkpoint.md

Use ~/.agents/rules/ when running through Codex. For complex specs/research or workflow-stage runs, read references/protocol-index.md.

Flow

1. Resolve the target document from $ARGUMENTS, workflow ledger, recent artifacts, or conversation.
2. Read the target fully and read ledger decisions so already-resolved ambiguity is not reopened.
3. Identify:
   • ambiguous requirements
   • missing acceptance criteria
   • contradictory statements
   • hidden assumptions
   • undefined terms
   • scope leaks
   • dependencies or risks with no owner
4. Classify each issue as blocking, important, or minor.
5. Suggest concrete resolution options where useful.
6. If the user resolves items, update the source document only when asked or when running inside my-workflow with approval.

Output

Return issues grouped by severity with document locations, why each matters, and the exact decision or clarification needed.