dotbrain plugin
Private project context, shared across coding agents and worktrees.
How to install the dotbrain plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add arminzou/dotbrain
/plugin install dotbrain@dotbrainWhat's inside dotbrain
21 parts read from the plugin's own files.
Skills 18
Claude loads it when the task matches- brain-site
Set up, maintain, build, and preview a Brain's private site with dotbrain site, including navigation, themes, and rendering checks.
- close-design
Closes a shipped, abandoned or superseded design — checks shipment evidence, promotes durable residue, stamps frontmatter and closes the epic. Use when the human asks to close out, wrap up or finish a design.
- curate-project-context
Curates a project's public and private agent context. Use when checking context health, reorganizing accumulated guidance, repairing AGENTS.md or CLAUDE.md drift, finding stale, duplicated, misplaced or unreachable knowledge, or checking the public/private boundary.
- dotbrain
The dotbrain operating convention — how a Brain, its work graph, and agent workspaces fit together, and the rules that bind work in a wired project. Invoke it to hand an agent the convention when the session-start hook did not.
- find-unknowns
Scans an unfamiliar codebase or feature area against the project Brain and reports the unknown-unknowns and tacit assumptions that would change the approach. Read-only. Use when entering unfamiliar territory, orienting at the start of an initiative, or before committing to a design or a risky change.
- grill-decisions
Challenges a plan against the project's existing domain model, sharpens its terminology, and writes what settles into CONTEXT.md and ADRs as it settles. Use to stress-test a plan against the project's language and documented decisions, or when arriving from find-unknowns with open questions to resolve.
- iterate-design
Iterates from an active design doc in Goal mode for an explicit automation handoff with a mechanical verifier and hard stop.
- manage-work-graph
Maintains the project's private work graph — files, shapes, links, claims, records outcomes for, and closes work items. Use for any interaction with the project issue tracker — filing work items, inspecting the ready frontier, claiming, updating status, applying closure. Hands implementation of an item or finite batch to run-execution. NOT for decomposing a design doc into an epic (to-issues), formalizing an initiative (to-design), closing one out (close-design), or triaging public issues (triage-public).
- review-architecture
Review a codebase for deepening opportunities, informed by the project Brain's domain language and ADRs.
- review-gate
Run a durable engineering review gate with focused code, simplification, or readiness review.
- run-execution
Carries out one work item or a finite batch from the private work graph — selects, dispatches workers, integrates, checks, repairs within limits, closes through manage-work-graph, and escalates or recovers. Use when asked to do, implement, or work an item, a set of items, or an epic's ready work, including requests to dispatch dotbrain workers one after another or in parallel, or via /dotbrain:run-execution. NOT for filing or reshaping work items (manage-work-graph), a design-level automation handoff (iterate-design), or independent review (review-gate).
- run-retro
Curate private retrospective findings from recent work, audit whether they improve later work, suggest repository rules, and deliver authorized rule proposals through dedicated PRs.
- teach-me
Teaches the user a code project over multiple sessions from its private Brain: explains concepts in conversation, walks a learning path through a topic, and captures agreed lessons and references into `.brain/learning/`. Invoke by name to start or continue learning, practice, or capture a lesson.
- to-design
Formalizes a multi-step initiative as a design doc in the Brain plus a tracking epic bead. Use when an initiative is multi-step, crosses modules, or carries meaningful unknowns — before it is decomposed into work items — or when arriving from grill-decisions or find-unknowns with a shape worth writing down.
- to-issues
Decomposes a settled design doc into independently-workable, vertical-slice bead tasks under its epic, with acceptance criteria and dependencies. Runs once per design doc. NOT for taking work off the ready frontier one item at a time — that is manage-work-graph.
- triage-public
Triages public issue tracker items — classify, reproduce, ask reporters for information, decide scope, publish agent briefs — then promotes accepted work inward to the private execution engine. Inward only. Use when reviewing incoming public issues or promoting one into private execution.
- wire-brain
Wires, repairs, refreshes, or inspects a repo's dotbrain Brainspace by driving the dotbrain CLI. Use when starting a project under dotbrain, attaching an existing repo to a Brainspace, repairing wiring in a main checkout or linked Git worktree, reconciling agent workspace resources after an upgrade, or checking bootstrap expectations.
- write-agent-docs
Supplies the writing discipline for any document an agent consumes — context pointers, information hierarchy, completion criteria, leading words, pruning. Use when creating or editing AGENTS.md or CLAUDE.md, public project docs agents rely on, Brain context, design or ADR docs, skills, or referenced guidance.
Hooks 3
Runs on these events- SessionEndcommand
No description in the file.
- SessionStartcommand
startup|resume|clear|compact
- Stopcommand
No description in the file.
Using dotbrain in Claude Code
Skills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update dotbrain@dotbrain
- Refresh the marketplace
- /plugin marketplace update dotbrain
- Turn it off for now
- /plugin disable dotbrain@dotbrain
- Remove it
- /plugin uninstall dotbrain@dotbrain
Skills in dotbrain
- brain-sitearminzou/dotbrain
Set up, maintain, build, and preview a Brain's private site with dotbrain site, including navigation, themes, and rendering checks.
5 files5stars - close-designarminzou/dotbrain
Closes a shipped, abandoned or superseded design — checks shipment evidence, promotes durable residue, stamps frontmatter and closes the epic. Use when the human asks to close out, wrap up or finish a design.
2 files5stars - curate-project-contextarminzou/dotbrain
Curates a project's public and private agent context. Use when checking context health, reorganizing accumulated guidance, repairing AGENTS.md or CLAUDE.md drift, finding stale, duplicated, misplaced or unreachable knowledge, or checking the public/private boundary.
2 files5stars - dotbrainarminzou/dotbrain
The dotbrain operating convention — how a Brain, its work graph, and agent workspaces fit together, and the rules that bind work in a wired project. Invoke it to hand an agent the convention when the session-start hook did not.
2 files5stars - find-unknownsarminzou/dotbrain
Scans an unfamiliar codebase or feature area against the project Brain and reports the unknown-unknowns and tacit assumptions that would change the approach. Read-only. Use when entering unfamiliar territory, orienting at the start of an initiative, or before committing to a design or a risky change.
2 files5stars - grill-decisionsarminzou/dotbrain
Challenges a plan against the project's existing domain model, sharpens its terminology, and writes what settles into CONTEXT.md and ADRs as it settles. Use to stress-test a plan against the project's language and documented decisions, or when arriving from find-unknowns with open questions to resolve.
4 files5stars - iterate-designarminzou/dotbrain
Iterates from an active design doc in Goal mode for an explicit automation handoff with a mechanical verifier and hard stop.
2 files5stars - manage-work-grapharminzou/dotbrain
Maintains the project's private work graph — files, shapes, links, claims, records outcomes for, and closes work items. Use for any interaction with the project issue tracker — filing work items, inspecting the ready frontier, claiming, updating status, applying closure. Hands implementation of an item or finite batch to run-execution. NOT for decomposing a design doc into an epic (to-issues), formalizing an initiative (to-design), closing one out (close-design), or triaging public issues (triage-public).
7 files5stars - review-architecturearminzou/dotbrain
Review a codebase for deepening opportunities, informed by the project Brain's domain language and ADRs.
5 files5stars - review-gatearminzou/dotbrain
Run a durable engineering review gate with focused code, simplification, or readiness review.
6 files5stars - run-executionarminzou/dotbrain
Carries out one work item or a finite batch from the private work graph — selects, dispatches workers, integrates, checks, repairs within limits, closes through manage-work-graph, and escalates or recovers. Use when asked to do, implement, or work an item, a set of items, or an epic's ready work, including requests to dispatch dotbrain workers one after another or in parallel, or via /dotbrain:run-execution. NOT for filing or reshaping work items (manage-work-graph), a design-level automation handoff (iterate-design), or independent review (review-gate).
12 files5stars - run-retroarminzou/dotbrain
Curate private retrospective findings from recent work, audit whether they improve later work, suggest repository rules, and deliver authorized rule proposals through dedicated PRs.
6 files5stars - teach-mearminzou/dotbrain
Teaches the user a code project over multiple sessions from its private Brain: explains concepts in conversation, walks a learning path through a topic, and captures agreed lessons and references into `.brain/learning/`. Invoke by name to start or continue learning, practice, or capture a lesson.
8 files5stars - to-designarminzou/dotbrain
Formalizes a multi-step initiative as a design doc in the Brain plus a tracking epic bead. Use when an initiative is multi-step, crosses modules, or carries meaningful unknowns — before it is decomposed into work items — or when arriving from grill-decisions or find-unknowns with a shape worth writing down.
2 files5stars - to-issuesarminzou/dotbrain
Decomposes a settled design doc into independently-workable, vertical-slice bead tasks under its epic, with acceptance criteria and dependencies. Runs once per design doc. NOT for taking work off the ready frontier one item at a time — that is manage-work-graph.
2 files5stars - triage-publicarminzou/dotbrain
Triages public issue tracker items — classify, reproduce, ask reporters for information, decide scope, publish agent briefs — then promotes accepted work inward to the private execution engine. Inward only. Use when reviewing incoming public issues or promoting one into private execution.
5 files5stars - wire-brainarminzou/dotbrain
Wires, repairs, refreshes, or inspects a repo's dotbrain Brainspace by driving the dotbrain CLI. Use when starting a project under dotbrain, attaching an existing repo to a Brainspace, repairing wiring in a main checkout or linked Git worktree, reconciling agent workspace resources after an upgrade, or checking bootstrap expectations.
3 files5stars - write-agent-docsarminzou/dotbrain
Supplies the writing discipline for any document an agent consumes — context pointers, information hierarchy, completion criteria, leading words, pruning. Use when creating or editing AGENTS.md or CLAUDE.md, public project docs agents rely on, Brain context, design or ADR docs, skills, or referenced guidance.
3 files5stars
dotbrain plugin questions
How do I install the dotbrain plugin?
In Claude Code run /plugin marketplace add arminzou/dotbrain, then /plugin install dotbrain@dotbrain.
What does the dotbrain plugin include?
dotbrain bundles 18 skills, hooks.
How do I update or remove the dotbrain plugin?
Update it with claude plugin update dotbrain@dotbrain in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall dotbrain@dotbrain.
What license is the dotbrain plugin under?
MIT, as stated in the plugin's manifest.