From 449bff97f825045577a32f1d158f1db139f44f3d Mon Sep 17 00:00:00 2001
From: Amolith <amolith@secluded.site>
Date: Fri, 5 Jun 2026 16:07:53 -0600
Subject: [PATCH] Update AGENTS.md

---
 AGENTS.md | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 7bc8ad45b751c8c99eabb314700fdea613a182ba..e09c340c02e51938166721cb78f68bc6554f22e9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,20 +1,26 @@
 # AGENTS.md
 
+This is a monorepo of Pi extensions. If `which pi` reports Pi is managed by
+`mise`, its extension docs are in `$(mise where
+npm:@earendil-works/pi-coding-agent)/lib/node_modules/@earendil-works/pi-coding-agent/docs/extensions.md`.
+
 ## Commands
 
 ```sh
-npm install              # install deps (run after cloning)
-mise run check           # fmt + lint + typecheck
-mise run fmt             # biome format
-mise run lint            # biome lint
-mise run typecheck       # tsc --noEmit across all packages
+npm install # install deps (only after cloning)
+mise run fmt
+mise run lint
+npm run typecheck --workspace packages/<package> # single package typecheck
+mise run typecheck # check all packages
+mise run check # runs fmt, lint, typecheck; fmt writes changes
+mise run release:[bump|pack|publish] <package...> <flags, args ...>
 ```
 
-## Licensing
+## Release gotchas
 
-This repo uses REUSE. Every file needs SPDX headers or a `.license` sidecar.
-Run `reuse lint` to verify. Each package has its own license — check the
-existing headers before adding files.
+- Release package selectors are resolved by `scripts/resolve-release-packages.bash`; update it when adding a package.
+- Exact-version bumps and `release:publish --otp` only work for one package at a time.
+- `release:publish` refuses prereleases with the default `latest` tag; pass a prerelease tag such as `--tag beta`.
 
 ## VCS