AGENTS.md · git:20261024.8456bc0 · 2026-10-24 · sha256 a06617b500aafb8c
AGENTS.md git:20261024.8456bc0A
Immutable. This exact content never changes and is served at /api/v1/blob/a06617b500aafb8c.
# developer-os This repository is a Markdown-only Claude Code plugin: core rules, skills, agents and Python 3 hooks under `plugin/`, copyable project templates under `templates/`. No runtime and no build; see [README.md](README.md). `CLAUDE.md` only imports this file, so this file is the authoritative source for every agent. ## Commands - `bash scripts/check.sh`: the whole check, before every commit and in CI. - `sh tests/check.test.sh`: after changing `scripts/check.sh` (the check runs it only in CI). - `claude --plugin-dir plugin`: run the plugin from the working tree. ## Likely agent mistakes here - Growing `plugin/rules/core.md` past 8192 bytes: it loads into every session. Evidence: D10, the Core-rules size stage. - Lengthening skill descriptions past 12000 characters in total. Evidence: D10, the Skill descriptions stage. - Making a hook deny instead of ask. Evidence: D6, `tests/guard.test.sh`. ## Invariants - D2, hook scripts in Python 3 with the standard library only and no network: Script tests stage. - D6, hooks ask, never deny, and fail open: Script tests stage (`tests/guard.test.sh`). - D9, action skills end with `## Stop point` and `## Never`: Skill sections stage. - D10, the per-session budget: Core-rules size and Skill descriptions stages. The records are in [docs/product/decisions.md](docs/product/decisions.md); the stages in [docs/development.md](docs/development.md#the-check). Backlog: docs/plans/backlog.md, docs/plans/backlog-done.md ## Documentation [docs/index.md](docs/index.md) routes a task to its doc; [docs/development.md](docs/development.md), [docs/product/decisions.md](docs/product/decisions.md), [CONTRIBUTING.md](CONTRIBUTING.md). Behavior change = docs update in the same commit; the docs-sync skill reports drift.