Interactive conversation to resolve [NEEDS CLARIFICATION] markers using /speckit.clarify command. Claude asks questions about missing features, UX/UI details, behavior, and priorities. Updates specs in .specify/memory/ with answers to create complete, unambiguous documentation. This is Step 5 of 6 in the reverse engineering process.
Inherits all available tools
Additional assets for this skill
This skill inherits all available tools. When active, it can use any tool Claude has access to.
Step 5 of 6 in the Reverse Engineering to Spec-Driven Development process.
Estimated Time: 30-60 minutes (interactive)
Prerequisites: Step 4 completed (docs/gap-analysis-report.md exists with clarifications list)
Output: Updated specs in specs/ with all [NEEDS CLARIFICATION] markers resolved
Use this skill when:
[NEEDS CLARIFICATION] markers in specifications/speckit.clarifyTrigger Phrases:
Uses /speckit.clarify and interactive conversation to fill specification gaps:
specs/[NEEDS CLARIFICATION] markersspecs//speckit.tasks and /speckit.implementNote: /speckit.clarify provides structured clarification workflow. This skill can also supplement with custom Q&A for project-specific needs.
From specs/gap-analysis.md and all feature specs:
[NEEDS CLARIFICATION] markersFor each clarification, ask the user:
Example questions:
Listen for:
As user answers questions:
[NEEDS CLARIFICATION] markersReview the prioritized implementation plan:
Ensure all specs are:
Claude:
I found 12 items that need clarification. Let me go through them by priority.
F003 - Analytics Dashboard [P1] This feature is marked as missing. What specific charts and metrics should be displayed?
User:
I want to see:
- Fish count over time (line chart)
- Water parameter trends (multi-line chart)
- Tank health score (gauge)
- Recent alerts (list)
Claude:
Got it! I'll add those requirements to F003.
Should these be real-time updates or daily aggregates?
User:
Daily aggregates for the charts, but real-time for alerts.
Claude:
Perfect. Next question:
F002 - Photo Upload UI [P0] For uploading fish photos, would you prefer drag-and-drop or click-to-browse?
User:
Both options would be ideal.
Claude:
Understood. What's the maximum number of photos per fish?
User:
Let's limit it to 10 photos per fish.
[...continues for all clarifications...]
Before:
## Analytics Dashboard [NEEDS CLARIFICATION]
Status: ❌ MISSING
[NEEDS CLARIFICATION] What charts and metrics to display?
After:
## Analytics Dashboard
Status: ❌ MISSING
Priority: P1
### Overview
Dashboard displaying fish count trends, water parameter history, tank health, and recent alerts.
### Acceptance Criteria
- [ ] Fish count over time line chart (daily aggregates)
- [ ] Water parameter trends multi-line chart (pH, temp, ammonia)
- [ ] Tank health score gauge (0-100)
- [ ] Recent alerts list (real-time updates)
- [ ] Date range selector (7d, 30d, 90d, all)
### UI Requirements
- Responsive design (desktop + mobile)
- Charts use Recharts library
- Real-time updates for alerts via WebSocket
### API Requirements
- GET /api/analytics/fish-count?range=30d
- GET /api/analytics/water-params?range=30d
- GET /api/analytics/health-score
- WebSocket /ws/alerts for real-time alerts
Remove resolved clarifications from the list.
Reflect finalized priorities and details.
After running this skill, you should have:
[NEEDS CLARIFICATION] markers resolvedOnce specifications are complete and unambiguous, proceed to:
Step 6: Implement from Spec - Use the implement skill to systematically build missing features.
DO:
DON'T:
If user is unsure:
For each answer:
Remember: This is Step 5 of 6. After this interactive session, you'll have complete, unambiguous specifications ready for implementation in Step 6.