Ratchet system guide · v1.2
AvailableRebuild checklist (greenfield concepts)
← Operations · Index · Next: AI prompts
Use this as a product-design checklist for a human or coding agent. It describes what to invent, not how to administer a host. Order matters: mock the loop before real agents and real deploys.
This is a rebuild outline — not a host operations runbook.
Phase A — Foundations (what you need)
- A development environment that can run your chosen model CLIs
- Git and a place to host product remotes
- Clarity on which models will play builder vs tester vs assist
- Three logical product areas: control plane, harness, product shells (place them wherever you like)
- Sources or stubs for: loop orchestration, goal-capture UI, credentials boundary
No package lists, service unit files, or host filesystem maps live here.
Phase B — Configuration (product rules)
- Separate non-secret service config from secret material
- Keep secrets out of this pack and out of chat
- Choose a team git identity the host will accept for harness commits
- Confirm product version signals will be reachable by the deploy gate
- Prefer documenting private install choices offline
Phase C — Credentials boundary (shape)
- Stand up some encrypted store for long-lived credentials (private master material — never in this pack)
- Scope cloud access to product shells, not global agent env
- Give the harness only brokered access — no tokens in builder env
- Confirm identity checks fail closed before any optional infra ensure
- Never log secret values
Phase D — First product (milestones)
- Bind one product shell: repo + live URL + version URL
- Implement an honest public version signal on the product
- Prefer binding a known cloud project identity when using a cloud host
- Prove the loop with a mock campaign (zero model spend) that still exercises streak logic
- Prove a tiny real mission (one acceptance) against a throwaway product
- Enqueue from the human UI and watch status advance without treating local trees as truth
Command recipes and fixture paths stay install-private; examples.md shows shapes only.
Phase E — Hardening (product hygiene)
- Keep private install notes separate from this share pack
- Keep a portable docs pack for friends and coding agents
- Backup strategy for ciphertext and secret config (encrypted off-box; private)
- Document credentials access policy privately
Minimal “hello world” acceptance
You are done with MVP when:
- Mock loop reaches a success streak
- Real builder pushes and proof-of-work accepts real content commits
- Deploy gate sees the version signal advance
- Real tester returns structured pass/fail against the live URL
- Human enqueue → queue → run works from the browser
- Vault lock does not dump secrets into run logs
What to build first (engineering order)
- Loop orchestration + mock roles + mission shape validation
- Real builder adapter + proof-of-work
- Deploy gate against a version signal
- Real tester + verdict contract
- Goal capture UI + mission queue
- Product shell model + product UI
- Credentials boundary + brokered harness access
- Optional overnight observe helpers (no product features)
Skip optional cloud provision until the core loop is boringly reliable.
Continue → AI prompts