Onboarding

Choco

15 cards ~ 1.1 h Foundational

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

  1. choco beginner 5 min

    Choco Factory Architecture Map

    Use when: onboarding to a new choco service repo; deciding which layer a new service belongs in; tracing a request from edge to vault

  2. choco intermediate 4 min

    EventEnvelope Wire Wrapper

    Use when: publishing a new domain event proto; debugging causation chains in distributed traces; writing a NATS consumer that needs to dedupe by content

  3. choco intermediate 4 min

    NATS Subject Taxonomy

    Use when: wiring a new consumer to the right stream; deciding which event domain a new proto belongs in; naming a stream for a new factory-equipment service

  4. choco advanced 6 min

    Site Provisioning Saga State Machine

    Use when: debugging a site stuck mid-provision; extending the saga with a new state; extracting the orchestrator into choco-forge

  5. choco intermediate 5 min

    Site Hosting Modes & Lifecycle Stages

    Use when: adding a new fork branching on platform vs user_git; writing a CHECK constraint for a sibling resource table; applying the platform-hosted pattern to another resource

  6. choco intermediate 5 min

    Onboarding Lifecycle Events

    Use when: wiring an analytics consumer to onboarding signals; adding a new step to the onboarding flow; distinguishing skipped from abandoned in the dashboard

  7. choco intermediate 4 min

    Factory Equipment Services

    Use when: deciding which factory service should own a new pipeline step; tracing a document from ingest to publish; wiring a new factory-equipment service alongside the existing four

  8. choco advanced 5 min

    Golden Ticket Issuance

    Use when: auditing the five-ticket cap enforcement; verifying a ticket signature in a downstream consumer; extending the anti-gaming rules

  9. choco advanced 5 min

    Slash Commands as CRDT Operations

    Use when: adding a new slash command to the editor palette; debugging a smartblock that didn't fan out to webhooks; deciding whether a new editor action needs its own NATS event

  10. choco intermediate 4 min

    Tutorial Workflow Runs

    Use when: adding a new tutorial scenario to the gallery; applying the platform-hosted pattern to another resource; writing a Prometheus alert on the 3-concurrent cap

  11. choco beginner 3 min

    Verifiable Docs, Not a Wiki and Not an LLM Wrapper

    Use when: writing the choco.tools homepage hero; answering 'what should we use for docs?' in a Slack thread

  12. choco beginner 3 min

    Three Readers, One Surface, Three Different Jobs

    Use when: deciding which audience a marketing page is written for; auditing copy that tries to talk to everyone at once

  13. choco beginner 3 min

    Verifiable, Considered, Durable: The Three-Word Test

    Use when: drafting a tagline or headline; rejecting a draft that sounds like a generic devtool

  14. choco beginner 4 min

    The Website Is the Proof

    Use when: explaining why choco.tools is built on choco; framing the launch sequence to a stakeholder

  15. choco beginner 3 min

    Not the Category Reflex: Four Looks Choco Refuses

    Use when: rejecting a homepage mock that drifts toward devtool clichés; explaining what choco is not, before saying what it is