Skip to content

the-hw-app/ralph

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,190 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 51.5%
  • HTML 46.4%
  • Shell 1.8%
  • Other 0.3%