ADRs

Architecture Decision Records

This directory documents significant architectural and design decisions made in agent-strace. Each ADR captures the context, the decision, and its consequences.

Format

Each ADR follows this structure:

# ADR-NNNN: Title

**Status:** Proposed | Accepted | Deprecated | Superseded by ADR-XXXX
**Date:** YYYY-MM
**Deciders:** Name(s)

## Context
What situation or problem prompted this decision?

## Decision
What was decided and how does it work?

## Consequences
What are the trade-offs, limitations, and follow-on effects?

Index

ADR	Title	Status
0001	Flat Event Stream as the Core Data Model	Accepted
0002	NDJSON File Storage — No Database	Accepted
0003	Zero Runtime Dependencies	Accepted
0004	Hook Integration via Separate OS Processes	Accepted
0005	MCP Proxy as a Transparent stdio Man-in-the-Middle	Accepted
0006	OTLP Export via HTTP/JSON — No gRPC, No SDK	Accepted
0007	Heuristic Secret Redaction	Accepted
0008	Token and Cost Estimation via Character-Count Heuristic	Accepted
0009	Claude Code JSONL Session Import	Accepted
0010	Session Explanation via Prompt-Boundary Phase Detection	Accepted

Adding a new ADR

1. Copy the format above into a new file: NNNN-short-title.md
2. Use the next available number.
3. Add a row to the index table above.
4. Set status to Proposed until the decision is merged.