ralph-deploylisted
Install: claude install-skill bayeslearner/bayeslearner-skills
# Ralph Deploy
Configure and launch ralph-orchestrator. Install: `cargo install --git https://github.com/mikeyobrien/ralph-orchestrator ralph-cli`
## Directory Discipline
```
.kiro/specs/ # specs (committed)
NN-<name>/
requirements.md # input: the spec AND the ralph prompt (-P)
design.md # output: archived scratchpad after loop
progress.txt # output: timestamped task log
steering/ # optional: product vision, tech decisions
.ralph/ # orchestrator (gitignored runtime state)
ralph.yml # config (core.specs_dir → .kiro/specs)
hats/greenfield.yml # hat definitions with ceremony instructions
agent/scratchpad.md # hat handoff channel (ephemeral)
agent/memories.md # persistent constraints (seed with ceremony rules)
```
**Rules:** No root pollution. requirements.md IS the prompt — no separate prompt.md. design.md is an output, not an input. `.kiro/specs/` is canonical — migrate legacy locations. Number spec dirs sequentially (`01-`, `02-`).
## Before You Start
```bash
ralph loops list # existing loops?
tmux has-session -t ralph-$NAME 2>/dev/null && echo "running"
ls .ralph/loop.lock 2>/dev/null # stale lock?
```
If running: monitor, don't start another. If stale lock with no session: `rm .ralph/loop.lock`.
## Hats = Roles in the Loop