Onboarding

Traceo

16 cards ~ 1.2 h Foundational

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

More about this project on the Traceo hub.

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

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

  3. traceo beginner 4 min

    Classification Layers & Status Lifecycle

    Use when: approving a requirement for implementation; deprecating an obsolete requirement; filtering the traceability matrix by layer

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

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

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

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

  8. traceo intermediate 5 min

    FastMCP Tool Surface

    Use when: registering a new MCP tool; deciding which tool to expose to Claude vs HTTP-only; auditing the tool catalogue

  9. traceo intermediate 6 min

    Ariel Baseline Lifecycle

    Use when: freezing a baseline before a release review; diffing two baselines to produce a change report; linking a baseline to Traceo requirements

  10. traceo intermediate 5 min

    pgvector RAG Embeddings

    Use when: tuning embedding recall vs latency; rebuilding the HNSW index after a model swap; adding a new RAG-backed tool

  11. traceo beginner 4 min

    Observability State & Gaps

    Use when: scoping a tracing or structured-logging rollout; writing a new alert and discovering nothing emits the metric; answering 'do we have correlation IDs?' (we don't)

  12. traceo beginner 3 min

    The Audit Room at 9pm

    Use when: writing the Traceo homepage hero or one-line description; explaining what category Traceo lives in

  13. traceo beginner 4 min

    Two Rooms, One Product

    Use when: deciding which case study or testimonial to lead with; qualifying an inbound lead before a demo

  14. traceo beginner 3 min

    Exact. Calm. Expert.

    Use when: writing copy for the Traceo site, docs, or a launch post; reviewing a draft for voice match before it ships

  15. traceo beginner 4 min

    End-to-End or Nothing

    Use when: explaining what success looks like for Traceo's first program; answering 'why not just ship the MCP server first'

  16. traceo beginner 4 min

    Modernising the Category, Not the Aesthetic

    Use when: answering 'how is Traceo different from DOORS, Polarion, or Jama'; answering 'how is Traceo different from a Linear-style tool for specs'