This file contains instructions for resolving uncertain assumptions and open questions in a plan through interactive Q&A. It is invoked by `/dr-plan` when the user runs `/dr-plan @plan-file.md answer questions`.
Resolves uncertain assumptions and blocking questions in a plan through interactive Q&A.
/plugin marketplace add dionridley/claude-plugins/plugin install project-management@dion-toolsdr-plan/This file contains instructions for resolving uncertain assumptions and open questions in a plan through interactive Q&A. It is invoked by /dr-plan when the user runs /dr-plan @plan-file.md answer questions.
Context: The plan file content has already been expanded into the conversation via the @ reference. You have access to the full plan content.
The plan content is available in the conversation context (expanded via @ reference).
Extract plan metadata:
@ reference)If you cannot find plan content in the context:
â Plan content not found
Usage: /dr-plan @_claude/plans/[folder]/[number]-[name].md answer questions
Find uncertain assumptions:
- [ ] items in the "Assumptions Made" section[?]Find blocking questions:
[AWAITING] status in "Open Questions & Decisions" sectionFind non-blocking questions:
[OPEN] status in "Open Questions & Decisions" sectionCategorize and count:
If no unresolved items found:
â
No unresolved questions
Plan #[number]: [Plan Name]
Status: [Status]
All assumptions are confirmed and all questions have been resolved.
This plan is ready for implementation.
Next steps:
[If in draft/:] Move to in_progress:
mv _claude/plans/draft/[filename].md _claude/plans/in_progress/
Or ask Claude to move the plan for you.
[If in in_progress/:] Begin implementation following the phases
đ Plan Questions to Resolve
Plan #[number]: [Plan Name]
Status: [Status]
Found [N] items needing resolution:
Uncertain Assumptions ([count]):
1. [assumption text] [?]
2. [assumption text] [?]
Blocking Questions ([count]) â ī¸ Must resolve before implementation:
1. **[Topic]**: [question]
2. **[Topic]**: [question]
Non-Blocking Questions ([count]):
1. **[Topic]**: [question]
Starting interactive resolution...
CRITICAL: Blocking questions must be resolved before implementation can begin.
For each blocking question (in order):
a. Use AskUserQuestion tool:
b. Wait for user response
c. Document the decision:
- [x] **[Topic]** [DECIDED: YYYY-MM-DD]After all blocking questions resolved:
â
All blocking questions resolved ([count]/[count])
Continuing to optional items...
Ask if user wants to resolve uncertain assumptions:
Would you like to verify uncertain assumptions? ([count] remaining)
If user chooses to verify:
[x]Ask if user wants to resolve non-blocking questions:
Would you like to resolve non-blocking questions? ([count] remaining)
If user chooses to resolve:
[DECIDED: YYYY-MM-DD] when resolvedCreate backup first:
.{filename}.backup in same directoryApply all updates:
[ ] to [x])[x] instead of [ ][DECIDED: YYYY-MM-DD] instead of [AWAITING] or [OPEN]> **Decision:** [chosen option]> **Rationale:** [brief explanation]Add to Refinement History:
- [YYYY-MM-DD]: Resolved [N] questions via interactive Q&A
Update Refinements count in metadata
â
Questions resolved successfully
Plan #[number]: [Plan Name]
Location: _claude/plans/[folder]/[filename].md
Resolution Summary:
- Assumptions verified: [X] of [Y]
- Blocking questions resolved: [X] of [Y] â
- Non-blocking questions resolved: [X] of [Y]
[If all blocking resolved:]
â All blocking questions resolved - ready for implementation
[If some items skipped:]
âšī¸ [N] items skipped - can resolve later with:
/dr-plan @_claude/plans/[folder]/[filename].md answer questions
Decisions made:
- **[Topic 1]**: [Brief decision]
- **[Topic 2]**: [Brief decision]
Backup saved: _claude/plans/[folder]/.[filename].backup
Next steps:
[If in draft/ and all blocking resolved:]
1. Move to in_progress:
mv _claude/plans/draft/[filename].md _claude/plans/in_progress/
Or ask Claude to move the plan for you.
[If in in_progress/:]
1. Continue implementation following the phases
[If items remain:]
1. Resolve remaining items later: /dr-plan @plan answer questions
Assumption Markers:
[x] - Confirmed assumption (verified from codebase, PRD, or user)[ ] - Unverified assumption[?] - Uncertain assumption that needs verification (placed after the assumption text)Question Status Labels:
[AWAITING] - Blocking question waiting for user decision[OPEN] - Non-blocking question that can be resolved during implementation[DECIDED: YYYY-MM-DD] - Question resolved with date recordedResolved Question Format:
- [x] **[Topic]** [DECIDED: YYYY-MM-DD]
[Original question text]
> **Decision:** [What was decided]
> **Rationale:** [Why this decision was made]
Example Lifecycle:
# Before resolution:
- [ ] **Auth Method** [AWAITING]
Which authentication method should we use?
- Option A: JWT tokens
- Option B: Session cookies
# After resolution:
- [x] **Auth Method** [DECIDED: 2025-01-15]
Which authentication method should we use?
> **Decision:** JWT tokens
> **Rationale:** Better for API-first design and mobile app support
Analyze the plan content in the conversation context, identify unresolved items, and guide the user through interactive resolution.