Cursor Workflow

Source: Captainswords.app/docs/KNOWLEDGE_MANAGEMENT_STRATEGY.md · .cursor/rules/project-rules.mdc

---

How Cursor agents work on CaptainsWorld.

Source of truth

• Code + /docs in Captainswords.app repo
• Phase gates in project rules — no scope creep on unvalidated phases

Agent flow

1. Read relevant /docs before decisions
2. Implement in minimal diff
3. Learning logic stays in /lib/learning-engine and /lib/numbers-engine
4. Publish summaries to the Obsidian vault on request

CaptainsWorld Brain pipeline

Cursor publishes → Obsidian vault (local read mirror)
        ↓
npm run brain:publish  →  docs/brain/ in repo
        ↓
git push  →  brain.captainsworld.co.uk (Cloudflare Pages + Access)

Command	Purpose
npm run brain:publish	Vault → docs/brain/
npm run brain:build	Build static site locally
npm run brain:preview	Preview at http://127.0.0.1:8000
npm run brain:sync	Publish + build

Decision flow

ChatGPT (strategy) → decision journal → promote to DECISIONS.md / ADRs → Cursor implements

---

Related

• 00 Index · MVP Roadmap · 2026-06-30 Visual Engine and Mission Architecture