AGENTS.md@templates ยท diff
git:20260702.700f478 to git:20261002.b2e2924
12 added, 7 removed. Audit A to A.
# Template Inventory
- `templates/claudemd.md` is the canonical source for the user-scope orchestration
- block. The omca-setup skill reads it at install time and injects it into
- `~/.claude/CLAUDE.md`. Editing it changes what future setup runs install; users
- refresh by re-running /oh-my-claudeagent:omca-setup.
+ `templates/claudemd.md` is the orchestration guidance OMCA's server delivers. The server's
+ guidance handler (`servers/hooks/guidance.ts`) reads it once per server process from
+ `CLAUDE_PLUGIN_ROOT` and adds it, with a `Session <session_id>` line, to the first prompt of
+ each session; the `SessionStart` handler for `compact` adds it again after compaction. Nothing
+ writes it into `~/.claude/CLAUDE.md`. While that file still holds a 2.x `--- omca-setup` block,
+ the server adds nothing, so the guidance never arrives twice.
- The always-on per-turn discipline lives separately in `output-styles/omca-default.md`
- as a first-class platform output style; the template carries the operational
- guidance (entrypoints, agent catalog, workflow, cross-cutting policy).
+ Editing the template changes what every session receives on its next server start. Keep the
+ text free of anything that varies per session, so the first request's prompt cache stays warm.
+
+ The always-on per-turn discipline lives separately in `output-styles/omca-default.md` as a
+ platform output style; the template carries the operational guidance (entrypoints, agent
+ catalog, workflow, cross-cutting policy).