Skip to content
Back to home
Open Source · Free · Yours

Claude Brain

One command turns Claude Code into a senior collaborator instead of a chatty intern. Months of tuning — playbook, workflow, memory, notifications — packaged into a five-second install.

bash <(curl -sL https://dormizrahi.com/install)

macOS · Claude Code CLI required · Backs up your existing setup before writing.

Why this exists

Out of the box, Claude Code talks like a help desk. Ask “is this ready?” and you get three paragraphs, an option grid, a recommendation, and a closing summary. Ask for a fix and you get a multi-section presentation with “Option A / Option B / Option C — which would you prefer?” Confirmation theater. Filler. Hedging on things it should just know.

Worse, Claude hallucinates. It claims tests pass without running them. It claims files exist without reading them. It writes plans against code it never opened. It picks symptoms over root causes. It builds toy implementations and labels them shippable.

Claude Brain fixes all of that. Not by clipping output length after the fact — by changing how Claude thinks about the work.

What changes in your Claude

Verifies before stating

Claude stops guessing. Claims tests pass only after running them. Claims a file exists only after reading it. Says “I don’t know yet” instead of confidently inventing answers. When you challenge a claim, it re-checks the source instead of re-explaining what it meant.

Real work always

No “quick version for now, proper version later.” No half-finished implementations. No TODO comments hiding missing scope. Every artifact is shippable, or Claude says explicitly what’s missing.

Fixes root causes

When something breaks, Claude traces it to the source. Doesn’t suppress symptoms. Doesn’t downgrade the model when the prompt is the real problem. Doesn’t blame external services before checking its own usage.

Matches your style

Reads the existing patterns in your codebase before writing new code. Your hooks look like your other hooks. New files feel native, not like Claude dropped a foreign body into your repo.

Pauses when stuck

After two failed attempts at the same problem, Claude stops and asks instead of churning. Saves you the hours where Claude spirals trying small variations on a broken approach.

Remembers you across sessions

Persistent memory of who you are, how you work, corrections you’ve given, validated approaches, project context. Six months later it still knows. Only evergreen things get saved — sprint state lives elsewhere so memory doesn’t rot.

Mirrors your language

Replies in whatever language you wrote in. No mixing. No “the project is in Hebrew so I’ll respond in Hebrew” overrides — your last message wins, always.

Sorts actions by reversibility

Local edits and drafts just happen — no interrupt-to-confirm. Reads and quick checks proceed. Hard-to-reverse stuff (publish, commit, delete) waits for explicit go. You stop being asked about trivial things and stop being surprised by destructive ones.

Three workflow commands

Slash commands shared across every project. Not developer-only — they work for code, writing, research, course modules, business decisions, anything you do with Claude over more than one session.

/init-claude-brain

Claude interviews you about a new project — what it is, who it’s for, how you work on it — then proposes a knowledge base shaped to that specific thing and writes the files. The project’s own CLAUDE.md is born from the interview, not from a template you fill in.

/sprint

Plans a sprint of related work toward a defined goal. A sprint is a chunk of work the size of a feature, a chapter, a research phase, a course module. Forces you to define scope before doing — and forces Claude to think before writing.

/summarize-session

Closes a session with a structured SESSION_NN.md and updates the sprint’s progress log. Lets you walk away on Friday and pick back up cold on Monday — your future Claude reads the log and knows where you left off.

The three commands share a vocabulary. Sprints contain sessions. Sessions reference sprints. Both reference the brain. Coherent system, not a grab bag of unrelated tools.

On the conversation style

I built the workflow first — the playbook, the verify-before-state rule, the sprint vocabulary, the memory system. Months of iteration. And Claude still produced essays for simple questions. Still returned option grids. Still spewed multi-section decks when I wanted one word back.

The last thing I added was a conversation style layer descended from the open-source Caveman skill — the original “stop wasting tokens on bullshit” intervention. Caveman taught Claude to drop articles, filler, pleasantries. It worked on individual replies.

Finish notifications

On macOS, your machine plays a sound when Claude finishes a turn and pops a banner when Claude needs your attention. Walk away while Claude works, come back when you hear it. Only installs if you don’t already have your own notification hooks wired — won’t clobber anything you’ve set up.

What gets installed

PathPurpose
~/.claude/CLAUDE.mdPersonalized playbook Claude reads every session. Collaboration loop, verify-before-state, real-work-always, root-cause fixing, action reversibility, language mirroring, workflow triggers, memory rules.
~/.claude/commands/init-claude-brain.md/init-claude-brain — interview-driven new project setup
~/.claude/commands/sprint.md/sprint — plan a sprint of related work toward a goal
~/.claude/commands/summarize-session.md/summarize-session — structured session close + sprint progress log update
~/.claude/templates/project-CLAUDE.mdTemplate /init-claude-brain uses to scaffold per-project knowledge bases
~/.claude/rules/conversation-style.mdTelegraph-English style rules — lexical compression + structural restraint
~/.claude/hooks/conversation-style-activate.jsSessionStart hook — loads style rules into Claude’s system context at session start
~/.claude/hooks/conversation-style-reinforce.jsUserPromptSubmit hook — re-injects rules every turn so style doesn’t drift across long sessions
~/.claude/settings.jsonMerged — wires the two style hooks always; adds Stop + Notification sound hooks on macOS only if you haven’t wired your own

Safety

  • Anything already at those paths gets backed up to ~/.claude/backups/install-YYYYMMDD-HHMMSS/ before being replaced. The installer prints the backup location before writing.
  • The settings.json merge is idempotent. Re-running the installer doesn’t duplicate hooks. Your existing permissions, status line, and other hooks are preserved.
  • Uninstall snippet ships with the README — one Node one-liner strips just the brain’s hooks from your settings.json without touching anything else.

Try it

Five seconds. Reversible. Free. If you hate it, the uninstall is in the README.

bash <(curl -sL https://dormizrahi.com/install)

Source: github.com/Ruinous7/portfolio