Onboarding

Kahn

20 cards ~ 1.5 h Foundational

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

More about this project on the Kahn hub.

kahn-hqkahn
  1. kahn beginner 4 min

    Producer / Reader Split

    Use when: onboarding a new producer repo; debugging why Scope shows stale data; deciding where to add a new write path

  2. kahn intermediate 6 min

    Prompt-DAG Scheduler

    Use when: designing a graph.json for a new repo; debugging why a node never starts; tuning max-parallel for a fleet run

  3. kahn intermediate 5 min

    Ralph Convergence Loop

    Use when: tuning max_ralph_iters for a flaky node; diagnosing flake_retries counts; writing a new done_when command

  4. kahn beginner 4 min

    Archive Directory Layout

    Use when: wiring a new EventSource backend; auditing where a producer wrote; rebuilding index.json after corruption

  5. kahn intermediate 6 min

    CI Transition Event Schema

    Use when: vendoring kahn_emit.py into a CI producer; validating a transitions.jsonl line; debugging an event rejected by Scope

  6. kahn intermediate 7 min

    Agent Transition Event Schema

    Use when: vendoring kahn_agent_emit.py into an agent loop; designing an agent_id namespace; interpreting a converged vs partial outcome

  7. kahn intermediate 5 min

    Dual Emitter Contract

    Use when: vendoring an emitter into a sister repo; considering merging the two emitter modules; auditing forward-compat behaviour

  8. kahn beginner 4 min

    Graph Topology Snapshot

    Use when: authoring a new graph.json; rendering a replay after the live graph changed; validating done_when items in CI

  9. kahn intermediate 5 min

    OSS & Cloud Modes

    Use when: self-hosting via docker compose; configuring a Railway deploy; deciding which storage backend to wire

  10. kahn intermediate 6 min

    Airlock Bearer Auth

    Use when: diagnosing a 401 from /v1/ingest/*; rotating airlock JWKS keys; writing a client_credentials producer

  11. kahn intermediate 4 min

    In-Process Rate-Limit Bucket

    Use when: investigating ingest 429s; scoping a horizontal scale-out of host:api; rendering /api/self/tenant bucket state

  12. kahn advanced 6 min

    Horizontal Scalability Seams

    Use when: planning an S3-backed archive; implementing a new EventSource; answering 'does KAHN scale horizontally?'

  13. kahn beginner 3 min

    Run Outcome Classification

    Use when: interpreting a History row's status pill; wiring a CI exit-code policy; deciding whether flake_retries should escalate

  14. kahn intermediate 4 min

    Retention Soft & Hard Delete

    Use when: auditing why a run vanished; wiring an export endpoint for a customer near expiry; tuning beta retention days

  15. kahn intermediate 5 min

    Audit Checkpoint Fleet Partition

    Use when: adding a new audit checkpoint definition; investigating why a checkpoint shows the wrong agent_id; interpreting per-agent diagnostics

  16. kahn beginner 3 min

    Fleet Health in Seconds, Not in Tabs

    Use when: writing the KAHN homepage hero or one-liner; explaining to a peer what category KAHN sits in

  17. kahn beginner 3 min

    The Operator at a 27-inch Monitor

    Use when: explaining who KAHN is for in a single paragraph; deciding whether a feature serves the primary user

  18. kahn beginner 3 min

    Convergence, Not Exit Code Zero

    Use when: explaining what KAHN measures that other runners do not; answering 'why a new dashboard'

  19. kahn beginner 4 min

    Built by the Person Who Has To Use It

    Use when: telling the origin story to a peer or pilot evaluator; framing the v0.1 release on a launch post

  20. kahn beginner 3 min

    Evidence, Not Status Theatre

    Use when: answering 'how is KAHN different from Datadog or LangSmith style dashboards'; writing the comparison section of a launch post