docs: rebalance prose cleanup and add trimming skill

packages/core/agent-core/README.md

@@ -2,7 +2,7 @@
 
 The **default executor-less, UI-less agent spine** as ONE Cordis bundle plugin. It loads the fixed set of services every harness agent needs, including the local skill provider, and forwards the loop's `agents` list as its own config — so an app package composes a working agent by adding only a front door and the swappable backends.
 
-This is the package to read to see **the whole plugin tree at once** — the teaching role the inlined `echo-agent` `cordis.yml` used to play before the spine moved behind this bundle.
+Read this package for the whole plugin tree and its composition order.
 
 ## The tree it loads
 

packages/core/agent-core/src/index.ts

@@ -1,5 +1,9 @@
 /**
- * The default executor-less, UI-less agent spine as one bundle plugin.
+ * Default executor-less, UI-less agent spine. It bundles the common services,
+ * concrete loop, local skill provider, and model-facing bash/skill consumers;
+ * deployments still choose the LLM adapter, bash executor, and presentation.
+ * The plugin intentionally exposes named exports only because Loader default
+ * unwrapping would discard its `Config` schema (see docs/postmortem/0001).
  * @module @deepseek-ai/dsh-agent-core
  */
 
@@ -32,10 +36,12 @@ export interface SkillConfig {
 
 /**
  * Bundle config: each field forwarded verbatim to the child that owns it — `agents` to the
- * agent loop (an app that pre-creates no agents, like the ACP bridge, simply omits it),
+ * agent loop (an app that pre-creates no agents, like the ACP bridge, omits it),
  * `persona` and `toolOrder` to the system-prompt plugin (the deployment's persona section and
  * the explicit model-facing tool order), the `tools` object to the tool registry (its
  * presentation `mode`), and `skills` to the skill registry/local provider/tool consumer.
+ * The schema intersects the owners' schemas, which supply defaults for every
+ * optional input and keep validation from drifting.
  */
 export interface Config {
   /** The agent-loop `agents` list (see dsh-agent-loop's `Config`). */

packages/core/agent-core/tests/agent-core.spec.ts

@@ -187,7 +187,8 @@ describe('dsh-agent-core bundle', () => {
   })
 
   it('has the namespace-plugin export shape (no stray default) so the Loader keeps name/Config/apply', () => {
-    // A default export would make Loader discard this namespace's plugin metadata.
+    // A default export would make `unwrapExports` collapse this inject-less namespace and silently
+    // drop `name`/`Config`. Apps import the bundle directly, so this is its Loader-shape guard.
     expect('default' in agentCore).toBe(false)
     expect(typeof agentCore.apply).toBe('function')