Use an append-only ecosystem intelligence ledger
Add immutable Event and Decision records, derive current initiative state from each thread head, and generate one chronological HTML plus one machine-readable intelligence projection alongside automatic Release and Snapshot history.
Context, reasoning, and consequences
Context: Git history proves that a change landed but does not reliably expose active intent, reserved scope, rationale, alternatives, consequences, handoff state, or relationships across repositories to newly arriving agents.
Rationale
- Append-only events preserve what was believed and intended at the time without rewriting history.
- Machine-readable ADRs prevent architectural boundaries from being buried in prose or commit messages.
- Active branch and path reservations make concurrent work visible before agents collide.
- Automatic Release and Snapshot entries provide broad changelog coverage while authored events carry intent and reasoning.
Alternatives
- Use Git log alone · rejected — Commits do not carry a validated cross-repository scope, active-state protocol, or decision graph.
- Maintain one mutable CHANGELOG document · rejected — Concurrent edits would conflict and prior intent could be silently rewritten.
- Create append-only events and decisions with generated projections · chosen — It preserves history, supports agents, and keeps HTML subordinate to data.
Consequences
- A cold agent can query current initiatives, decisions, changes, and registry lineage from one JSON file.
- Concurrent lanes can reserve scope and close work with evidence.
- Material work now requires a small start or completion event in addition to code and registry records.
- Expose the same projection through the future read-only Library CLI and MCP server.
- Automate event creation from agent hooks after the manual contract stabilizes.