Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/specs/agent-doc-surfaces.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ guidance <200 lines per CLAUDE.md.
| Cline | `.clinerules` file or folder; global `~/Documents/Cline/Rules/` | Appended to system prompt; workspace wins |
| Roo Code | `~/.roo/rules/`, `.roo/rules/` (+ per-mode variants); `.roorules` fallback | Auto-loaded, workspace wins |
| Aider | `CONVENTIONS.md` | **NOT auto-read**; explicit `/read` / `--read` / `.aider.conf.yml` only |
| Agent Skills standard (agentskills.io) | `<name>/SKILL.md` folders | Metadata-first progressive disclosure. The spec defines the folder format only; `.agents/skills/` (project) + `~/.agents/skills/` (user) is the shared cross-tool DISCOVERY convention across Codex CLI (layered lookup incl. `$REPO_ROOT/.agents/skills`, `$HOME/.agents/skills`, `/etc/codex/skills`), Cursor (also `.cursor/skills/`), Gemini CLI, VS Code Copilot, Zed. Claude Code notably uses its own `~/.claude/skills/`/`.claude/skills/` paths; the harness verdict for `~/.agents/skills` is REFUTED (`docs/upstream/aihero-course.md`, harness verdict row 5); adding an `.agents` root is declined in [ADR 0042](../adr/0042-record-the-skill-interop-decisions-and-conformance-gates.md) |
| Agent Skills standard (agentskills.io) | `<name>/SKILL.md` folders | Metadata-first progressive disclosure. The spec defines the folder format only; `.agents/skills/` (project) + `~/.agents/skills/` (user) is the shared cross-tool DISCOVERY convention across Codex CLI (layered lookup incl. `$REPO_ROOT/.agents/skills`, `$HOME/.agents/skills`, `/etc/codex/skills`), Cursor (also `.cursor/skills/`), Gemini CLI, VS Code Copilot, Zed. Claude Code notably uses its own `~/.claude/skills/`/`.claude/skills/` paths; the harness verdict for `~/.agents/skills` is REFUTED (`docs/upstream/aihero-course.md`, harness verdict row 5); adding an `.agents` root is declined in [ADR 0043](../adr/0043-record-the-skill-interop-decisions-and-conformance-gates.md) |
| OpenAI Codex | AGENTS.md root + nested | Native (standard's originator) |
| Zed | `.rules` (accepts `.cursorrules`, AGENTS.md, CLAUDE.md); skills `~/.agents/skills/` | Auto-included; Rules Library → Skills in v1.4.0 |
| JetBrains Junie | `.junie/guidelines.md` | Auto-read during generation |
Expand Down Expand Up @@ -93,7 +93,7 @@ corroborate the competitor paths themselves.
search (vendor hosts egress-blocked here), so MEDIUM; the spec repo itself confirms it defines
no directory locations. Whether Claude Code reads `~/.agents/skills` is answered by harness
verdict row 5 in `docs/upstream/aihero-course.md` (REFUTED); that verdict does not cover the
project `.agents/skills/` path. Adding an `.agents` root is declined in [ADR 0042](../adr/0042-record-the-skill-interop-decisions-and-conformance-gates.md).
project `.agents/skills/` path. Adding an `.agents` root is declined in [ADR 0043](../adr/0043-record-the-skill-interop-decisions-and-conformance-gates.md).
- Fresh-context verifier catches (recorded 2026-08-17): Roo and Aider rows are single-pool
(vendor primary only, accepted on the same vendor-authority basis, now flagged); the AGENTS.md
"nearest wins" nested-precedence detail is thinly corroborated (standard's FAQ only); the
Expand Down
Loading