index.md

TraceCore docs index

This page is the canonical documentation map for TraceCore: start here if you want the fastest path to installation, running your first deterministic episode, integrating TraceCore into CI, or exploring the spec and dashboard surfaces.

Start with a goal

• Install and run TraceCore locally

  • README quick example
  • Install TraceCore
  • Quick start commands
  • CLI command reference

• Understand what TraceCore is

  • README overview
  • Technical spec explainer
  • Architecture reference
  • Project positioning

• Integrate with an agent stack

  • OpenAI Agents Python guide
  • AutoGen adapter tutorial
  • LangChain adapter example
  • Agent catalog
  • Agent interface contract

• Run TraceCore in CI or GitHub Actions

  • tracecore-action
  • External consumer-validation repo
  • CI workflow docs

• Inspect artifacts, bundles, and verification flows

  • Ledger workflow
  • Troubleshooting
  • Debugging playbook
  • Manual verification checklist
  • Artifact migration playbook

Core references

• CLI and runtime

  • CLI command reference
  • CLI runner notes
  • CLI troubleshooting
  • Tool shim guidance

• Specification

  • Canonical spec bundle
  • Artifact schema
  • Determinism requirements
  • Compliance checklist
  • Spec explainer

• Agents and tasks

  • Agent catalog
  • Agent interface contract
  • Task harness guide
  • Task plugin contribution guide
  • SPEC freeze / task registry snapshot

• Operations and governance

  • Release process
  • Performance baselines
  • Record mode
  • Ledger governance
  • Signing key rotation

Recommended first examples

• Fast deterministic local run

  • tracecore run pairing log_stream_monitor --seed 7 --strict-spec

• Fixture-backed adapter example

  • LangChain adapter example

• OpenAI Agents integration path

  • OpenAI Agents Python guide
  • OpenAI Agents scaffold prompt