Update AGENTS.md

Amolith created

Change summary

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

Detailed changes

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