What's the Minimum Architecture a Modern Agent Harness Needs?

说明与用途

MiniDSH 展示了一个最小化的代理架构，使用追加日志作为真相来源，明确的所有权边界，策略控制的效果，以及统一的运行时。

问题

Designing a minimal yet architecturally complete agent harness that clearly defines truth, state ownership, permissions, composition, crash recovery, and extensibility.

结果

MiniDSH demonstrates that a small, well‑structured harness can satisfy core architectural invariants, enabling clear reasoning about truth, state, and extensibility while remaining open to future evolution.

工作流

• 1. Identify the minimal set of invariants needed for a modern agent harness.
• 2. Define clear ownership and lifecycle for each component (models, tools, persistence, authority, context).
• 3. Use an append‑only session log as the canonical source of truth.
• 4. Route model proposals through a policy layer that decides effect execution.
• 5. Keep surfaces (terminal, browser, headless) over a shared runtime.
• 6. Before adding a feature, map its ownership, dependencies, lifecycle, and durable state to the existing architecture.
• 7. Conduct hardening/review sessions to falsify and refine the design.

证据

the append‑only session log is the canonical source of truth; models, tools, persistence, authority and context have explicit seams and owners; the model proposes an effect, but policy and the effect boundary decide whether it happens; the model is a routed capability, not synonymous with the agent; terminal, browser and headless are surfaces over one runtime; something gets a first‑class composition boundary only if it actually needs to be replaced, scoped, removed or independently owned.

来源