Spec Clarifier for Domain Experts

🧠 Specification Builder for Domain Experts

🎯 Vibe Coding Hub: This is your only interaction point with LLMs for this project. Fill out the spec here, then paste it directly into Claude/GPT to generate working code. No back-and-forth, no tangents, no "can you also add..." requests.

🔑 The first 6 questions are the "Critical-Path 6" - enough to generate working code on the first try. Everything beyond that improves quality and future-proofing.

Looking for a more comprehensive approach? Try our traditional specification builder with all questions visible at once.

🔑 Critical-Path 6 (Essential for working code)

These 6 questions provide the minimum viable specification to generate functional code. Fill these out and you can get a working demo.

1. Goal: What are we building and why?

2. Primary User: Who's the main user and what can/can't they do?

3. Core Workflow: Describe the ONE happy-path scenario step-by-step

4. Inputs: What raw signals arrive?

5. Outputs: What must render or speak on success?

6. Stack Constraints: Technical requirements

🛡️ Quality-Layer Questions (Prevents rewrites later)

These questions don't prevent the first run from working, but they prevent scope creep, crashes, and major rewrites down the road.

7. Success Metrics: How do we know it's working well?

8. Edge Cases & Risks: What could go wrong?

9. Tone & Style: How should the app feel?

10. Secondary Personas: Who else might use this?

11. Roadmap Milestones: What comes next?

12. Example Test Case: How can we test this quickly?

13. Data & Storage: How should information persist?

14. App Name (Optional):

📄 Generated Specification

📄 Text Prompt 📝 Markdown 📋 JSON Format

💡 Suggested Use

✅ Use this spec to prompt AI models or agents to build the application described
🔁 Attach this spec or its hash to commits to ensure intent is preserved and traceable
📌 System can use this to auto-generate UIs, backends, or workflow integrations

🧠 Model Suggestions

For MVP Development: Claude Sonnet, GPT-4, Gemini Pro — can handle the Critical-Path 6 effectively
For Production Polish: Use quality-layer specs with more powerful models for robust, maintainable code