From 78a74ad7b930b2136dbb4b77a0ed545141b4ad2e Mon Sep 17 00:00:00 2001 From: sommerfeld Date: Sat, 26 Sep 2026 22:23:04 +0100 Subject: Refresh shared agent policy and delegation roles --- docs/ai-instructions.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 docs/ai-instructions.md (limited to 'docs') diff --git a/docs/ai-instructions.md b/docs/ai-instructions.md new file mode 100644 index 0000000..3b38ef8 --- /dev/null +++ b/docs/ai-instructions.md @@ -0,0 +1,32 @@ +# Shared Agent Instructions + +The `canonical` role deploys `dot_codex/AGENTS.md` to `~/.codex/AGENTS.md`. +The other instruction files are symbolic links to that file: + +| Agent | User instruction file | +| ----------- | ------------------------------------ | +| Codex | `~/.codex/AGENTS.md` | +| Claude Code | `~/.claude/CLAUDE.md` | +| OpenCode | `~/.config/opencode/AGENTS.md` | +| Hermes | `~/.hermes/SOUL.md` | +| OMP | `~/.omp/agent/AGENTS.md` | +| Copilot CLI | `~/.copilot/copilot-instructions.md` | + +Run `just apply` on the target machine, then start new agent sessions. Edit +`dot_codex/AGENTS.md` to change the shared instructions. The root `AGENTS.md` +contains instructions for this repository and is not deployed as a user file. + +The deployment test checks the managed paths and link targets. It does not +test a live model session. Custom agent home directories, disabled instruction +loading, and project instructions can change which rules an agent receives. + +The shared policy assigns planning and integration to a strong default model, +bounded summaries and simple tasks to cheaper agents, and difficult consultations +to the strongest available model. It is an instruction policy, not a model +router. It does not change provider accounts, model settings, or spending limits. + +See the upstream guides for [Codex](https://developers.openai.com/codex/guides/agents-md/), +[Claude Code](https://code.claude.com/docs/en/memory), +[OpenCode](https://opencode.ai/docs/rules/), +[Hermes](https://hermes-agent.nousresearch.com/docs/user-guide/which-file-does-what), +and [Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions). -- cgit v1.3.1