diff options
| author | sommerfeld <sommerfeld@sommerfeld.dev> | 2026-09-26 22:23:04 +0100 |
|---|---|---|
| committer | sommerfeld <sommerfeld@sommerfeld.dev> | 2026-09-26 22:23:04 +0100 |
| commit | 78a74ad7b930b2136dbb4b77a0ed545141b4ad2e (patch) | |
| tree | 980d736b0a7d118d314a1d6edfd628592aa495b1 /docs/ai-instructions.md | |
| parent | b613ae6e9eb764b1b29b3e383644d494e9604e00 (diff) | |
| download | dotfiles-78a74ad7b930b2136dbb4b77a0ed545141b4ad2e.tar.gz dotfiles-78a74ad7b930b2136dbb4b77a0ed545141b4ad2e.tar.bz2 dotfiles-78a74ad7b930b2136dbb4b77a0ed545141b4ad2e.zip | |
Refresh shared agent policy and delegation roles
Diffstat (limited to 'docs/ai-instructions.md')
| -rw-r--r-- | docs/ai-instructions.md | 32 |
1 files changed, 32 insertions, 0 deletions
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). |