AGENTS.md

1# Language
2 
3- All user-facing CLI output, prompts, help text, warnings, and error messages must be written in English only.
4 
5# Validation
6 
7After modifying any `.zig` file, always run `zig build run -- list` to verify the changes work correctly.
8 
9# Release Process
10 
11- When updating and pushing a release version, always follow [docs/release.md](./docs/release.md).
12 
13# Docs
14 
15- Do not add low-level technical implementation details to `README.md`. Put implementation-specific behavior in `docs/*.md` or `AGENTS.md` instead.
16 
17# Zig API Discovery
18 
19- Do not guess Zig APIs from memory or from examples targeting other Zig versions.
20- Before using or changing a Zig API, run `zig env` and `zig version` to confirm the local toolchain and source layout.
21- Use the paths reported by `zig env` as the source of truth, especially `std_dir` for the standard library and `lib_dir` for other bundled Zig libraries.
22- Prefer evidence from local sources: symbol definitions, nearby tests, and existing call sites in this repository.
23- If the needed behavior is not clear from `std_dir`, inspect other Zig sources and tests under the local `lib_dir` tree as needed.
24