Document the architecture and rewrite AGENTS.md

docs/architecture.md: layering, service map, event taxonomy, the
session/turn/step lifecycle, Cordis waterfall semantics, an extension
cookbook, the plugin sanity checklist mapping every MVP feature to its
extension mechanism, and the deferred-work TODO list (sub-agents,
persistence backends, compaction, DeepSeek V4 adapter, parallel tool
execution, streaming-protocol review).

AGENTS.md: repo layout, commands, conventions (dsh-* naming, ESM,
effect-based registrations, declaration merging, waterfall semantics),
and the vendoring policy pointer.
This commit is contained in:
Tianyi Cui
2026-06-11 10:55:05 +08:00
parent 53d1ef4a74
commit cacfae3cae
3 changed files with 401 additions and 2 deletions

View File

@@ -8,4 +8,12 @@ Monorepo for the DeepSeek Harness group.
## Development
This monorepo is built on the [Cordis](https://github.com/cordiverse/cordis) framework. See [AGENTS.md](AGENTS.md) for codebase conventions and agent instructions.
This monorepo is built on the [Cordis](https://github.com/cordiverse/cordis) framework (vendored as source under `vendor/`), microkernel-style: everything is a plugin.
```sh
yarn install
yarn test # vitest
yarn demo # runnable echo-agent example
```
See [AGENTS.md](AGENTS.md) for layout, commands, and conventions, and [docs/architecture.md](docs/architecture.md) for the design.