Skip to content

README.md

Latest commit

 

History

History
46 lines (34 loc) · 1.83 KB

README.md

File metadata and controls

46 lines (34 loc) · 1.83 KB

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.