deepseek-harness/docs/rfc/implemented/architecture
Tianyi Cui 6227cfd03d docs(architecture): rewrite the system map to the 1,800-word budget
architecture.md is the behavior map: layering, service map, seam
pattern, and the loop — everything else defers to its owning tier.

- Seam narrations compress to two-to-four sentences plus links to the
  RFC and type-catalog homes that carry the detail (turn-end variant
  semantics -> session.md, derivation mapping -> session.md, StreamChunk
  conventions -> llm-streaming.md + source).
- The MVP feature-to-mechanism checklist moves de-statused into the
  extension cookbook as 'The feature -> mechanism map' — mechanisms
  only, no implementation-status bolding to rot; the microkernel RFC's
  proof-obligation pointer follows it.
- The layering diagram describes layers by family instead of
  enumerating packages (the stale 'future plugins: hooks, compaction'
  row is gone); the dependency rule defers to packages/README.md.
- The loop pseudocode, the three externally-cited anchors (the
  vocabulary, event taxonomy, waterfall semantics), and the filename
  are unchanged.
- Budget ratchet: docs/architecture.md 3897 -> 1800 (now 1,797 words);
  the doc-tiers RFC's deferred list prunes the item this ships.
2026-07-04 14:43:48 +08:00
..
2026-06-11-content-block-vocabulary.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
2026-06-11-custom-schema-dsl.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
2026-06-11-dev-invariants-over-deep-readonly.md fix(events): address Codex review — protect post-execute result, purge stale tools/execute refs 2026-06-30 20:25:30 +08:00
2026-06-11-event-sourced-sessions.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
2026-06-11-microkernel-event-taxonomy.md docs(architecture): rewrite the system map to the 1,800-word budget 2026-07-04 14:43:48 +08:00
2026-06-11-runtime-arg-validation.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
2026-06-11-structured-error-taxonomy.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
2026-06-11-tool-schemas-in-prompt-assembly.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
2026-06-13-capability-seams.md fix(events): address Codex review — protect post-execute result, purge stale tools/execute refs 2026-06-30 20:25:30 +08:00
2026-06-13-twin-llm-adapters.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
2026-06-14-session-persistence.md fix review findings: sync stale v1/removed-event doc references 2026-06-21 11:33:41 +08:00
2026-06-15-turn-enclosure-invariant.md refactor(events): remove the turn boundary mirror events 2026-07-02 03:26:45 +08:00
2026-06-17-filesystem-capability-seam.md fix(fs): translate listDir metadata failures 2026-07-03 15:12:40 +08:00
2026-06-18-agent-lifecycle-and-ownership-seams.md simplify(agent): drop the unused public Agent.abort(), keep whenIdle() 2026-06-21 09:05:21 +08:00
2026-06-18-session-surface.md fix review findings: skip collided SCHEMA_VERSION 3; reject marker-less surface events 2026-06-24 17:45:48 +08:00
2026-06-18-shared-persistence-write-coordinator.md simplify(seams): prune dead methods from the persistence and bash seams 2026-06-21 02:17:27 +08:00
2026-06-20-branded-ids.md fix review findings: document the util/ group + align branded-ids RFC with dsh-brand 2026-06-21 11:04:28 +08:00
2026-06-20-extract-example-app-packages.md docs: rename coding demo to repl 2026-07-04 01:07:26 +08:00
2026-06-20-package-hierarchy.md docs: sync package cookbook with build config 2026-06-22 11:36:35 +08:00
2026-06-24-web-capability-seam.md fix: address web seam review findings 2026-07-01 17:08:53 +08:00
2026-06-26-file-context-as-event-gate.md feat(coding-agent): wire the filesystem tools into the demo 2026-07-02 19:46:59 +08:00
2026-06-30-bash-stdin-env-trusted-plugin-surface.md docs(AGENTS): rewrite the root standing orders to the 1,500-word budget 2026-07-04 14:22:47 +08:00
2026-06-30-event-domain-semantics.md refactor(events): remove the agent/stream-chunk mirror of assistant/chunk 2026-07-02 23:42:16 +08:00
2026-07-02-fs-per-session-cwd.md fix(fs): resolve paths against the caller's session cwd 2026-07-02 18:29:29 +08:00
2026-07-02-result-time-applied-hunk-diffs.md fix(acp): relativize the completed diff card title 2026-07-03 23:14:22 +08:00
2026-07-02-tool-render-intent-union.md docs: finish the whole-file-diff sweep across comments and RFCs 2026-07-03 21:50:52 +08:00
2026-07-03-filesystem-directory-listing-seam.md fix(fs): translate listDir metadata failures 2026-07-03 15:12:40 +08:00