# Editor Integration

AO works with any editor that supports agent instruction files.

| Editor | Primary file | Path-scoped |
|--------|-------------|-------------|
| VS Code Copilot | AGENTS.md, copilot-instructions.md | .github/instructions/*.md |
| Claude Code | CLAUDE.md | .claude/rules/*.md |
| Cursor | .cursorrules | — |
| Windsurf | .windsurfrules | — |
| OpenCode | AGENTS.md | — |

All editors read `.agent/ops/constitution.md` via agent instructions.

## Shared conventions

- Keep top-level instruction files small (≤200 lines)
- Extract project-specific detail to `.agent/ops/references/`
- Use `.ao/references/` for framework-agnostic guidance
