Instruction file imported from MakingThingsWorkToronto/visual-brainstorm (
.cursor/rules/visual-brainstorm.mdc). Copyright stays with the author.
Visual Brainstorm — Cursor harness
You are working in the Visual Brainstorm repo. .claude/ is the behavioral SSOT; .cursor/ is a thin adapter.
Bootstrap (every session)
- Read
CLAUDE.md§Session bootstrap and its quick map. - Ground on the wiki via
visual-brainstorm-wikiMCP:wiki_search→wiki_outline→wiki_read. - Load the skill for your task from
.claude/skills/(brainstorming →brainstorm-phases+svg-authoringVALIDITY-SCAN). - Check open plans in
discussion/(not_completed/). - Read
.agents/learnings.mdfor hard-won gotchas.
Slash commands
Type / in Agent chat to run workspace commands in .cursor/commands/. Each command wraps the authoritative .claude/commands/<name>.md procedure. Do not paraphrase — read and follow the source file.
| Command | Subagent | Purpose |
|---|---|---|
| run-brainstorm | brainstorm-orchestrator | Full visual brainstorm session |
| plan-closeout | brainstorm-orchestrator | Close plan, harvest learnings, update wiki |
| diagnose-studio | devops-diagnostician | Evidence-first studio/bridge/MCP diagnosis |
| build-check | test-engineer | npm run build + npm test verification |
| artifact-chat | brainstorm-orchestrator | Artifact questions and revisions |
| wiki-maintenance | wiki-librarian | Cross-plan wiki lint/reconcile |
MCP tools (visual-brainstorm)
Drive real workflows with these tools — never fake success:
open_studio— New Discussion panel (brief handoff)ask_concierge— adaptive intake questionspresent_gallery— Living Gallery method pickpresent_board— SVG option surveycapture_artifact/reply_artifact_chat— artifact provenancelist_discussions/load_discussion— resume threadssession_status/peek_response— health and pending responses
Delegation (rule 11)
- Brainstorm orchestration → brainstorm-orchestrator subagent (never re-delegate)
- SVG generation → svg-artisan subagent
- Diagnosis → devops-diagnostician subagent
- Tests → test-engineer subagent
- Wiki edits → wiki-librarian subagent (append
wiki/log.mdper edit, thenwiki_reload)
Proof before claim
npm run build + npm test before any completion claim on repo changes.