Claude Build Workflow

An automated workflow for building apps, systems, and automations with Claude Code. Just describe what you want to build, answer some questions, and let it build autonomously.

What This Does

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

Features

• 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

Quick Start

1. Clone and Setup

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

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

Then say:

Run the workflow

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

How It Works

The workflow combines:

• BMAD Method - Discovery and planning methodology
• Ralph - Autonomous execution loop (adapted for Claude Code)
• 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!"

Requirements

• Claude Code CLI installed
• GitHub account
• jq for JSON parsing (brew install jq on macOS)

Files

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

License

MIT

Credits

Built on top of:

• BMAD Method by bmad-code-org
• Ralph by snarktank
• Amp Skills by snarktank