Docs

Start from the documents that define the evidence boundary.

This page maps the public docs that explain what TraceMap is building, how validation works, what counts as acceptance, and where language adapters must preserve deterministic, rule-backed evidence.

Product requirements

Purpose, non-goals, workflows, evidence model, and the narrow contract-change review question.

Product requirements (PRD.md)

Validation guide

Repeatable local checks, public demo expectations, pinned smoke guidance, and generated-output safety rules.

Validation guide (VALIDATION.md)

Deploy audit

Static-site audit for generated routes, sitemap metadata, robots policy, LLM discovery, JSON indexes, and public claim boundaries.

Deploy audit

Evidence packet guide

Site-facing reader path for managers, reviewers, architects, and engineers inspecting demo-safe static evidence packets.

Evidence packet guide

Proof path index

Site-facing index of public/demo proof surfaces by artifact type, rule ID, evidence tier, coverage label, proof path, limitation, and status.

Proof path index

Proof source catalog

Site-facing route-to-source map for public wording, proof paths, source documents, rule families, limitations, and non-claims.

Proof source catalog

Public roadmap

Site-facing claim ledger for what is current on main, reproducible as a demo, concept-level, or hidden until safe to summarize.

Public roadmap

Legacy evidence story

Concept route for hidden legacy evidence themes, public-safe promotion gates, claim boundaries, and rendered-content safety checks.

Legacy evidence story

Language adapter contract

Shared expectations for adapters that emit facts, relationships, reports, and reducer-compatible evidence.

Language adapter contract

Next execution report

Current runway notes, coordination state, and near-term execution context for future agents and maintainers.

Next execution report

How to read them

The docs are guardrails, not marketing copy.

Start with scopeUse the PRD to understand what TraceMap should and should not claim.
Map capabilitiesUse the capability map to see status-labeled workflows, adapter maturity, and demo-safe surfaces.
Track public claimsUse the roadmap to see how shipped, demo, concept, and hidden site claims are gated.
Share carefullyUse the evidence packet guide to keep summaries attached to rule IDs, coverage labels, and limitations.
Check proofUse validation and acceptance docs to see how behavior is verified.
Respect limitsUse decisions and adapter contracts to keep rule-backed evidence portable across languages.
Track runwayUse execution notes for current context, but treat implemented specs and code as stronger evidence.

The repository remains the source of truth.

The site gives humans and bots a stable entry point, but the canonical documents live in the public repository. TraceMap documentation should keep pointing back to code, rules, tests, specs, and generated evidence.