17.1 Repository Initialisation

Go To Top

Return to Git and Review Workflow

The team should initialize the Phase 0 Repository in a controlled way. Repository initialization should create the approved directory structure, Baseline files, ignore rules, documentation entry points, script locations, Configuration locations, placeholder directories, and other resources needed for the Phase 0 Baseline.

Repository initialization should include:

1. Repository root identification.
2. Approved top-level directory structure.
3. .gitignore file.
4. README.md file.
5. Initial documentation locations.
6. Script directories.
7. IDL source directory.
8. Generated Artifact directory.
9. Configuration directory.
10. Test directory.
11. Evidence and log locations.
12. Container definition locations.
13. Checklist instance locations, where applicable.

The prepareGitRepository.sh script may support Repository initialization, but it should not hide the Repository rules. The handbook, README, and Repository documentation should explain the intended structure.

The Repository should avoid empty directories that Git cannot track unless the team adds controlled marker files, such as .gitkeep, with a documented reason. The team should not use marker files as substitutes for real content once the relevant directory has governed Artifacts.