vercel-react-best-practices

1. Interviews you about what you're building (BMAD method)
2. Creates a PRD with user stories
3. Designs the architecture
4. Analyzes edge cases you might miss
5. Validates story quality for autonomous execution
6. Builds it automatically using the Ralph loop
7. Notifies you on your phone when done

• Fully guided - Just say "Run the workflow" and answer questions
• Phone access - Start on laptop, continue from phone via GitHub Codespaces
• Notifications - Get notified when builds complete or need attention
• Autonomous execution - Runs up to 100 iterations without intervention

1. Clone and Setup

```bash

git clone https://github.com/rohunj/claude-build-workflow.git

cd claude-build-workflow

./one-time-setup.sh # Sets up GitHub template

./setup-notifications.sh # Sets up phone notifications

```

Install the ntfy app on your phone and subscribe to your topic.

2. Build Something

```bash

cd /path/to/claude-build-workflow && claude

```

Then say:

```

Run the workflow

```

Answer the questions. When ready, say "Start now" and close your laptop.

The workflow combines:

• [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD) - Discovery and planning methodology
• [Ralph](https://github.com/snarktank/ralph) - Autonomous execution loop (adapted for Claude Code)
• [Amp Skills](https://github.com/snarktank/amp-skills) - Utility skills (adapted for Claude Code)

The Flow

```

You: "I want to build a habit tracker"

↓

Claude interviews you (5-10 min)

↓

PRD + Architecture created

↓

Edge cases analyzed

↓

Stories validated

↓

Autonomous build starts

↓

[You close laptop, go about your day]

↓

Phone notification: "Build complete!"

```

• [Claude Code CLI](https://github.com/anthropics/claude-code) installed
• GitHub account
• jq for JSON parsing (brew install jq on macOS)

| File | Purpose |

|------|---------|

| CLAUDE.md | Main workflow instructions (Claude reads this) |

| ralph.sh | Autonomous build loop |

| skills/ | PRD generation, edge cases, story quality, etc. |

| one-time-setup.sh | Sets up GitHub template repo |

| setup-notifications.sh | Sets up phone notifications |

MIT

Built on top of:

• [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD) by bmad-code-org
• [Ralph](https://github.com/snarktank/ralph) by snarktank
• [Amp Skills](https://github.com/snarktank/amp-skills) by snarktank