Ralph Pipeline — Documentation Index

Areas (ongoing responsibilities)

Doc	Contents
Pipeline Architecture & Operations	Architecture, pipeline steps, CDN components, test harness, API routes, DB schema, key files, env vars, code style, failure taxonomy, build artifacts
Build Management	Kill criteria, when to let a build continue, lifecycle commands, git sync procedure, monitoring loop
Education Slot	Session Planner vision, trig session, interaction patterns

Resources (reference material)

Doc	Contents
Lessons Learned	Accumulated pipeline build lessons + proof log. Read before diagnosing failures.
Failure Patterns Tracker	Ranked active failure patterns by frequency — primary input for R&D slot selection
Per-Spec RCAs	Per-game failure history — stubs redirect to warehouse/templates/<game>/rca.md for games with warehouse entries. Non-warehouse games have full RCA here.
Per-Game Artifacts	Primary home for per-game docs: rca.md, ui-ux.md, spec.md, game/index.html, review-findings.md
Spec Creation Workflow	MCP-based spec creation using Claude Desktop + Ralph MCP tools
Testing Architecture	Test harness design, CORE tests (deterministic), supplementary LLM tests, game taxonomy
Deployment Runbook	First-deploy setup, systemd services, Nginx, troubleshooting

Archive (completed analyses — preserved for reference)

R&D analyses (archive/rnd/)

Completed R&D investigations. Not active reference — consult lessons-learned.md instead.

File	Topic
first-attempt-rate.md	First-attempt pass rate analysis
smoke-regen-measurement.md	Smoke-regen effectiveness measurement
prompt-gap-analysis.md	Generation prompt gap analysis
fix-prompt-audit.md	Fix loop prompt audit
linter-effectiveness.md	T1 linter effectiveness study
test-failure-analysis-global.md	Global test failure analysis
test-failure-analysis-per-spec.md	Per-spec test failure analysis
never-approved-analysis.md	Analysis of games that never got approved
consistent-failures-rca.md	Root cause analysis of consistent failures
educational-interactions.md	Educational interaction types and pedagogy analysis
(others)	See archive/rnd/ for full list

Historical docs (archive/historical/)

Superseded or completed one-time analyses.

File	Notes
failure-analysis.md	Comprehensive build failure analysis (builds 1–285). Findings incorporated into lessons-learned.md.
pipeline-learnings.md	CDN compatibility fix log (13 fixes). Findings in lessons-learned.md.
behavioral-transcript.md	Design doc for Step 2.5b behavioral transcript feature
session-bootstrap.md	Superseded by CLAUDE.md Rule 12 (session continuity)
local-testing.md	Superseded by CLAUDE.md Rule 13 (local test slot) + diagnostic.js
scale-config.md	Scale configuration guide (resource gates, Prometheus metrics)
distributed.md	Distributed multi-worker architecture options