Onboarding

Toll

30 cards ~ 2.1 h Foundational

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

  1. toll beginner 3 min

    One gate, every app: why TOLL is the ticket

    Use when: the plan feels like it is drifting and you need the one-sentence why; deciding whether a new app should wire its own billing or go through TOLL

  2. toll beginner 3 min

    The freedom ladder: $0 to $10k MRR in placeholder rungs

    Use when: you want a number for 'how far away are we'; setting or revising the real freedom target

  3. toll beginner 4 min

    Subs needed per rung: the arithmetic of freedom

    Use when: turning the freedom number into a count of customers; choosing which product to push next

  4. toll beginner 2 min

    The drift check: five questions when effort wanders

    Use when: you notice a week went into a project that is not on the TOLL ladder; starting a session and choosing what to work on

  5. toll intermediate 5 min

    petrova: the governance plane that ties the estate together

    Use when: explaining why TOLL is governed from outside its own repo; working out which file is intent, which is reality, and which path may write

  6. toll intermediate 4 min

    TOLL's petrova contract and registry row, field by field

    Use when: asking what petrova currently believes about TOLL; deciding whether a fleet or agent may touch the TOLL repo

  7. toll intermediate 4 min

    Governance drift on TOLL: three disagreements and how to close them

    Use when: a petrova dashboard shows TOLL differently from the repo; running a reconcile pass on the money spine

  8. toll intermediate 5 min

    Traceability chain: requirement to matrix to SRS to Traceo baseline

    Use when: proving a money behaviour is verified, not just tested; moving TOLL's traceo integration from pending to wired

  9. toll beginner 4 min

    devarno.cloud vs arno.host: the apex split and where everything runs

    Use when: deciding which apex a new paid surface belongs on; finding which platform to look at when TOLL or a consumer misbehaves

  10. toll intermediate 5 min

    The CASA seam: canUserAccessApp = Airlock RBAC OR TOLL, fail-closed

    Use when: a paid user says they paid but cannot open the app; adding a new paid app to family-hub

  11. toll beginner 3 min

    arno-host SKULD: where revenue should land, and why it does not yet

    Use when: you want one place that shows real money against the freedom ladder; planning the revenue read-back from TOLL into the private finance view

  12. toll intermediate 5 min

    mary-wiki: the rulebook layer that says TOLL is the only money spine

    Use when: an app wants to bill outside TOLL and you need the ruling; deciding whether an action needs a recorded GO

  13. toll intermediate 4 min

    eva-hq: prompts and cycles that act on TOLL without touching it

    Use when: looking for a ready prompt to wire a consumer or onboard a baseline; asked why TOLL is eva not_applicable

  14. toll intermediate 3 min

    hermes and IRINA: why automated fleets never see TOLL

    Use when: wondering why no IRINA report ever mentions the money spine; deciding how TOLL gets periodic outside review

  15. toll intermediate 6 min

    Money to access: checkout, webhook, log, fold, entitlements, reconcile

    Use when: tracing why a paying customer does or does not have access; explaining the TOLL spine end to end in one picture

  16. toll intermediate 4 min

    Per-consumer identity: kids, namespaced subjects, and the dead god-secret

    Use when: issuing a key to a new consumer app; a consumer gets 401 or 403 SUBJECT_FORBIDDEN

  17. toll intermediate 4 min

    The ratify loop: no money change without a human click

    Use when: changing prices, products or benefits in Polar through TOLL; an item sits in /pending or /stuck

  18. toll intermediate 4 min

    Capabilities: code registry vs spec catalogue, and the silent-rename trap

    Use when: adding a capability for a new paid app; a paid user's capability string does not match what the app checks

  19. toll intermediate 4 min

    Deploy, smoke, roll back: the only path to production

    Use when: shipping a TOLL change to Railway; a deploy went bad and you want to know what already happened automatically

  20. toll advanced 4 min

    x402: the second rail for paying agents, and why it is still a mock

    Use when: someone asks whether agents can pay per call; deciding whether x402 work moves a freedom rung

  21. toll intermediate 6 min

    The consumer wiring recipe: turn any app into a paid TOLL consumer

    Use when: starting to monetise a new app through TOLL; migrating an app off direct Polar billing

  22. toll intermediate 4 min

    traceo-cat: the first external-shape consumer, waiting on P3

    Use when: working on Traceo Team billing; deciding what unlocks Traceo's first live dollar

  23. toll advanced 5 min

    smo1-io: billing Polar directly today, and how to bring it onto TOLL

    Use when: planning smo1 Pro/Business revenue; purr-api starts returning 500 on Polar webhooks

  24. toll advanced 4 min

    chocotools: Go gateway billing direct, plus an orphan skyflow.pro

    Use when: planning choco Pro/Team revenue; someone asks what skyflow.pro in toll.spec.yaml is for

  25. toll beginner 3 min

    Consumer status board: from direct-Polar to earning

    Use when: you want one picture of every monetisable app's stage; picking the next app to move a stage

  26. toll beginner 4 min

    How far from freedom? The master map, with you-are-here

    Use when: you need the honest answer to 'how far are we' in one picture; monthly check-in on the TOLL plan

  27. toll intermediate 8 min

    Mistake catalogue: symptom, cause, fix, evidence

    Use when: something on the money path behaves oddly and you want the known causes first; before any change to TOLL, a consumer, Railway or Polar settings

  28. toll intermediate 4 min

    Operator gates outstanding: the checklist only you can tick

    Use when: you have an hour of operator time and want the highest-value item; preparing for P3

  29. toll beginner 3 min

    The next ten moves to the first live dollar, ranked

    Use when: choosing today's work; re-planning after a gap of more than a week

  30. toll beginner 2 min

    Re-entry: read this first after time away from TOLL

    Use when: coming back to TOLL after days or weeks on something else; the plan feels foggy and you want the shortest path back in