docs: rebalance prose cleanup and add trimming skill

packages/ui/acp-agent/src/bin.ts

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 /**
- * The `dsh-acp-agent` bin: boot the ACP server from a leaf `cordis.yml` that loads the {@link
- * @deepseek-ai/dsh-acp-agent} app plugin (plus an LLM adapter and a bash executor), speaking
- * ACP JSON-RPC on stdio.
+ * Boot an ACP stdio server from `cordis.yml`; usage is `dsh-acp-agent [config]`, defaulting to the
+ * cwd file. Shared env loading, Loader guards, snapshot config selection, and settled-tree boot live
+ * in dsh-app-boot. Replay skips `.env` and selects sibling `cordis.snapshot.yml` so a stray key
+ * cannot trigger a model call. EOF disposes and flushes snapshot runs; editors normally own process
+ * lifetime. Stdout is reserved for JSON-RPC—write diagnostics only to stderr.
  * @module @deepseek-ai/dsh-acp-agent/bin
  */
 

packages/ui/acp-agent/src/index.ts

@@ -2,6 +2,10 @@
  * The ACP server app: the default agent spine ({@link @deepseek-ai/dsh-agent-core}) plus the
  * coupled front-door cluster an ACP server needs — JSONL session persistence and the {@link
  * @deepseek-ai/dsh-acp} bridge, and deliberately NOTHING that writes to stdout.
+ * It pre-creates no agents and leaves adapters, executors, and optional tools to
+ * the leaf, which must likewise avoid stdout loggers. Named exports are
+ * required so Loader retains this plugin's `Config` schema (see
+ * docs/postmortem/0001).
  * @module @deepseek-ai/dsh-acp-agent
  */