15.5 Generated-File Header Requirements

Go To Phase 0 Developer Handbook Requirements

The Developer Handbook must define a standard header for generated files.

The generated-file header must identify:

1. Source definition
2. Source file
3. Generator or generation process
4. Generation context or version
5. Generated output location
6. Regeneration policy
7. Manual-editing rule
8. Related IDL structure or source artifact
9. Related FX logical information structure where applicable
10. Traceability reference

Generated files must state whether developers may edit them. By default, developers must not hand-edit generated files. Manual adaptation belongs in approved hand-authored wrapper modules, helper modules, adapter modules, or other source locations defined by the handbook.

The generated-file header protects repeatability. It helps reviewers distinguish governed generated artifacts from hand-authored implementation logic.