From 43724b9f186f408ac70e0498c8378c4c9edf42e3 Mon Sep 17 00:00:00 2001 From: Ragnor Comerford Date: Tue, 28 Apr 2026 23:39:09 +0200 Subject: [PATCH] Make docs/invariants.md required reading every session MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds a top-of-file directive plus a Claude-Code @-import so the full invariants document is loaded into context on every turn, not only when an agent follows a pointer. Other agents are instructed to open it explicitly at session start. The §IX deny-list and §X review checklist apply to every change, so they should be in scope by default rather than gated on the agent remembering to look. Co-Authored-By: Claude Opus 4.7 --- AGENTS.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 6410a43..c5e4766 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,6 +2,10 @@ This file is the always-on map for AI coding agents (Claude Code, Codex, Cursor, Cline) working in this repo. It is loaded into context on every turn, so it stays as a **map plus the rules and invariants that need to be in scope at all times** — the encyclopedia content lives under [`docs/`](docs/). When you need depth, follow a pointer. +> **Required reading every session: [docs/invariants.md](docs/invariants.md).** Load this in full before proposing, reviewing, or implementing any change — the §IX deny-list and §X review checklist apply to every PR, not only architecture work. Tools that support `@`-imports (Claude Code) auto-include it via the import below; other agents must open it explicitly at the start of each session. +> +> @docs/invariants.md + `CLAUDE.md` is a symlink to this file — there is exactly one source of truth. Edit `AGENTS.md`. **Version surveyed:** 0.3.1