Skip to content
Merged
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
9 changes: 8 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,14 @@ AAP is a **runtime-agnostic filesystem convention**: a tiny map in the repo so a
| Path **`access`** fences + optional node **`write`** role hints (coordination only) | Security sandbox or ACL |
| Pinned templates you copy once | Something fetched every agent turn |

**AAP does not replace `AGENTS.md` / `CLAUDE.md`:** those say *how to work*; the map says *where things are*. They can live side by side.
The map is checked against **JSON Schema by a validator in CI**, so structure drift is caught by machine—not only by human review. That is a key difference from free-form orientation markdown.

### How this relates to

- **`AGENTS.md` / `CLAUDE.md`** — how to work vs where things are; orthogonal, can live side by side.
- **llms.txt-style indexes** — discovery lists of docs/URLs; AAP is a sparse layout/hop map, not a content catalog. Can coexist.
- **Repo-map style tools** — often generate or search structural overviews; AAP is a checked-in, schema-validated convention agents open first. Orthogonal.
- **Agent skills** — procedural how-to packs; AAP does not define skills and does not replace them.

---

Expand Down
Loading