Recovery

Debugging

108 cards ~ 10.3 h Field repair

Field-repair playbook. Symptoms, likely causes, and the fixes that worked last time. Read top down when something is on fire.

  1. stratt intermediate 3 min

    Packet Structure & Envelope Format

    Use when: debugging packet corruption; adding a new envelope field; explaining wire format to someone

  2. traceo beginner 3 min

    Per-IP Fixed-Window Rate Limiter

    Use when: tuning MCP_RATE_LIMIT or ENGINE_RATE_LIMIT; debugging unexpected 429 responses; exempting a new health-check path

  3. 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

  4. chronicle intermediate 4 min

    Chronicle JWT Claims & Dev Tokens

    Use when: issuing tokens from an external auth provider; debugging TOKEN_VERIFICATION_FAILED in dev; adding a new authorization claim

  5. chronicle intermediate 4 min

    ProtocolMessage Envelope

    Use when: adding a new wire message type; debugging an INVALID_MESSAGE error; porting changes to the TypeScript mirror

  6. chronicle beginner 4 min

    Documents REST & SQLite Persistence

    Use when: wiring a new document property; debugging RELAY_DATABASE_URL outside Docker; writing a test that needs a fresh document

  7. eva intermediate 4 min

    guard.sh & verify.sh Hook Contract

    Use when: writing a pre-send validator that aborts bad inputs; writing a post-send checker that drives the verified counter; debugging why kick aborted before sending

  8. eva beginner 4 min

    .usage.jsonl Append Format

    Use when: computing prompt usage stats outside of eva show; debugging promotion gate counts; auditing performance medians for a prompt

  9. iris intermediate 4 min

    Gate Engine & Veto Mechanics

    Use when: designing gate conditions; debugging unexpected vetoes; understanding fail-open vs fail-closed behaviour

  10. iris intermediate 4 min

    In-Memory Registry Architecture

    Use when: understanding how iris-service stores data; debugging registry behaviour; planning the PostgreSQL migration

  11. iris intermediate 4 min

    Namespace URI System (iris:// ↔ strat://)

    Use when: understanding cross-system identity mapping; implementing namespace resolution; debugging mapping conflicts

  12. 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

  13. nestr beginner 4 min

    Pellet Data Model

    Use when: adding a new field to the pellet manifest; debugging a checksum mismatch on extract; deciding whether a workspace is frontend, backend, or polyglot

  14. nestr intermediate 4 min

    WebSocket Event Stream

    Use when: subscribing a new client to live cache events; deciding whether to invalidate a TanStack Query cache on an event; debugging why the dashboard never refreshes after a compress

  15. nestr intermediate 4 min

    Service Dependency Graph & Topological Order

    Use when: adding a service that must clone after another; debugging an assemble that runs services in the wrong order; detecting a dependency cycle in CI

  16. so1 intermediate 4 min

    BetterAuth Session Cookie & Edge Middleware

    Use when: debugging a redirect loop between /auth/login and a protected route; adding a new protected URL prefix; investigating why the session cookie is missing in production

  17. sparki beginner 4 min

    Scan Detection Surface

    Use when: adding support for a new language or framework; debugging an incorrect framework attribution; writing a new project detector

  18. stratt beginner 4 min

    strat:// URI Scheme

    Use when: writing a unit import statement; debugging a `parseUri` failure; registering a new domain in the schema enum

  19. traceo beginner 4 min

    Two-Service MCP & Engine Architecture

    Use when: deciding which service owns a new endpoint; debugging cross-service request flow; onboarding to the Traceo backend

  20. weave beginner 4 min

    LCBMessage & DAGNode Schema

    Use when: adding a new field to LCBMessage and need to update all serialisation sites; debugging a wire-format mismatch between two peers running different versions; reviewing the on-wire byte layout produced by to_bytes()

  21. aegis intermediate 5 min

    AegisSystem Architecture Overview

    Use when: onboarding onto the TimeChain access-control layer; debugging an unexpected AccessDenied error from AegisSystem; deciding which AEGIS subsystem owns a new security feature

  22. aegis intermediate 5 min

    Commitment Scheme & CommitmentTypes

    Use when: designing a new AEGIS commitment for a previously untracked attribute; debugging a commitment verification mismatch in CommitmentManager; understanding why a nonce is generated with blake3 rather than a CSPRNG

  23. 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

  24. chronicle intermediate 5 min

    Auth-First WebSocket Handshake

    Use when: debugging AUTH_REQUIRED errors on the relay; adding a new privileged message type; wiring a new identity provider

  25. chronicle intermediate 5 min

    WebSocket Session Lifecycle

    Use when: adding a new privileged WS handler; debugging clients that never receive broadcasts; tracing why a connection was dropped

  26. chronicle intermediate 5 min

    CRDT Operation Message

    Use when: adding a new operation type; debugging operation_rejected on the relay; implementing client-side optimistic apply

  27. chronicle intermediate 5 min

    Operations & Versions Schema

    Use when: writing a new sync query; designing a snapshot compaction job; debugging slow timeline queries

  28. eva beginner 5 min

    meta.yml Schema & Required Fields

    Use when: authoring a new meta.yml; debugging eva doctor failures on required fields; preparing a prompt for skill export

  29. eva intermediate 5 min

    kick Variable Resolution Pipeline

    Use when: debugging why a {{var}} did not substitute; deciding between --var, --var-file, and --case; writing a guard.sh that overlays variables

  30. grace beginner 5 min

    GRACE Session Structure & Context Lifecycle

    Use when: starting a new GRACE session; debugging context loss between turns; explaining how GRACE maintains state

  31. iris intermediate 5 min

    Sprite Data Model & Schema

    Use when: creating or validating a new sprite; understanding the JSON Schema structure; debugging fingerprint mismatches

  32. iris intermediate 5 min

    Chain & ChainStep Schema

    Use when: designing a new chain; debugging chain execution failures; understanding step-to-step data flow

  33. iris intermediate 5 min

    REST API — Council Creation & Chain Execution

    Use when: creating a council via the API; executing chains programmatically; debugging 409 GATE_VETO responses

  34. meridian intermediate 5 min

    Meridian Session Cookie Lifecycle

    Use when: debugging unexpected redirect loops back to airlock; rotating MERIDIAN_SESSION_SECRET; reasoning about session age on the F9 dashboard

  35. nestr intermediate 5 min

    JWT Auth & Per-IP Rate Limiting

    Use when: wiring an external IdP to the Engine via JWKS; tuning rate limits before a load test; debugging a 429 in production

  36. nestr intermediate 5 min

    Web Dashboard Architecture

    Use when: adding a new dashboard route; writing a Playwright test for a new pellet flow; debugging a 401 redirect after token expiry

  37. skyflow intermediate 5 min

    User & Subscription Schema

    Use when: writing a migration that touches user identity; debugging duplicate subscription rows; implementing GDPR delete

  38. skyflow intermediate 5 min

    Protobuf BaseEvent Envelope

    Use when: adding a new event type to a protobuf file; debugging duplicate event delivery; tracing a request across services with correlation_id

  39. skyflow intermediate 5 min

    Achievement Unlock Pipeline

    Use when: adding a new achievement definition; debugging why an achievement did not unlock; writing a unit test for criteria evaluation

  40. skyflow intermediate 5 min

    Redis Sorted-Set Leaderboards

    Use when: adding a new leaderboard variant (per-tier, monthly); debugging stale rank values; estimating Redis memory for N users

  41. smo1 beginner 5 min

    Request Routing & Edge Resolution

    Use when: debugging why a slug returns 404 instead of redirecting; understanding how the edge worker decides between redirect, proxy, and landing; explaining the request path to an infrastructure engineer

  42. smo1 intermediate 5 min

    Tier-Based Rate Limiting

    Use when: debugging 429 errors for specific users; adjusting rate limits for a new subscription tier; understanding how Redis enforces sliding windows

  43. smo1 beginner 5 min

    Gamification: Pawprintz, Treatz & Niblz

    Use when: explaining link health scores to a user; debugging why a link's pawprintz dropped suddenly; designing new gamification mechanics

  44. smo1 intermediate 5 min

    Deployment Topology & Proxy Conflict Resolution

    Use when: setting up a new environment (kitten/cat/lion); debugging why the landing page is not loading; understanding the Cloudflare → Vercel routing

  45. so1 intermediate 5 min

    Same-Origin BFF Proxy Pattern

    Use when: adding a new BFF route exposed to the browser; debugging CORS or cookie failures on a fetch from rover; deciding whether a call belongs in a Server Component or via the proxy

  46. sparki intermediate 5 min

    WebSocket Hub & Rooms

    Use when: wiring a new live event type into the dashboard; debugging missed updates on the build stream; estimating fan-out cost of a broadcast

  47. sparki intermediate 5 min

    Score Metric Model

    Use when: adding a new metric type to the scoring engine; rendering a quality score on the dashboard; debugging a flaky-test detection result

  48. tektree intermediate 5 min

    Gamification XP, Achievements & Leaderboards

    Use when: adding a new XP source for a content action; debugging a leaderboard rank that disagrees with a user's profile

  49. tnp beginner 5 min

    Timeline & TimelineStatus Lifecycle

    Use when: checking whether a timeline counts toward the active_timelines stat; deciding which TimelineStatus to pass when forking an ephemeral branch; debugging why nodes_before_timestamp returns an empty slice

  50. traceo intermediate 5 min

    JWT Auth & RBAC Hierarchy

    Use when: adding a new permission to a tool; debugging 401/403 responses; wiring a new role tier

  51. aegis advanced 6 min

    ConsistencyProof & VEST Integration

    Use when: anchoring an AEGIS proof batch to the VEST audit chain; debugging why ConsistencyProofManager.verify_proof returns false on a freshly created proof; reviewing the XOR consistency check used as a placeholder for Merkle linking

  52. 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

  53. chronicle advanced 6 min

    Timeline Reconstruction

    Use when: implementing a new timeline UI control; debugging timeline_snapshot returning the wrong content; tuning timeline bucket size for chatty edits

  54. eva intermediate 6 min

    eva eval Cases, Assertions & Judges

    Use when: adding a new case to eval.yml; choosing between assertions and a rubric judge; debugging a failing eva eval run

  55. eva intermediate 6 min

    Skill Export Pipeline

    Use when: exporting a ready prompt as an Anthropic skill; debugging an export-skill blocked by doctor; understanding the SKILL.md frontmatter eva produces

  56. fnp intermediate 6 min

    FNP Observability & Prometheus Metrics

    Use when: monitoring FNP systems; setting up alerts; debugging performance issues

  57. grace intermediate 6 min

    Five Unit Types & Nine-State Lifecycle

    Use when: authoring a new STRATT unit and choosing its type; debugging an invalid lifecycle transition error; resolving a CRDT merge conflict on unit status

  58. grace intermediate 6 min

    Cross-Namespace Resolution: stratt:// & choco://

    Use when: adding a choco:// import to a STRATT unit; debugging an FM-02 broken-import on a foreign URI; wiring up the HTTP-mode resolver for production

  59. iris advanced 6 min

    Cross-System Fingerprint Verification

    Use when: verifying sprite identity across IRIS and MERIDIAN; debugging fingerprint mismatches in federation; understanding the 5-stage verification pipeline

  60. iris intermediate 6 min

    Docker Compose & Observability Stack

    Use when: deploying iris-service locally or in production; understanding the full infrastructure stack; debugging observability issues

  61. 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

  62. 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

  63. lore intermediate 6 min

    LORE RBAC & Airlock Auth Flow

    Use when: implementing authentication in a new LORE page; understanding role-based access control in LORE; debugging permission denial issues

  64. lore intermediate 6 min

    LORE+CAIRNET Shared Graph Primitive

    Use when: understanding how LORE and CAIRNET share the graph component; porting the graph to a new app; debugging graph rendering issues

  65. lore intermediate 6 min

    LORE+CAIRNET Backlink & Provenance Tracking

    Use when: understanding how LORE decisions trace back to CAIRNET stones; debugging the graduation backlink display; implementing a new provenance feature

  66. meridian intermediate 6 min

    Airlock Cross-Apex JWT Handoff

    Use when: debugging users who land on stratt.dev unauthenticated despite an airlock session; wiring a new devarno-cloud apex to airlock SSO; rotating airlock's Ed25519 signing keypair

  67. meridian intermediate 6 min

    Audit Token Verification Bridge

    Use when: shipping an audit-record link to a third party; debugging an Audit page that renders 'unable to verify'; reasoning about whether STRATT infrastructure is required to verify a record

  68. petrova intermediate 6 min

    Fleet-Snapshot Workflow to CASA Dashboard

    Use when: debugging why the CASA Petrova zone is stale; rotating HUBBLE_INGEST_TOKEN; explaining the daily 07:00 UTC snapshot path

  69. 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

  70. skyflow intermediate 6 min

    SSE Realtime Gateway Fanout

    Use when: adding a new push notification type; scaling realtime-gateway horizontally; debugging dropped SSE events

  71. smo1 intermediate 6 min

    Edge Redirect Flow

    Use when: debugging why a slug does not redirect; understanding the edge worker's internal flow; optimising redirect latency

  72. smo1 intermediate 6 min

    Multi-Layer Caching Strategy

    Use when: debugging stale link data; designing cache invalidation for a new feature; explaining why the same slug resolves differently on different devices

  73. smo1 intermediate 6 min

    KV Sync Service

    Use when: debugging why a new link is not immediately resolvable at the edge; understanding the async write pattern for edge cache; designing bulk operations that affect many links

  74. smo1 advanced 6 min

    Proxy Mode

    Use when: implementing a white-label short link; debugging why a proxied page shows broken assets; understanding path rewriting at the edge

  75. sparki intermediate 6 min

    Engine Subsystems Map

    Use when: adding a new capability to api-engine; deciding whether a feature belongs in a subsystem or in core; debugging which subsystem owns a failing pipeline stage

  76. sparki intermediate 6 min

    Build Job Worker Lifecycle

    Use when: debugging a stuck build; tuning the build context timeout; tracing how a BuildJob becomes a recorded build row

  77. tektree intermediate 6 min

    API Gateway Request Flow

    Use when: debugging a 401 or 429 response that never reached a downstream service; adding a new route group that proxies to a backend service

  78. tnp intermediate 6 min

    Fork Detection & Storage Analysis

    Use when: deciding whether to prune stale branches before storage overhead exceeds the configured cap; tuning max_active_timelines based on measured fork probability; debugging unexpectedly high storage usage in a multi-branch deployment

  79. traceo intermediate 6 min

    Requirement & Relationship Schema

    Use when: adding a new requirement field to migrations; writing a new traceability relationship type; debugging missing reverse links

  80. traceo intermediate 6 min

    Async CSV Ingestion Job Pipeline

    Use when: uploading a new CSV requirement set; debugging a stuck `running` job; extending the ingestion validators

  81. vest intermediate 6 min

    SignatureProof & AuditSignature Chain

    Use when: debugging a VestError::InvalidSignature returned from ProofVerifier::verify_signature; constructing a valid AuditSignature for a new signer in an integration test; tracing how current_hash propagates through a multi-depth chain

  82. cairnet advanced 7 min

    CAIRNET MCP Tools for Agent Interaction

    Use when: implementing a new MCP tool for CAIRNET; understanding how agents interact with the platform; debugging MCP provider issues

  83. cairnet advanced 7 min

    CAIRNET Agent Identity & Sybil Mitigation

    Use when: implementing agent authentication in CAIRNET; understanding Sybil attack risks in auto-graduation; debugging identity provenance issues

  84. chronicle advanced 7 min

    LSEQ Position IDs

    Use when: investigating runaway position-id growth; debugging concurrent insert ordering; porting the position generator to a new client

  85. iris advanced 7 min

    Blake3 5-Stage Canonical Fingerprinting (DEC-005)

    Use when: implementing or debugging fingerprint computation; cross-system identity verification; understanding the STRATT-compatible hash pipeline

  86. lore advanced 7 min

    LORE Knowledge Seam Contract

    Use when: designing a new API endpoint between LORE and pebble; debugging shape mismatches between LORE and pebble responses; understanding failure semantics in LORE

  87. smo1 intermediate 7 min

    Click Tracking Pipeline

    Use when: debugging missing or duplicate click counts; understanding how analytics data flows from edge to warehouse; explaining the async tracking design to a product manager

  88. smo1 intermediate 7 min

    Link Protection

    Use when: implementing password-protected links; debugging why a protected link shows a prompt instead of redirecting; understanding the edge vs. API split for protection

  89. smo1 intermediate 7 min

    Billing Architecture

    Use when: debugging why a user's tier did not update after payment; adding a new subscription plan; understanding webhook idempotency

  90. traceo advanced 7 min

    Multi-Tenant RLS Policies

    Use when: adding a new tenant-scoped table; debugging empty result sets that should have rows; auditing cross-tenant leakage risk

  91. vest intermediate 7 min

    MerkleProof & ProofPath Inclusion Proofs

    Use when: verifying that a specific operation is included in the audit log without replaying the full log; computing the root hash from a leaf after receiving a ProofPath over the wire; debugging why MerkleProof::verify returns false for a newly created proof

  92. vest intermediate 7 min

    VESTProof Wire Format & Proto Schema

    Use when: implementing a gRPC client that submits or fetches VESTProof messages; adding a new compliance framework marker to an existing AuditEntry; mapping Rust struct fields to their protobuf counterparts when debugging serialisation mismatches

  93. vest advanced 7 min

    Roughtime Distributed Timestamp Proofs

    Use when: validating that a Roughtime timestamp meets the ±100ms legal precision target from SRS SEAL-NF-003; debugging a TimestampProof that passed threshold but has a radius_us outside acceptable bounds; selecting between RoughtimeProof, RFC3161Proof, and BlockchainProof for a given compliance requirement

  94. weave intermediate 7 min

    LCB DAG State Machine

    Use when: debugging why a message is stuck in the DAG and never delivered to the application; tracing a causal ordering violation in a test replay; reviewing Algorithm 1 correctness under concurrent message arrivals

  95. weave advanced 7 min

    Automerge IPLD CRDT Integration

    Use when: debugging why two peers have diverged state_hash values after a merge; adding a new operation type to AutomergeState and need to understand the serialisation contract; reviewing whether the state_hash algorithm is suitable for integrity checking

  96. cairnet advanced 8 min

    CAIRNET+LORE Graduation Pipeline

    Use when: implementing the graduation flow; debugging a graduated stone; understanding the CairnGraduationService

  97. fnp advanced 8 min

    FNP Insert Operation Complete Flow

    Use when: understanding the end-to-end insert operation; implementing insert operations; debugging insertion issues

  98. iris advanced 8 min

    Synchronous Chain Execution Engine (DEC-002)

    Use when: designing chain execution logic; debugging vetoed or failed chains; understanding the synchronous execution model

  99. iris advanced 8 min

    End-to-End Chain Execution Request Flow

    Use when: tracing a chain execution through the entire system; debugging performance bottlenecks; understanding the full request lifecycle

  100. lore intermediate 8 min

    LORE Route Structure & Data Model

    Use when: implementing a new LORE page or route; understanding how LORE pages connect to each other; debugging a data flow issue in the LORE API

  101. lore advanced 8 min

    LORE Causality Graph & Decision Visualization

    Use when: understanding how decisions relate to each other; debugging the force-directed layout; porting the graph primitive to another system

  102. lore advanced 8 min

    LORE+CAIRNET Data Model Isolation

    Use when: understanding why LORE and CAIRNET data are separate; designing a new query that touches both domains; debugging a graduation issue

  103. petrova advanced 8 min

    Outranks DAG and docs-invariants CI

    Use when: adding a new doc category to a consumer repo; debugging a docs-invariants CI failure; auditing whether the rank-graph DAG still holds

  104. smo1 intermediate 8 min

    Core Data Models

    Use when: designing a new feature that touches users, links, or achievements; understanding the API response shape for the dashboard; debugging why a link shows the wrong status or score

  105. smo1 advanced 8 min

    Airlock JWT Handoff & Session Cookies

    Use when: debugging login loops or session expiry; understanding how meow-web authenticates without its own user database; implementing SSO with Airlock in another project

  106. stratt advanced 8 min

    Packet Encoding & Compression

    Use when: debugging encoding errors; optimizing packet size; implementing a new encoder

  107. weave advanced 8 min

    Spanning Tree Election & Broadcast

    Use when: debugging why the broadcast root keeps changing unexpectedly under topology churn; evaluating whether the Prim's-algorithm rebuild every 200 ms is creating a latency spike; tracing the broadcast path for a message originating from a non-root peer

  108. smo1 advanced 10 min

    Multi-Strategy Authentication

    Use when: debugging 401 errors across different clients; adding a new auth mechanism to purr-api; auditing the security surface of the API