From efeac88a4931e9cfeb0484f0293745a5cf497560 Mon Sep 17 00:00:00 2001 From: Stephan D Date: Mon, 2 Nov 2026 16:07:39 +0100 Subject: [PATCH 1/2] docs: require schema code generation at build time --- AGENTS.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 03233d3..afa3637 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -13,9 +13,9 @@ - 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. +- Commit the schema source definitions, generator configuration, and reproducible + generation commands instead. Generate code from the schema source at build + time, before any dependent validation or compilation steps, including in CI. - 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 From 5a0b211d5f94d8ae8ae2abf7922a257349186a94 Mon Sep 17 00:00:00 2001 From: Stephan D Date: Mon, 2 Nov 2026 16:09:42 +0100 Subject: [PATCH 2/2] docs: generate code from externally published schemas --- AGENTS.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index afa3637..235d9f1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -13,14 +13,17 @@ - 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 schema source definitions, generator configuration, and reproducible - generation commands instead. Generate code from the schema source at build - time, before any dependent validation or compilation steps, including in CI. +- Use externally published schemas as generation inputs. Do not embed or commit + schema snapshots in the repository. Commit external schema references, + generator configuration, and reproducible generation commands instead. +- Fetch the externally published schemas and generate code at build time, before + any dependent validation or compilation steps, including in CI. - 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. +- Change schema sources in their owning project or update external schema + references and generator inputs rather than editing generated outputs. + Document the generation workflow so a clean checkout can build without + committed generated code or embedded schema snapshots. ## Local development tooling