From 862084b4836de855cb30b8ad3c39271a25abb3c8 Mon Sep 17 00:00:00 2001 From: Brett Date: Thu, 4 Jun 2026 12:45:52 -0500 Subject: [PATCH] docs(agents): surface docs/solutions/ corpus in AGENTS.md AGENTS.md is the canonical instruction file for this repo per the global "see AGENTS.md; use CLAUDE.md only if the repo still keeps a compatibility shim" rule, but the docs/solutions/ knowledge-store mention only lived in CLAUDE.md. An agent reading only AGENTS.md (cross-tool collaborators, fresh sessions, the gh CLI's view of the repo) would not discover that documented solutions to past problems are searchable via `qmd query "" --collection solutions`. Add a small `## Documented Solutions` section after `External signal / research` mirroring CLAUDE.md's existing block. Five lines; informational voice, not imperative; no duplication of CLAUDE.md content. Surfaced by /ce-compound's Discoverability Check during the worktree-isolation stale-base learning doc. --- AGENTS.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index a148d88..89f93df 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -236,3 +236,10 @@ folder: When an extract names concrete linter-rule candidates, walk its **"Linter rule coverage audit"** or equivalent section against existing audits in `src/audits/` before opening a new audit. + +## Documented Solutions + +`docs/solutions/` (symlink to `~/dev/solutions-docs/`) is a searchable archive of documented solutions to past problems +(bugs, best practices, workflow patterns), organized by category with YAML frontmatter (`module`, `tags`, +`problem_type`). Search with `qmd query "" --collection solutions`. Relevant when implementing or debugging in +documented areas.