From b6039493c92fc753ebfd2faa8c1568bfe928301f Mon Sep 17 00:00:00 2001 From: Stephan D Date: Sat, 12 Sep 2026 19:45:07 +0200 Subject: [PATCH] docs: prohibit committing autogenerated code --- AGENTS.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 7dc5675..a2f2a0e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -8,6 +8,20 @@ - For cross-module work, apply every relevant scoped instruction file and completion workflow. +## Autogenerated code + +- Never commit autogenerated code to the repository. This applies to backend, + frontend, shared packages, and every other module, including generated + protobuf bindings, API clients, serializers, and framework-generated code. +- Commit the source definitions, generator configuration, and reproducible + generation commands instead. Generate code locally or during build and CI + workflows before any dependent validation or compilation steps. +- Keep generated outputs ignored by Git. Do not force-add ignored generated + files or copy generated code into tracked source files. +- Change the source definitions or generator inputs rather than editing + generated outputs. Document the generation workflow so a clean checkout can + build without committed generated code. + ## Data and state architecture Preserve explicit **DTO → mapper → service → data model → provider → UI**