Pre-Flight Check

To check your project environment before initializing a git repository, run a pre-flight validation to ensure the working directory is not your home folder and detect any conflicting untracked files.

Validating your working directory before project initialization prevents accidental overwrites and avoids polluting your home folder with project files when a local Git repository does not yet exist.

If environment validation fails during project setup, the process aborts immediately and exits with clear error messages, providing guidance to resolve issues like being in the home directory or having untracked content.

You run environment validation at the start of every session, specifically after computer-setup and before repo-setup, to enforce the required execution order and ensure a clean workspace.

You cannot initialize a new project safely if pre-existing untracked files are detected in a directory without a local Git repository, as the pre-flight check will flag this conflict and abort the setup.

Yes, the pre-flight check stops the setup if you are working from your home folder, enforcing guardrails by aborting the process with clear errors to prevent accidental file overwrites.