sscoble/pi-mono
1
0
Fork 0
mirror of https://github.com/badlogic/pi-mono.git synced 2026-11-05 23:37:25 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

docs: scope backward compatibility rule, keep @deprecated

Browse source
This commit is contained in:
Petr Houška 2026-11-02 19:40:01 +01:00
parent 9f2a5ef19d
commit eca5436c24
1 changed files with 1 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

2
AGENTS.md
View file

@ -23,7 +23,7 @@
- Never remove or downgrade code to fix type errors from outdated deps; upgrade the dep instead.
- Use only erasable TypeScript syntax (Node strip-only mode) in code checked by the root config (`packages/*/src`, `packages/*/test`, `packages/coding-agent/examples`): no parameter properties, `enum`, `namespace`/`module`, `import =`, `export =`, or other constructs needing JS emit. Use explicit fields with constructor assignments.
- Always ask before removing functionality or code that appears intentional.
- Never break public APIs outside a major release. Keep the old form working next to the new one and mark it `// remove-in-next-major: <what and why>`. If that is not possible, ask first.
- Never break public APIs (exports, types, CLI flags, file formats) outside a major release; settings and UI may change. Keep the old form working next to the new one, mark it `// remove-in-next-major: <what and why>`, and add `/** @deprecated Use <replacement>. */` to exported symbols. If that is not possible, ask first.
- Never hardcode key checks (e.g. `matchesKey(keyData, "ctrl+x")`). Add defaults to `DEFAULT_EDITOR_KEYBINDINGS` or `DEFAULT_APP_KEYBINDINGS` so they stay configurable.
- Never modify `packages/ai/src/models.generated.ts` directly; update the catalog definitions in `packages/ai/catalog/` instead (see its README), then regenerate. Including the resulting `models.generated.ts` diff is always OK, even if regeneration includes unrelated upstream model metadata changes. The generated model data in `packages/ai/src/providers/data/` is gitignored: never stage it, and don't look for it in git history.