Git is the history of code. TRACE is the history of understanding.

TRACE connects intent, changes, decisions, evidence, risks, and active-work conflicts — then keeps the durable record portable inside .trace.

Early implementation. Public claims are deliberately limited to what exists.

TRACE / Change Intelligence Path
Illustrative example
Goal
Why this change exists
Enforce bounded memory on telemetry ring buffers
Change
Pull requestRadar #41
3 files · +84 -12 lines · Stream ring-buffer
Evidence
Deterministic checksAST Verified
stream.rs:48 · Bounded memory allocation
Conflict
Collision check0 Collisions
Conforms to ADR-0001 (Ring buffer policy)
Record
Portable .trace artifact
.trace/reports/daily/2026-08-19.md · Hash 1e9b8a

More changes do not create more review capacity.

01
Code generation is frictionless

AI assistants and parallel human contributors produce diffs faster than teams can evaluate systemic impact.

02
Comprehension remains bounded

Understanding whether architectural intent survived across concurrent branches requires verified evidence, not more comment noise.

Human teams and coding agents can increase code volume almost without friction. The expensive part is understanding: whether work fits together across branches, whether intent survived implementation, and what architectural knowledge survives after the merge.

TRACE provides the missing layer: sparse, evidence-backed understanding instead of another stream of unverified automated comments.

Change velocity & agent diff volumeSurging diff volume
Human review & systemic comprehensionBounded capacity

Three layers of durable engineering context.

Structured engineering memory designed for longevity across repository lifecycles.

01

Understand change

Connect what changed to original intent, deterministic AST evidence, affected boundaries, and unfinished work.

Deterministic AST Checkstream.rs:48 · No unbounded buffer allocations
02

See parallel work

Surface possible conflicts across active branches before concurrent PRs make coordination expensive.

Collision DetectorPR #88 vs #89 · user_workspaces migration conflict
03

Keep the record

Preserve decisions, risks, and reports as readable repository artifacts, not ephemeral dashboard-only state.

Durable Artifact.trace/reports/daily/2026-08-19.md · Hash 1e9b8a

The dashboard is a view. The record belongs to the project.

.trace is a proposed versioned artifact layer for reports, decisions, risks, pull-request intelligence, and synchronization state. The record stays inside your Git tree, human-readable in Markdown and structured YAML.

Read the current specification (RFC-001) →
Repository Tree
.trace/
├── config.yml
├── reports/
│ ├── daily/2026-08-19.md
│ └── weekly/2026-08-17.md
├── decisions/
│ └── 0001-memory.md
├── conflicts/
└── state/
reports/daily/2026-08-19.mdYAML + Markdown
---
id: rep-radar-2026-08-19
type: daily_report
repo: mathofdynamic/Radar
commit: 1e9b8a4746f3
freshness: current
---
# Daily Intelligence Report
- Verified rule: Deterministic Memory Bounds
- Source code uploaded: false

Engineered for local control and selective synchronization.

Clear separation between verified local execution and optional coordination layers.

Execution ModeStatusSource Code HandlingAnalysis PipelineDurable Storage
Local ExecutionActive · Production ReadyNever leaves machine (0 bytes transmitted)Local AST & symbol extractionLocal .trace/ directory in repository
Hybrid IntelligenceActive · Selective SyncOnly signed metadata & summaries uploadedClient-side redaction before pushRepository-native + synchronized view
Cloud CoordinationPlanned · Opt-in PolicyEphemeral isolated sandbox (Opt-in only)Automated webhook evaluation pipelineEnterprise artifact registry backup

Make the reasoning around change durable.

Equip human developers and coding agents with shared, verifiable repository memory that persists across pull requests.

TRACE Artifact Ledger
RFC-001
Specification.trace v0.1
Execution EngineLocal CLI (Verified)
Integrity HashSHA-256 Checksum
Source Transmission0 Bytes (Local Analysis)