Backfill architecture decision records

Seven ADRs capturing the why behind decisions already made: vendoring Cordis as source with a guarded manifest; the microkernel event taxonomy with one swappable concrete loop; event-sourced sessions with derived history and the append-before-emit ordering contract; the provider-neutral content-block vocabulary (and why not OpenAI/Anthropic shapes); the custom tool-schema DSL over schemastery; tool schemas living in the prompt assembly; and mechanical quality gates over prose guidelines (the agents-write-the-code rationale).
2026-06-11 15:24:14 +08:00
parent 370b5d3aab
commit 9b8fccc6f9
8 changed files with 268 additions and 0 deletions
@@ -0,0 +1,19 @@
+# Architecture Decision Records
+
+Short, immutable records of the *why* behind decisions that shape this
+codebase. Code and docs say what the system does; ADRs say why it does it
+that way and what we gave up.
+
+Format: one file per decision, numbered, with Status / Context / Decision /
+Consequences. An ADR is never edited into a different decision — supersede it
+with a new one and cross-link.
+
+| # | Title | Status |
+|---|---|---|
+| [0001](0001-vendor-cordis-as-source.md) | Vendor Cordis as source, not npm dependencies | accepted |
+| [0002](0002-microkernel-event-taxonomy.md) | Microkernel: extension via Cordis event taxonomy, one concrete loop | accepted |
+| [0003](0003-event-sourced-sessions.md) | Event-sourced sessions with derived message history | accepted |
+| [0004](0004-own-content-block-vocabulary.md) | Provider-neutral content-block vocabulary owned by dsh-llm | accepted |
+| [0005](0005-custom-schema-dsl-over-schemastery.md) | Custom typed tool-schema DSL instead of schemastery | accepted |
+| [0006](0006-tool-schemas-in-prompt-assembly.md) | Tool schemas are part of the system-prompt assembly | accepted |
+| [0007](0007-quality-gates.md) | Mechanical quality gates over prose guidelines | accepted |