Ralph Feature Bootstrap

Goal

Create a new Ralph feature pack from a source document with minimal scaffolding:

• •specs/<slug>.md derived from the source doc
• •IMPLEMENTATION_PLAN.md as an empty stub (planning mode fills it)

Inputs

• •Required: source document path (e.g. docs/260130-react-audit-storage-and-vercel-review.md)
• •Optional: feature slug (e.g. react-audit-storage)
• •Optional: feature title (human‑readable)

If slug/title are not provided, derive them from the source doc path.

Derive feature slug

1. •Start from the source doc basename (no extension).
2. •Remove leading YYMMDD- if present.
3. •Drop common suffixes: -review, -plan, -spec, -notes.
4. •Replace spaces/underscores with hyphens.
5. •Lowercase the result.

Files to create

Target root: scripts/ralph/features/<slug>/

scripts/ralph/features/<slug>/
  IMPLEMENTATION_PLAN.md
  specs/
    <slug>.md

Content rules

specs/<slug>.md

Read the source doc and extract the minimum viable spec:

# <Feature title>

## Source
- `<source doc path>`

## Goals
- <2–4 bullets distilled from the doc>

## Constraints
- React frontend only (`src/`)
- Preserve existing styles and classes
- Don’t overwrite existing comments
- No UX changes beyond what the source doc calls out

## Acceptance criteria
- <3–6 bullets distilled from the doc>

Keep it concise; no extra commentary.

IMPLEMENTATION_PLAN.md

Create an empty file (no template). Planning mode generates the plan.

Execution checklist

1. •Create the directory structure.
2. •Create specs/<slug>.md from the source doc.
3. •Create empty IMPLEMENTATION_PLAN.md.
4. •Do not run the loop unless the user explicitly asks.