geointel/docs/18-ultra-prep/REPO_HYGIENE_RULES.md

Repo Hygiene Rules

Do Commit

• source code;
• documentation;
• small fixtures;
• config examples;
• migration files;
• test data under size limits.

Do Not Commit

• .env with secrets;
• large rasters;
• model weights;
• generated cache;
• local database volumes;
• node_modules;
• Python virtualenvs;
• personal paths.

Naming

• backend modules use snake_case;
• frontend components use PascalCase;
• docs use uppercase topic names or numbered folders;
• fixtures describe region and purpose.

Generated Outputs

Generated exports should go under exports/ and be gitignored unless they are tiny documented sample fixtures.