GitHub & Repos¶

Owner: Bryan · Org: Dalayon-Reports (all repos private).

Repo map¶

Repo / folder	What it is
`ops-manual/`	This manual. Gated at `ops.dalayon.work`.
`dalayon-docs/`	The public site at `docs.dalayon.work`. Public-safe only.
`_template/`	Canonical client template (tokens `{{CLIENT_NAME}}` etc.). Edit here to change all future clients.
`client-<slug>/`	One folder = one private repo = one client hub.
`new-client.ps1`	The scaffold generator.

Never make the workspace root itself a repo. Each site is its own repo.

Path	What it is
`docs/`	Pages (Markdown). `docs/assets/data/overview.js` = generated dashboard data. `docs/assets/js/` = dashboard scripts.
`docs/stylesheets/extra.css`	All styling.
`overrides/`	Theme HTML (header/footer).
`docs/_headers`	Cloudflare cache rules.
`tools/`	Data builders (client repos only).
`team-data/`	Raw exports, committed (client repos only).
`personal-notes/`	Gitignored. Secrets and notes. Never committed.
`site/`	Build output. Never edit by hand.

Private, always. When publishing a new repo in GitHub Desktop, tick Keep this code private. Before the first push, confirm the Changes list does not include .venv/, site/, or personal-notes/. If it does, .gitignore is not applying: stop and fix it.
Secrets go in personal-notes/, never in tracked files.
Build --strict before you commit. Zero warnings.
Push triggers deploy. Cloudflare rebuilds the affected site in about 2 minutes.

Private repos need Cloudflare Pages, not GitHub Pages. GitHub Pages will not serve a private repo for free.
"Dubious ownership" can appear in GitHub Desktop for folders created by an AI sandbox. Fix from the Windows user context:

git config --global --add safe.directory "D:/Agent Skills/Github Pages/<folder>"

PowerShell 5.1 has no &&; chain with ; and if ($?). Filenames containing [...] break Move-Item (use -LiteralPath).