This file defines AI assistant guidance for this repository.
Canonical skills live under:
agents/skills/
For tools that expect .agents/skills/, use a local symlink:
ln -s agents .agents- OpenAI Codex: prefers
.agents/skills/ - Claude Code: often uses
.claude/skills/ - Other tools (Cursor/Copilot/etc.): may use
.agents/skills/or tool-specific paths
Recommended local setup:
# Canonical -> tool-expected path
ln -s agents .agents
# Claude path to shared skills
mkdir -p .claude
ln -s ../.agents/skills .claude/skills/.agents/ is ignored in git to keep local tool wiring out of commits.
- Follow repository docs and tests as source of truth.
- Keep edits minimal and verifiable.
- Run relevant lint/tests for touched areas.