diff options
| author | Craig Jennings <c@cjennings.net> | 2026-07-13 16:06:13 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-07-13 16:06:13 -0500 |
| commit | 6cd3aa32b9f3b033c3890f08ab430e757696e5e3 (patch) | |
| tree | 763dcb361796935330dc7e8afa98c0e427ed2966 /claude-templates | |
| parent | 0ee94abca7dde8356709d712b2dbf735b029f2b8 (diff) | |
| download | rulesets-6cd3aa32b9f3b033c3890f08ab430e757696e5e3.tar.gz rulesets-6cd3aa32b9f3b033c3890f08ab430e757696e5e3.zip | |
feat(runtime): add the thin-pointer AGENTS.md agent entry file
claude-templates/AGENTS.md points any harness at protocols.org, the rules locations, and the /name-to-file resolution rule, and tells it to degrade per each rule's documented fallback instead of skipping gates. make install links it to ~/.codex/AGENTS.md (new CODEX_DIR stanza) and install-ai.sh seeds a project-owned copy at bootstrap, never overwriting an existing one. The rulesets root carries a tracked symlink as dogfood. Five new bats tests cover the link idiom and the seeding. This resolves the generic-instruction-file blocker from the runtime spec, and velox picks up the global link on its next session's make install.
Diffstat (limited to 'claude-templates')
| -rw-r--r-- | claude-templates/AGENTS.md | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/claude-templates/AGENTS.md b/claude-templates/AGENTS.md new file mode 100644 index 0000000..97fd001 --- /dev/null +++ b/claude-templates/AGENTS.md @@ -0,0 +1,19 @@ +# Agent Entry Point + +You are this project's agent, whichever model or harness is running you. + +1. If the project has `.ai/protocols.org`, read it now and follow all + instructions. It is the single entry point for session behavior: + startup, session logging, inbox processing, wrap-up. +2. Behavioral rules live in `.claude/rules/*.md` in the project (when + present) and `~/.claude/rules/*.md` globally. Read them; they bind + every session regardless of harness. +3. A `/name` reference in any rule or workflow (`/voice`, + `/review-code`, `/brainstorm`, ...) resolves to a file: + `~/.claude/skills/<name>/SKILL.md` or `~/.claude/commands/<name>.md`. + Read that file and follow it. If it is absent, say so and apply the + rule's documented fallback rather than skipping the gate. +4. Harness mechanics these files assume (hooks, `/clear`, popup tools) + may not exist in your harness. Degrade per each rule's own fallback + language. Never silently skip a verification or approval gate because + the tooling that enforces it is missing. |
