From 59ebd75b46994a99b9b74935ae38bdf7ab0d8e90 Mon Sep 17 00:00:00 2001
From: iris <2+iris@noreply.localhost>
Date: Sun, 13 Sep 2026 15:54:00 -0400
Subject: [PATCH] Route general lessons to the code-lessons skill

The routing note under "Things that have bitten" pointed at
~/.claude/TOOLCHAIN.md, which no longer exists -- its contents were folded
into the this-machine-* skills. Name the destinations that do exist, and add
the third case: a lesson that would bite any project anywhere now has a home
in the code-lessons skill rather than defaulting back to here.
---
 AGENTS.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 8c503a1..c3d0701 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -313,8 +313,10 @@ written, and the fold uses that same predicate to decide a reply is settled.
   which kind. Never delete a variant instead of retiring it; `Event::TaskNote`
   is what retiring looks like, and the phone folds it to no row.
 
-Project-specific only — a lesson that would bite any project on this machine
-belongs in `~/.claude/TOOLCHAIN.md` or `~/.claude/MACHINE.md` instead.
+Project-specific only. A lesson that would bite any project on this machine
+belongs in `~/.claude/MACHINE.md` or the `this-machine-*` skill for its
+subject; one that would bite any project anywhere belongs in the
+`code-lessons` skill, under the admission test at its end.
 
 - **tracing caches callsite interest process-wide.** A test that hits a
   `tracing::warn!` with no subscriber installed can poison the interest cache