Onboarding

Rocky

17 cards ~ 1.4 h Foundational

Foundational walk through the rocky project. Read top to bottom if you're new; no prior context assumed.

  1. rocky beginner 4 min

    Rocky Superproject Topology

    Use when: onboarding a new submodule into rocky-hq; deciding where a new file belongs (parent vs submodule); auditing what the parent repo is allowed to contain

  2. rocky beginner 5 min

    Subsystem Map SS-01 to SS-08

    Use when: deciding which subsystem owns a new feature; tracing where a console route forwards to; explaining Rocky's surface to a new operator

  3. rocky intermediate 6 min

    Tenancy Invariant: Airlock + HATCH + Polar

    Use when: adding a new mutating route to any Rocky subsystem; auditing why a request reached a driver without an audit event; porting a self-host install that must skip Polar.sh

  4. rocky beginner 4 min

    Workspace Registry YAML Schema

    Use when: adding a workspace row to registry.yaml; writing a HEARTH driver that reads the registry; validating a registry edit before opening a PR

  5. rocky intermediate 6 min

    RALPH Console Wrapper (SS-07)

    Use when: submitting a RALPH run from the console UI; debugging an SSE stream that stalls mid-run; moving the worker between in-process and sidecar transport

  6. rocky intermediate 5 min

    RALPH on KAHN Transitions Schema

    Use when: writing a consumer that reads RALPH journal events; deciding whether a new RALPH metadata field needs a schema bump; mapping a deviation severity onto KAHN's Outcome enum

  7. rocky advanced 7 min

    CRDT Sidecar WebSocket Transport

    Use when: diagnosing a hung collaborative-editing session; deciding whether to enable RALPH_CRDT_TRANSPORT in a deployment; writing a Yjs persistence migration

  8. rocky intermediate 6 min

    HEARTH Driver Protocol

    Use when: implementing a new HEARTH driver (Kustomize, DevarnoCloud, or beyond); writing a contract test against FakeDriver; tracing why a Status call returned tier_torn_down

  9. rocky intermediate 5 min

    HEARTH Tier Model & ProvisioningProfile

    Use when: adding a new tier without writing new driver code; deciding which `vector_index` belongs in a profile; understanding why solo never touches Polar.sh

  10. rocky intermediate 5 min

    DeploymentRef & VAULT Credential Path

    Use when: auditing where a workspace credential is stored; writing a SS-08 read route for getWorkspaceDeployment; diagnosing why a console log accidentally contained a secret

  11. rocky advanced 7 min

    Provision-then-RALPH End-to-End

    Use when: diagnosing where the e2e chain broke after a phase ref-bump; explaining the OSS-parity contract to a self-hoster; tracing which HATCH events should appear in a healthy run

  12. rocky intermediate 5 min

    Polar Entitlements & OSS Parity

    Use when: auditing whether self-host links any Polar.sh code; deciding what happens when a Polar subscription cancels mid-run; wiring `/api/relay/polar` in Phase 7

  13. rocky beginner 3 min

    Erid: An Umbrella Domain, Not a Product Landing

    Use when: explaining what erid.tech is to a peer or collaborator; writing the apex copy or any meta description for the domain

  14. rocky beginner 3 min

    Three Readers, in Order of Weight

    Use when: writing or reviewing copy for any erid.tech surface; deciding what to add or remove from the apex page

  15. rocky beginner 4 min

    Three Words for the Voice: Clinical, Lore-Faithful, Mineral

    Use when: drafting or editing copy for any erid surface; explaining the brand register to a collaborator or sub-agent

  16. rocky beginner 4 min

    Four Things erid.tech Refuses to Be

    Use when: answering 'why does erid.tech look so spare?'; reviewing a draft against the anti-references

  17. rocky beginner 4 min

    Citizens Promote, One at a Time, Reserved to Live

    Use when: explaining how new citizens appear on erid.tech; writing a release note when a reserved citizen goes live