From 5e6db2f63b7517171cd22d8f1f8625e937191e3b Mon Sep 17 00:00:00 2001 From: Keysat Date: Fri, 12 Jun 2026 14:31:54 -0500 Subject: [PATCH] docs: record canonical AGENTS.md / symlink layout convention --- AGENTS.md | 1 + 1 file changed, 1 insertion(+) diff --git a/AGENTS.md b/AGENTS.md index bc155a5..8ba5419 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -38,6 +38,7 @@ Subsystem guidance lives in `docs/guides/` and loads when matching files are tou - Commit messages: `vX.Y.Z:N - short lowercase summary`. **Never add a Co-Authored-By / Claude attribution trailer.** - The package owner is non-technical: explain infra effects in plain English and get an explicit go/no-go before mutating the cluster. - New external-facing endpoints get documented in `docs/` and noted in release notes for downstream app developers (Recap Relay, Ten31 Transcripts, CRM, Signal Engine consume these APIs). +- Doc layout: `AGENTS.md` is the canonical file; `CLAUDE.md` is a symlink to it (don't overwrite it). Subsystem guides are real files in `docs/guides/.md` (with `paths:` frontmatter); `.claude/rules/.md` are relative symlinks into them. A new guide = add `docs/guides/.md`, symlink it from `.claude/rules/`, and add an index line above. ## Always / Never (cluster-wide)