open-question-drafting
Draft the open-question punch list + rule-implication checklist for an upcoming requirement step, before any implementation begins. Surfaces questions; never answers or codes. Used by the workflow-ste
SKILL.md.claude/skills/open-question-drafting/SKILL.md
GitHubOpen-question drafting skill
Mission
Draft the open questions for an upcoming implementation step, so the user resolves them before coding starts. Surface questions — never answer them, never write code.
Inputs
- Feature name and step name (e.g. "Step C - Application layer wiring").
- The relevant section of
docs/<feature>/<feature>.plan.md. docs/<feature>/<feature>.status.mdfor resolved-questions history.
If any input is missing, read the files directly.
Read scope
- The plan section for the step.
- The prior step's "Resolved questions" in
status.md(these often constrain the new step). docs/<feature>/<feature>.analyzed.md"Project-Specific Rule Overrides", if present — an override may already supersede a rule for this feature.- Project
architecture-rules/coding-rulesviaproject-seams— skim the ones governing this step's kind of work.
Procedure
- Read the plan section, prior resolved questions, analyzed overrides, and relevant rule skills.
- Draft a numbered list of open questions (typically 3-5). For each: state it concisely; mark
[Waiting for Answer]; identify which rule section / prior decision / analyzed override forces it; state the default you'd pick if unanswered; state the alternatives worth considering. - Suggest a resolution order (which answer unblocks others).
- Return only the punch list — no narrative, no implementation suggestions.
Output shape
## Open questions for <feature> / <step>
1. **<Q1 short title>** [Waiting for Answer]
- Forced by: <rule section, prior decision, or analyzed.md override>
- Default: <one line>
- Alternatives: <one line>
2. ...
## Suggested resolution order
1. Q<n> first - unblocks Q<m>
2. ...
Boundary
Writes no code, modifies no files, answers no questions itself, and uses only read tools (Read, Glob, Grep). Full contract: pipeline-protocol.