Index: .beads/README.md
===================================================================
--- .beads/README.md	(revision 1e194e481dd18fd3624d4649c4be97df3a22cd0f)
+++ .beads/README.md	(revision 7b03c355a5d2ce0b2a47c4117ff96124402ea93a)
@@ -1,3 +1,23 @@
 # Beads - AI-Native Issue Tracking
+
+> **The beads database in this repository is retired. Do not write to it.**
+>
+> Klonkt's issues live in `~/Sources/shaer-frontend/.beads` (Dolt database
+> `shaer`). All 32 of them were migrated there on 2026-08-23 keeping their
+> original `prutfolio-src-*` ids, so `bd show prutfolio-src-7cz` works from that
+> repository and means the same issue it always did.
+>
+> Create, update and close Klonkt issues from `~/Sources/shaer-frontend`. The
+> `bd` commands below apply there, not here.
+>
+> Why: this repository has no `core.hooksPath`, so the beads hooks in
+> `.beads/hooks/` never ran. The Dolt database is gitignored and the one tracked
+> artefact, `.beads/issues.jsonl`, is only refreshed by those hooks — it had
+> drifted four days and two issues behind before anyone noticed. shaer-frontend
+> has the hooks wired, so its export stays current.
+>
+> The local database is left in place and still readable for history. Nothing
+> enforces this: it is a convention, and a `bd create` run here will succeed and
+> be lost.
 
 Welcome to Beads! This repository uses **Beads** for issue tracking - a modern, AI-native tool designed to live directly in your codebase alongside your code.