agent-rules

A small, multi-tool AI-primitive arsenal — your methodology (AGENTS.md) plus a handful of cross-cutting skills, written once and wired into Claude Code, Copilot, Codex, and Cursor. (Machine state — dotfiles, shell/git config — lives in a separate chezmoi-managed repo, not here.)

▶ Use agent-rules in another repo or chat — do this

1. Add it as a companion: add_repo dougbreden/agent-rules (or add the repo to the chat).
2. Point the target repo at it — one line in its CLAUDE.md:

   Follow dougbreden/agent-rules AGENTS.md.

That's the whole integration — live, no copies, no drift. For your local machine, bash bootstrap.sh links the payload into every session automatically. There is no fleet registry, no scaffolder, no sync tool: the repo is the source; add_repo is how you reach it.

Small and sharp on purpose: the methodology core + ~5–10 genuinely cross-cutting skills. Everything project-bound, content, data, or machine-config carves out elsewhere. The name says it: portable rules for AI agents — one AGENTS.md, a few skills, wired into every tool.

• Why / principles → docs/brief.md
• Structure & rules → docs/ARCHITECTURE.md
• What's built / next → ROADMAP.md
• Working rules (source of truth) → AGENTS.md

Layout

AGENTS.md                                        # source of truth (shared payload)
skills/ agents/ commands/ mcp/ output-styles/    # portable payload — write once
tools/{claude,copilot,codex,cursor}/             # thin per-tool adapters (wiring only)
hooks/  bench/                                    # hook scripts; eval/trigger-rate harness
docs/{brief,ARCHITECTURE,ROADMAP}.md  plans/  decisions/
bootstrap.sh

One payload, many adapters: capability is written once and fanned out to each tool's config by bootstrap.sh; per-tool glue lives in tools/<name>/. Machine state is not here — it's in a separate chezmoi-managed repo; agent-rules owns each tool's AI config, that repo owns the rest of $HOME.

Status

• ✅ commit skill — Conventional Commits with a deterministic validator (in daily use).
• ✅ Reimagined small, multi-tool layout — methodology core + payload/adapter structure.
• ⬜ Multi-tool bootstrap.sh, cross-cutting skill migration (deslop / pressure-test / llm-profiler), the harvest/bench metabolism, safety hooks, marketplace — see ROADMAP.md.

License

Not yet licensed (all rights reserved by default). Any vendored third-party material carries its own notices.