# The First 30 Minutes

**What to do right now, before the memory of watching it work fades.**
*Part of the MxP Studio spec-driven development kit*

---

## Why this matters

You just saw a spec turn into working software. You watched something click. You're maybe 15 minutes from getting distracted and losing the thread.

This doc is the activation path. 30 minutes from now, you'll have:

- A working account on one AI coding tool
- One real idea captured in PR-FAQ form
- A first requirements document in EARS notation
- A concrete next step for Monday morning

No fluff. No video to watch. Just do.

---

## Minute 0–5 — Pick your tool

You don't need all three. Pick one based on where you are:

| If you're… | Use |
|---|---|
| Completely new to AI coding | **Lovable** — easiest, browser-based, no install |
| A product person who wants specs without code | **Claude** (claude.ai) — great for spec generation, no IDE setup |
| A developer or tech-curious builder | **Kiro** — AWS's spec-driven IDE, most structure |
| Already in Cursor or VS Code | **Claude Code** — terminal-based, plugs into your flow |

**Install links:**

- **Lovable** → [lovable.dev](https://lovable.dev/invite/C3MOHS7) (sign up, no install)
- **Claude** → [claude.ai](https://claude.ai) (sign up, no install)
- **Kiro** → [kiro.dev](https://kiro.dev) (download the IDE)
- **Claude Code** → `npm install -g @anthropic-ai/claude-code` then run `claude` in any terminal

**Don't spend more than 5 minutes here.** Sign up. Open it. Move on.

---

## Minute 5–15 — Write your PR-FAQ

Don't try to pick the perfect idea. Pick an idea you've had for more than a week that you haven't built yet. Friction you live with is the best source material.

### The minimum viable PR-FAQ (for right now — you can fancy it up later)

Copy this into a blank doc or into your AI tool directly. Fill in the brackets. 10 minutes max.

```
TITLE
[One sentence: what does this thing do?]

WHO IT'S FOR
[One specific person with a specific role or life context.
Not "everyone." Not "people who X." A person.]

THE DURABLE PROBLEM
[One paragraph, ~3 sentences. What pain does this person
feel right now, every week? What do they currently do to cope?
Why is the coping inadequate?]

THE PROMISE
[One paragraph, ~3 sentences. When this thing works, what
can they do that they couldn't before? Be concrete. Avoid
"transforms", "revolutionizes", "game-changer".]

THE CUSTOMER QUOTE
["Quote from a realistic version of this person, describing
the specific outcome they get. Use a normal name. No
superlatives."] — [Name], [Role]

THE 5 HARDEST QUESTIONS I NEED TO ANSWER
1. [The thing I'm most uncertain about]
2. [The thing I'd have to cut if forced to ship in a weekend]
3. [The thing a skeptical friend would ask first]
4. [The thing that would make this fail if I got it wrong]
5. [The thing I'm avoiding thinking about]
```

### Tip: write the customer quote FIRST.

If you can't imagine a real person saying a specific, believable thing — you don't have a product yet. You have a vague aspiration.

**Good quote:** *"I used to spend every Sunday copy-pasting my week's calendar events into my journal. Now it takes 30 seconds."*

**Bad quote:** *"This app has completely transformed how I think about productivity."*

Real people don't talk like the bad quote. Use the good kind.

---

## Minute 15–25 — Generate your first spec

Open your tool. Paste in your PR-FAQ. Add this prompt:

```
Based on this PR-FAQ, generate a requirements document in EARS format.

Include:
- 3-5 user stories for the minimum viable version
- For each user story, at least one event-driven requirement
  (WHEN X, THE SYSTEM SHALL Y)
- For each user story, at least one unwanted-behavior requirement
  (IF X, THEN THE SYSTEM SHALL Y)
- Any ubiquitous requirements (always-true invariants) that matter

Keep the scope to what I could reasonably ship in 4 hours of
build time. If a story is too ambitious for that window, flag
it and suggest a smaller version.

Don't write code yet. Just the spec.
```

**Read the output critically.**

The tool will hand you a structured requirements doc. Your job now isn't to celebrate — it's to review. Ask yourself:

- Did it capture the customer right?
- Did it sneak in features I didn't ask for?
- Are the unwanted-behavior cases realistic, or boilerplate?
- Is the scope honest for a 4-hour build?

If any answer is "no," push back in the chat. Regenerate. This is the moment where spec-driven development becomes real — you're not writing prompts, you're editing a document.

---

## Minute 25–30 — Commit to one action

Pick ONE:

### Option A — Build it this weekend

- Block 4 hours on Saturday or Sunday.
- Open the tool. Paste in the PR-FAQ and the spec.
- Add: *"Let's start with user story 1. Generate the minimum code needed to make the first requirement pass."*
- Work through the stories one at a time.
- Ship whatever you have at hour 4 — don't extend.

### Option B — Share the spec with someone

- Send your PR-FAQ + spec to one person whose judgment you trust.
- Ask: *"What's missing? What's wrong? What would you cut?"*
- Iterate once based on their feedback.
- Then either build it (go to Option A) or decide it's not the right idea and archive it.

### Option C — Use it at work on Monday

- Pick a real project you're already on.
- Next time you have a requirements conversation, use EARS notation.
- Next time you write a ticket, write the PR-FAQ first.
- Notice what changes in your team's response. Notice what changes in your own thinking.

---

## The anti-pattern to avoid

**Do not** spend the next 30 minutes:

- Watching more tutorials
- Comparing Kiro vs. Cursor vs. Lovable in detail
- Perfecting your PR-FAQ
- Reading the steering file doc, then the EARS cheat sheet, then the starter prompts — all before building anything

You saw the thing work. You have the templates. The gap between "watched it" and "did it" is where most people lose the thread permanently.

Do one thing in the next 30 minutes. The rest of the kit is reference material for when you're already in motion.

---

## When you ship something

Tag [@ajbubb](https://linkedin.com/in/ajbubb) on LinkedIn. I read every one. I'm collecting real examples of what people built their first weekend — good, bad, partial, abandoned. If your thing is in that collection, it means someone else is about to get unstuck because of you.

---

*Built by AJ Bubb / MxP Studio.*