agents

Portable agent instructions, organized by category.

Layout

.
├── AGENTS.md           # how to work on THIS repo
├── README.md
├── install-pi.sh       # pi.dev installer
└── src/
    ├── AGENTS.md       # the index agents read
    ├── instructions/   # plain markdown, by topic
    │   └── languages/  # coding-language-specific instructions
    └── skills/         # skill directories, each with SKILL.md

Install

Only pi.dev is wired up right now. The script symlinks src/AGENTS.md, src/instructions/, and src/skills/ into ~/.pi/agent/.

./install-pi.sh                 # install / overwrite
./install-pi.sh --dry-run       # preview, no changes

Override the target dir with PI_CODING_AGENT_DIR. Rerun any time — idempotent, Linux + macOS compatible.

Note: Symlinks point at this repo's absolute path. If you move the repo, rerun install-pi.sh to refresh.

How agents use this

src/AGENTS.md is an index. Agents load only the files relevant to the current task — not the whole tree. Project-level AGENTS.md (in the repo being worked on) overrides anything here.