This report distills the development style used in https://github.com/mikearnaldi/accountability into a reproducible playbook you can apply in your own repositories. It focuses on the workflow, artifacts, automation, and guardrails that make the "Ralph" agent loop practical and consistent.
- Spec-first execution. Work is defined in
specs/documents, each with tasks/phases and status. The agent is expected to read specs, pick a task, implement, and update the spec. - Agent loop orchestration. A root script (
ralph-auto.sh) runs the agent, feeds it a focused prompt, runs CI checks, and commits. The agent does not commit; the script does. - Strict CI gating. The loop requires green
typecheck,lint,build,test(and optionally E2E) before commit. CI mirrors this with separate build and E2E jobs. - Full-stack alignment. `CLAUD