Skip to main content
Book a CallGet the Blueprint
← All episodes

Episode 5

Kick-off by voice

In this episode (≈ 45 min of hands-on work)

  • A PRD for your project, made by voice chat on your phone.
  • A project folder that /new-project set up from that PRD.
  • Your features as tasks, each with a checkable acceptance criterion.

Your step

Paste this into Claude Code in your new project folder after step 10.

Check my PRD and the project set up from it. I am not a developer, so explain everything in plain words.
1. Read PRD.md in this folder. If it is missing, stop and tell me to make one first with the prompt in ~/ailoopwise-blueprint/course/examples/prompt-prd-brainstorm.md in the Claude app.
2. Compare it with ~/ailoopwise-blueprint/course/examples/PRD-TEMPLATE.md and the example ~/ailoopwise-blueprint/course/examples/PRD-EXAMPLE-newsletter-tool.md. List missing sections and every feature without a checkable acceptance criterion.
3. Do not invent answers. Ask me about anything unclear. Add it under "Open questions" in PRD.md only after I say yes.
4. Check what /new-project set up: .claude/CLAUDE.md must hold the "Rules the AI must never break" as hard rules, tasks/todo.md every feature as a numbered task with its acceptance criterion, tasks/current.md a first step. List what does not match. If .claude/CLAUDE.md does not exist yet, tell me step 9 is missing.
5. Change nothing outside this folder. Never run git commit or git push unless I ask, and never print a password, key or token.

Files for this episode

Questions about this episode? Just email us: hello@ailoopwise.com

Step-by-step guide

What this episode is about

Big projects don't start in the editor, they start with the idea. For that you use the normal Claude app on your phone, brainstorm the logic by voice and have it write a structured blueprint at the end: a PRD (product requirements document), meaning what gets built, for whom, and how you'll know it's done. Only then do you move into the dev environment, jump into a new folder and hand Claude Code the blueprint with /new-project. The folder structure is there in seconds.

The wall: writing a good PRD is harder than it sounds. The AI will happily build a bad one.

What you need
Step by step
  1. Once: make /new-project available everywhere (this one skill only; the full global install is Install-guide.md, Part 1; macOS, Linux, WSL): 
    mkdir -p ~/.claude/skills
cp -r ~/ailoopwise-blueprint/blueprint/skills/new-project/ ~/.claude/skills/new-project/
  2. Set the language: in the Claude app under Settings → General → Voice → Language, pick the language you'll speak. The app's display language does not change the voice language.
  3. New chat, paste the prompt: copy the brainstorming prompt from examples/prompt-prd-brainstorm.md as the first message and send it.
  4. Start voice mode: tap the sound-wave icon next to the microphone in the input field and talk. Claude asks, you answer. Say "done" when everything is said. The transcript stays in the chat.
  5. Collect the PRD: leave voice mode and type: 
    Give me the PRD now as one single Markdown code block.
    Copy the block. Read it once: anything you did not say belongs under "Open questions".
  6. Create the folder and save the PRD: 
    mkdir ~/my-project
    Open the folder in VS Code, create PRD.md and paste the block. On the server from episode 3, send yourself the text and create the file there.
  7. Start Claude Code in the new folder (VS Code: open the Claude panel; terminal: cd ~/my-project and claude).
  8. Turn on dictation (optional): in the terminal /voice, then hold the space bar and speak. The VS Code extension can do this too. It doesn't work over SSH; there you use your phone keyboard's dictation.
  9. Hand over the blueprint, spoken or typed: 
    /new-project Read PRD.md in this folder. Take the project name, domain, description and tech from it and set up the project in THIS folder. Write the section "Rules the AI must never break" into .claude/CLAUDE.md as hard rules, and the features as numbered tasks with acceptance criteria into tasks/todo.md. Only ask about what the PRD is missing.
  10. Check: .claude/CLAUDE.md holds your rules, tasks/todo.md your features, tasks/current.md the first step.
Example to copy

The blank template: examples/PRD-TEMPLATE.md. A filled example for a small newsletter tool (in German): examples/PRD-EXAMPLE-newsletter-tool.md. The part that later turns into tasks:

| # | Feature | Acceptance criterion |
|---|---------|----------------------|
| 3 | Sending | `npm run send -- newsletter.md --test` only goes to the board address; without `--test` to all confirmed subscribers |
| 4 | Unsubscribe | The link in every mail sets "unsubscribed"; the address gets no further mail |

Every feature has a checkable acceptance criterion. Without one, the AI doesn't know when it's done.

Before the next episode

Speak the PRD for your own project and save it as PRD.md in a new folder.

If something goes wrong

Free by email

New guides by email, plus the complete Blueprint package

With every new video you get the full guide with the ready-to-paste AI brief. Once you confirm your address, the complete Blueprint package is the first thing we send you.

Free. Unsubscribe any time.

Next: Episode 6 →
Episode 5: Kick-off by voice | Claude Code course by AILoopwise