examples/AGENTS.md

# AGENTS.md — Examples

Runnable harness compositions. **Examples are not workspaces:** private package stubs are not built. App bins load each `cordis.yml` through `tsx`; package names resolve through root `tsconfig.json` paths, not `node_modules`.

Keep wiring, demo fixtures, and e2e/snapshot scenarios here. Move reusable logic into `packages/`, with coverage and a README. App bins own bootstrapping; examples have no `start.ts`.

## E2E smokes

Each example has both:

- **Keyless:** boot the real `cordis.yml` through the Loader, drive it, and assert output and clean exit. Catches Loader/export-shape failures hand-mounted tests miss ([postmortem](../docs/postmortem/0001-acp-default-export-drops-inject.md)).
- **With-key:** send a live-model prompt and verify external state, not the model's claim. Self-skip without `DEEPSEEK_API_KEY`; see [testing.md](../docs/testing.md).

Mock-only examples require only the keyless tier; state that exception in the test.

Temp-cwd keyless smokes set `TSX_TSCONFIG_PATH` to the root tsconfig and pass `--expose-internals` when loading HMR.

Do not inventory example tests here; the `tests/` trees and root scripts are authoritative.

In `cordis.yml`, comment only non-obvious wiring, load-order consequences, replay, security boundaries, and configuration scope. Do not narrate visible entries; use [dsh-prose-standard](../.agents/skills/dsh-prose-standard/SKILL.md) for required coverage and editorial judgment.

See [the root AGENTS.md](../AGENTS.md) for repo-wide conventions and [docs/architecture.md](../docs/architecture.md) for the design.
refactor(examples): extract reusable logic into tested packages 2026-06-19 12:42:28 +08:00			`# AGENTS.md — Examples`

docs: rebalance prose cleanup and add trimming skill 2026-07-13 23:27:00 +08:00			Runnable harness compositions. Examples are not workspaces: private package stubs are not built. App bins load each `cordis.yml` through `tsx`; package names resolve through root `tsconfig.json` paths, not `node_modules`.
refactor(examples): extract reusable logic into tested packages 2026-06-19 12:42:28 +08:00
docs: rebalance prose cleanup and add trimming skill 2026-07-13 23:27:00 +08:00			Keep wiring, demo fixtures, and e2e/snapshot scenarios here. Move reusable logic into `packages/`, with coverage and a README. App bins own bootstrapping; examples have no `start.ts`.
refactor(examples): extract reusable logic into tested packages 2026-06-19 12:42:28 +08:00
docs: rebalance prose cleanup and add trimming skill 2026-07-13 23:27:00 +08:00			`## E2E smokes`
refactor(examples): extract reusable logic into tested packages 2026-06-19 12:42:28 +08:00
docs: rebalance prose cleanup and add trimming skill 2026-07-13 23:27:00 +08:00			`Each example has both:`
refactor(examples): extract reusable logic into tested packages 2026-06-19 12:42:28 +08:00
docs: rebalance prose cleanup and add trimming skill 2026-07-13 23:27:00 +08:00			- Keyless: boot the real `cordis.yml` through the Loader, drive it, and assert output and clean exit. Catches Loader/export-shape failures hand-mounted tests miss ([postmortem](../docs/postmortem/0001-acp-default-export-drops-inject.md)).
docs: trim generated prose 2026-07-12 03:36:43 +08:00			- With-key: send a live-model prompt and verify external state, not the model's claim. Self-skip without `DEEPSEEK_API_KEY`; see [testing.md](../docs/testing.md).
refactor(examples): extract reusable logic into tested packages 2026-06-19 12:42:28 +08:00
docs: rebalance prose cleanup and add trimming skill 2026-07-13 23:27:00 +08:00			`Mock-only examples require only the keyless tier; state that exception in the test.`
refactor(examples): extract reusable logic into tested packages 2026-06-19 12:42:28 +08:00
docs: rebalance prose cleanup and add trimming skill 2026-07-13 23:27:00 +08:00			Temp-cwd keyless smokes set `TSX_TSCONFIG_PATH` to the root tsconfig and pass `--expose-internals` when loading HMR.
refactor(examples): extract reusable logic into tested packages 2026-06-19 12:42:28 +08:00
docs: rebalance prose cleanup and add trimming skill 2026-07-13 23:27:00 +08:00			Do not inventory example tests here; the `tests/` trees and root scripts are authoritative.

Merge remote-tracking branch 'origin/master' into codex/trim-ai-prose 2026-07-14 00:40:36 +08:00			In `cordis.yml`, comment only non-obvious wiring, load-order consequences, replay, security boundaries, and configuration scope. Do not narrate visible entries; use [dsh-prose-standard](../.agents/skills/dsh-prose-standard/SKILL.md) for required coverage and editorial judgment.
refactor(examples): extract reusable logic into tested packages 2026-06-19 12:42:28 +08:00
			`See [the root AGENTS.md](../AGENTS.md) for repo-wide conventions and [docs/architecture.md](../docs/architecture.md) for the design.`