3.0 KiB
Agents (Neon Sprawl)
Optional personas for Cursor. Enable by @ mentioning the rule in chat or by asking explicitly (e.g. “review this as the code review agent”).
| Agent | Rule file | When to use |
|---|---|---|
| Code review | .cursor/rules/code-review-agent.md |
PR / diff / pre-merge review; always writes docs/reviews/YYYY-MM-DD-{slug}.md with Documentation checked vs docs/plans/ and docs/decomposition/modules/; when suggestions are fixed, strike through those bullets + Done. in that file (planning-implementation-docs); short chat pointer |
| Docs review | .cursor/rules/docs-review-agent.md |
Coherence / links / dev-guide fitness for docs/ (especially docs/game-design/ + decomposition); writes docs/reviews/YYYY-MM-DD-{slug}.md; when suggestions are fixed, strike through + Done. in that file (planning-implementation-docs); use when working in documents or @ mention |
Project-wide conventions live under .cursor/rules/ (many are alwaysApply). Planning / implementation decisions must be written into docs/plans/ (and related docs)—.cursor/rules/planning-implementation-docs.md. Manual QA checklists for user-visible ticketed work are generated during implementation at docs/manual-qa/{KEY}.md (same rule). Godot client layout (thin main.gd, split by concern): .cursor/rules/godot-client-script-organization.md. Git: agents may commit at discretion on story/ticket work; never git push unless the user asks — .cursor/rules/commit-and-review.md. Open PR: when the user asks, use the GitHub MCP create_pull_request tool (user-github) with a title starting NEO-123: (commit-and-review); do not use gh CLI for GitHub operations in this repo. Story lifecycle: kickoff .cursor/rules/story-kickoff.md; after merge / end of story — checkout main, pull, delete local story branch — .cursor/rules/story-end.md. Linear: on end story, use AskQuestion multiple choice for In Test / Done / Skip when Agent mode supports it (story-end §4a); otherwise ask in prose. Wait for the choice (or the same message naming the state) before save_issue; do not guess. PR / push text: no “Made-with: Cursor” boilerplate (same file).
Commits tied to a Linear issue must start the subject with the issue id and a colon (e.g. NEO-8: …). Branch naming and exceptions (chore: when there is no ticket) — .cursor/rules/linear-git-naming.md.