Stats
Actions
Tags
From stackshift
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.
How this skill is triggered — by the user, by Claude, or both
Slash command
/stackshift:complete-specThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Step 5 of 6** in the Reverse Engineering to Spec-Driven Development process.
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.
npx claudepluginhub johan--/stackshift --plugin stackshiftProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.