kevinveenbirkenbach/skills
1
0 Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity

docs(agents): make AGENTS.md the only instruction file and require platform-agnostic work

Browse Source 
Adds AGENTS.md with the binding rule that skills, scripts, hooks and installs work on every agent runtime (Claude Code, Codex, Gemini CLI, Hermes, OpenClaw) and every OS: logic in scripts, runtime hooks as thin adapters, cross-runtime install locations, no single package manager. Claude Code reads AGENTS.md natively since v2.1.277, so no CLAUDE.md or GEMINI.md exists; kvb-agent-optimize now flags CLAUDE.md, .claude/CLAUDE.md, CLAUDE.local.md and GEMINI.md as drift to fold into AGENTS.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Kevin Veen-BirkenbachandClaude Opus 5.5 committed 2026-11-04 17:07:24 +01:00
1 parent ca98ab4a30
commit bd73b197b2
4 files changed
+54 -14
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

tests/test_agent_optimize.py
+8 -3
View File
@@ -1,4 +1,4 @@
"""Exercise agents.py: instruction pointers, dead links, index pointer, binary and snapshot state."""
"""Exercise agents.py: runtime-specific files, dead links, index pointer, binary and snapshot state."""
from __future__ import annotations
@@ -48,6 +48,9 @@ class TestAgents(unittest.TestCase):
)
(repo / "CLAUDE.md").write_text("@AGENTS.md\n", encoding="utf-8")
(repo / "GEMINI.md").write_text("own rules\n", encoding="utf-8")
(repo / ".claude").mkdir()
(repo / ".claude" / "CLAUDE.md").write_text("x\n", encoding="utf-8")
(repo / "CLAUDE.local.md").write_text("x\n", encoding="utf-8")
(repo / ".codebase-memory").mkdir()
(repo / ".codebase-memory" / "graph.db.zst").write_bytes(b"x")
(repo / ".gitignore").write_text(".codebase-memory/\n", encoding="utf-8")
@@ -59,8 +62,10 @@ class TestAgents(unittest.TestCase):
self._report(repo),
{
"AGENTS.md": ("ok", "single source of the agent instructions"),
"CLAUDE.md": ("ok", "points to AGENTS.md"),
"GEMINI.md": ("drift", "does not point to AGENTS.md"),
"CLAUDE.md": ("drift", "runtime-specific; fold into AGENTS.md and remove"),
".claude/CLAUDE.md": ("drift", "runtime-specific; fold into AGENTS.md and remove"),
"CLAUDE.local.md": ("drift", "runtime-specific; fold into AGENTS.md and remove"),
"GEMINI.md": ("drift", "runtime-specific; fold into AGENTS.md and remove"),
"links": ("drift", "docs/b.md"),
"index-pointer": ("ok", "AGENTS.md names codebase-memory-mcp"),
"index-binary": ("ok", "codebase-memory-mcp on PATH"),