blob: 3b38ef8876bf9c1f75d9f88ef6f739671bbe6898 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
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).
|
