# Hoyeon Clarify

> Hoyeon ambiguity-resolution interview for Codex. Use when the user invokes "$hoyeon-clarify", "/clarify", asks to keep asking until clear, remove ambiguity, clarify requirements/design/domain/plan, or says Korean phrases like "모호한 게 없게", "명확해질 때까지", "질문 계속해", or "Q&A로 정리".

- Skill: `team-attention/hoyeon-clarify` (Agent Skill)
- Install (CLI): `npx skillmds@latest add team-attention/hoyeon-clarify`
- Raw SKILL.md: https://api.skillmd.com/api/skills/team-attention/hoyeon-clarify/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: team-attention (https://skillmd.com/u/team-attention)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/team-attention/hoyeon-clarify

---


# hoyeon-clarify

This is the Codex-facing wrapper for Hoyeon's canonical `clarify` skill.

Canonical skill:
- Installed root: `__HOYEON_PLUGIN_ROOT__/skills/clarify/SKILL.md`
- Repo-local fallback: `skills/clarify/SKILL.md` from the current Hoyeon repo

When this skill is invoked:

1. Read the canonical skill file above before executing the workflow.
2. Follow the one-question-at-a-time ambiguity-resolution loop.
3. Write Q&A state under `.hoyeon/clarify/<topic-slug>/`.
4. Use `hoyeon-clarity-auditor` at audit boundaries when native adapters are
   loaded. If unavailable, do a compact direct audit and record the fallback.
5. Use `hoyeon-code-explorer` when code/docs can answer a question better than
   the user can.
6. Do not implement, write final `requirements.md`, mutate `plan.json`, or
   create ADRs unless the user explicitly asks for that handoff.

The output contract remains the canonical Hoyeon contract:
`.hoyeon/clarify/<topic-slug>/qa-log.md` and, when sufficient,
`.hoyeon/clarify/<topic-slug>/clarity-summary.md`.