docs: make AGENTS.md the only agent guide, restructured into five sections

AGENTS.md now holds the instructions and CLAUDE.md and GEMINI.md are
pointers to it. Three files of instructions become three files that
disagree; one file every agent reads cannot.

The content is reorganised rather than rewritten, into: the invariants,
the guards that fail the build, the validation this codebase deliberately
does not perform, the environment, and where to read next. Every guard
now names the test that catches it, and the two rules with no test behind
them are called out as such, because "only review catches this" is
information the reader needs.

Restructuring surfaced one rule that was missing here entirely — sw.js
must stay unhashed and be served no-cache — which had only ever been
written down in ARCHITECTURE.md.

Dropped: the `bun init` boilerplate code samples. Every rule they carried
is still stated; the hello-world test and the three frontend snippets are
not.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

src/cssPairs.test.ts

@@ -1,7 +1,7 @@
 import { test, expect, describe } from "bun:test";
 
 /**
- * CLAUDE.md's hardest-won rule, made mechanical.
+ * AGENTS.md's hardest-won rule, made mechanical.
  *
  * shadcn uses several tokens as a BACKGROUND with a paired FOREGROUND for the
  * text on it. Redefining one without the other repaints the background and

src/domain/types.ts

@@ -33,7 +33,7 @@ export const SEED_CURRENCIES: readonly CurrencyDef[] = [
 /** Used when a currency has no definition. Two places is right almost always. */
 export const DEFAULT_CURRENCY_DIGITS = 2;
 
-/** A float amount paired with its currency. See CLAUDE.md for rounding rules. */
+/** A float amount paired with its currency. See AGENTS.md for rounding rules. */
 export interface Money {
   amount: number;
   currency: Currency;

src/index.css

@@ -25,7 +25,7 @@
  *      than fighting it means every primitive (dialog, select, badge, button)
  *      inherits both themes for free.
  *
- * WHY THE PAIRS MATTER. CLAUDE.md's rule is "never define a bare `--accent`",
+ * WHY THE PAIRS MATTER. AGENTS.md's rule is "never define a bare `--accent`",
  * and it was paid for with an app-wide contrast bug: shadcn uses `--accent` as
  * a hover BACKGROUND and `--accent-foreground` as the text on it, so setting
  * one without the other repaints the background and leaves the text behind.

src/store/actions.ts

@@ -25,7 +25,7 @@ import type {
  * store.mutate(), which clones before applying and writes through afterwards.
  *
  * Every MONEY amount that flows through here is rounded to its currency's
- * minor unit (via roundMoney) before it lands in the draft, per CLAUDE.md's
+ * minor unit (via roundMoney) before it lands in the draft, per AGENTS.md's
  * "round before persisting" rule. FxRate.baseUnitsPerOne is deliberately
  * exempted in setFxRate below — an exchange rate is not money, and rounding
  * it to cents would be wrong in kind (see the comment there).

src/ui/components/RuleHistory.tsx

@@ -14,7 +14,7 @@ interface Props {
  * Shape AND range, matching the import validator. `setRuleFrom` sorts the
  * series with `compareMonths`, which THROWS on a malformed MonthId; useMutate
  * would catch it and show an error, but a disabled button is the better
- * answer, and CLAUDE.md requires guarding a throwing domain call at the site
+ * answer, and AGENTS.md requires guarding a throwing domain call at the site
  * that invokes it from a handler.
  */
 const MONTH_ID = /^\d{4}-(0[1-9]|1[0-2])$/;