CaptainsWorld Brain (repo copy)¶

Internal product brain published to https://brain.captainsworld.co.uk (private subdomain).

Source of truth flow¶

Cursor publishes → Obsidian vault (local read mirror)
        ↓
npm run brain:publish
        ↓
docs/brain/ (this folder — git + web build)
        ↓
git push → GitHub Actions → Cloudflare Pages

Commands¶

Command	What it does
`npm run brain:publish`	Copy vault → `docs/brain/`, convert wikilinks
`npm run brain:build`	Build static site to `sites/brain/dist/`
`npm run brain:preview`	Local preview at http://127.0.0.1:8000

Vault path¶

Default: %USERPROFILE%\Documents\CaptainsWorld-Brain\CaptainsWorld.app\CaptainsWorld

Override with CAPTAINSWORLD_BRAIN_VAULT_PATH in .env.local or your shell.

Do not edit here for Obsidian¶

Edit in the vault (via Cursor publish) or promote from /docs formal specs. This folder is regenerated by brain:publish except README.md and .pages.

Setup guide: see sites/brain/README.md in the repository (Cloudflare Pages + Access).