Reference Git installation guide from README

README.md

@@ -41,6 +41,8 @@ npm start
 
 ## Install from an immutable Git revision
 
+For a visual end-to-end explanation, see the [Git-based npm installation guide](docs/git-based-npm-install.html). It documents why the repository commits the prebuilt runtime, how npm turns an immutable Git revision into a real global package, what the isolated verifier proves, and the complete release, upgrade, rollback, removal, and troubleshooting workflows. The guide is repository documentation for operators and maintainers; it is intentionally excluded from the installed npm payload.
+
 The canonical repository is `https://git.bodicsek.host/bodicsek/codex-chief-of-staff.git`. Git access and any required trust or authentication configuration are host prerequisites; keep credentials out of package URLs and command output. Preflight the exact release tag before installation:
 
 ```sh