1  # .cursor directory
 2  
 3  Cursor agentic workflow for this repo: **plan → implement → review**.
 4  
 5  ## Layout
 6  
 7  - **plugin.json** - Manifest for Cursor (commands, skills, agents).
 8  - **rules/** - Workflow rules:
 9    - **dotfiles-cursorrules.mdc** - References project root .cursorrules; fundamental behavior and workflow.
10    - **dotfiles-core.mdc** - Default flow; commands ↔ rules ↔ skills.
11    - **dotfiles-brainstorm.mdc** - Clarify, propose, approve before plan.
12    - **dotfiles-plan.mdc** - Bite-sized tasks, exact paths.
13    - **dotfiles-debug.mdc** - 4-phase systematic debugging.
14    - **dotfiles-git.mdc** - Finish branch (verify, merge/PR/keep/discard).
15  - **.cursorrules** (repo root) - Project-wide rules; Cursor and agents respect it. Do not edit without approval.
16  - **commands/** - kickoff, brainstorm, write-plan, execute-plan, systematic-debugging, finish-branch, request-code-review.
17  - **agents/** - planner, config, taskfile, code-reviewer.
18  - **skills/** - taskfile-validate.sh, pre-commit-run.sh (executable scripts).
19  - **plans/** - Implementation plans (`YYYY-MM-DD_<username>_<slug>.plan.md`).
20  
21  ## Command → Rule → Skill
22  
23  Each command is tied to specific rules and (when relevant) skills. Full mapping: **AGENTIC_WORKFLOW.md**. Quick reference: **WORKFLOW_TRIGGERS.md**.