Workspace layout

Recommended repository structure:

project/
├── .agents/
│   ├── agents/
│   │   ├── reviewer.toml
│   │   ├── researcher.toml
│   │   └── implementer.toml
│   └── skills/
│       ├── rust-review/
│       │   ├── SKILL.md
│       │   └── checklist.md
│       └── release-check/
│           └── SKILL.md
├── src/
├── tests/
└── Cargo.toml

Discovery roots

Surface	Canonical root	Vendor adapter
Agents	.agents/agents/	.claude/agents/ (Markdown)
Skills	.agents/skills/	.claude/skills/

Canonical definitions take precedence on collisions.

Related

• Skills server — SKILL.md discovery details.
• Agents server — agent discovery and workspace trust.