Idea & concept brief
Turn a half-formed idea into a tight, LLM-friendly brief. This is a chat with a capable LLM. No code yet.
Purpose: force the high-impact decisions (who it is for, the ONE job, the CTA) before any building.
Run: ai_rules/prompts/1_idea_clarification_prompt.md
Output: ai_rules/app_approach/concept-brief.md
Feeds: Step 2 — the brief is the only input to the PRD generator.
Why it exists
An LLM will happily build whatever you describe, including the wrong thing. This step is the cheapest place to be wrong. The prompt asks at most five questions and refuses a feature list where it needs a single answer: the ONE job the site must do better than any alternative. Decide that here and every later step inherits it.
How to run it
Open the prompt
Copy the whole file into Claude or ChatGPT.
ai_rules/prompts/1_idea_clarification_prompt.mdAnswer the questions
Paste your one-paragraph idea. The prompt asks 3–5 questions: who it is for, the ONE job, the primary conversion plus single CTA, the acquisition channel (SEO / paid / referral), and 1–3 reference sites with what to borrow from each.
Save the brief
It returns a single Markdown file. Save it as the output below.
ai_rules/app_approach/concept-brief.mdWhat the brief contains
# Concept Brief: <Site Name>
## 1. One-Liner
## 2. Target Users
## 3. The ONE Job # no "TBD" allowed; force the decision here
## 4. Conversion & Primary CTA
## 5. Acquisition Goal
## 6. References
## 7. Scope (Now / Later)
## 8. Constraints & Open QuestionsBest practices baked in
- Five questions, not twenty. Only the ones that change the shape of the site.
- The ONE job is a single sentence. A list is a refusal to decide.
- One primary CTA, repeated site-wide. Secondary CTAs stay subordinate.
- No invented metrics, competitors, or references. Unknown is written
TBD, never guessed. - Terse, second-person, benefit-first. No hype.