Project Scaffolding
Set up a new project directory with everything needed for Ralph loop development.
The Job
- •Ask for the target directory and project name
- •Run the scaffold script to create the project structure
- •Guide the user on next steps
Usage
Ask the user for:
- •Target directory: Where to create the project (e.g.,
~/Projects/movie-tracker) - •Project name: Human-readable name (e.g., "Movie Tracker")
Then run:
bash
./scripts/scaffold.sh <target-directory> "<project-name>"
What Gets Created
code
target-project/ ├── CLAUDE.md # Operational guide (build/test/lint commands) ├── IMPLEMENTATION_PLAN.md # Living task list (populated by plan mode) ├── progress.txt # Append-only learning log ├── specs/ # Requirement specs (one per JTBD) ├── ralph/ # Loop files │ ├── ralph.sh # The loop script │ ├── PROMPT_plan.md # Planning prompt │ ├── PROMPT_build.md # Building prompt │ ├── PROMPT_plan_work.md # Scoped planning prompt │ ├── PROMPT_discover.md # Feature discovery prompt │ └── PROMPT_interview.md # Interview prompt ├── archive/ # Previous Ralph runs └── src/ # Application source code
Next Steps After Scaffolding
Guide the user through:
- •
cd <target-directory> - •Edit
CLAUDE.mdto add project-specific build/test/lint commands - •Run
./ralph/ralph.sh interviewto define the project - •Run
./ralph/ralph.sh discoverto generate feature specs - •Run
./ralph/ralph.sh planto create implementation plan - •Run
./ralph/ralph.sh buildto start building