AGENTS.md · diff

git:20260817.0a229c6 to git:20260910.e4cb1ae

3 added, 2 removed. Audit A to A.

# Agent Toolkit Guide
A collection of reusable skills and rules for AI agents (Claude Code and similar). Everything must
be self-contained and generic — reusable in any project — so avoid project-specific logic or
assumptions. Rules are opt-in: a skill must work correctly with no rules installed, so never fix
or extend a skill by adding a rule it depends on.
- Skill test harnesses live in `test/<skill-name>/` — repo-internal, never installed; their `runs/`
- output dirs are gitignored. Planning documents go in `.agents/plans/` (gitignored).
+ Test harnesses, for a skill or an install script, live in `test/<name>/` — repo-internal, never
+ installed; their `runs/` output dirs are gitignored. Planning documents go in `.agents/plans/`
+ (gitignored).
## Docs
- [docs/authoring-conventions.md](docs/authoring-conventions.md) — read before editing any skill,
rule, doc or manifest.
- [docs/core-philosophy.md](docs/core-philosophy.md) — the five pillars and their litmus test;
read before creating or redesigning a skill, or when brainstorming toolkit direction.
- [docs/contributor-setup.md](docs/contributor-setup.md) — how this repo is wired for agents; read
when hooking a new agent up to it.