---
type: adr
title: ADR-NNNN — Short title of the decision
status: draft # draft | accepted | superseded
created: 2026-06-26
updated: 2026-06-26
tags: []
supersedes: null # e.g. "0003" if this replaces an earlier ADR
superseded-by: null # filled in later if this ADR gets replaced
related: [] # paths to related docs (features/guides/other ADRs)
---

# ADR-NNNN: Short title of the decision

## Context

What is the situation that forces a decision? What constraints apply (the OKF spec, the `okf` crate's capabilities, the local-first/deterministic principle, a roadmap milestone, bundle scale)? Keep it factual — a reader six months from now should understand why this was even a question.

## Options considered

### Option A — name

Brief description. Pros and cons relative to *this project's* needs (token-frugality, agent-runnability, dependency-lightness), not in the abstract.

### Option B — name

Same.

## Decision

The option chosen, stated plainly, and the main reasons it won.

## Consequences

What becomes easier, what becomes harder, and what we're committing to. Include follow-up work this decision creates and any new open questions — record those in the feature spec they belong to, or note them here.

## Related

- Links to relevant features, guides, or other ADRs: `../features/….md`
