brana

brana

A Claude Code plugin that turns it into a systematic development partner -- skills, rules, hooks, and agents so Claude learns from every session, follows engineering discipline, and works consistently across all your projects.

What you get

• 25 skills -- slash commands for building, researching, reviewing, managing tasks, and running a business
• 12 rules -- git discipline, test-first, context budget, research methodology -- always active
• 10 hooks -- automatic behaviors: pattern recall, spec-before-code gate, learning capture, cascade detection
• 11 agents -- specialized sub-agents that auto-fire for code review, adversarial challenge, research, business ops

Quick start

1. Install the plugin

/plugin marketplace add martineserios/thebrana
/plugin install brana

2. (Optional) Deploy the identity layer

git clone https://github.com/martineserios/thebrana.git
cd thebrana && ./bootstrap.sh

3. Start working

/brana:build "add user authentication"   -- auto-detects strategy (feature, bug fix, refactor...)
/brana:backlog start t-015                -- pick a task and enter the build loop
/brana:close                             -- end session, capture learnings

Feature highlights

Build anything with one command

/brana:build detects what you're doing -- feature, bug fix, refactor, spike, migration, investigation, or greenfield -- and runs the right workflow. TDD enforced, docs included.

Learns from every session

Hooks capture corrections, test writes, and failure cascades. /brana:close extracts patterns. Next session, they're recalled automatically. Confidence-weighted: new learnings start quarantined, proven ones surface first.

Adversarial review built in

/brana:challenge runs an Opus-powered adversarial review with four flavors: pre-mortem, simplicity challenge, assumption buster, adversarial user. Auto-triggers after plan mode.

Full business toolkit

/brana:review (weekly/monthly health checks), /brana:pipeline (deal tracking), /brana:financial-model (projections + scenarios), /brana:venture-phase (milestone execution), /brana:proposal (client proposals in Spanish).

Spec-before-code enforcement

The PreToolUse hook blocks implementation writes on feat/* branches until a spec or test exists. Projects opt in by having a docs/decisions/ directory.

Skills

Group	Skills
Core	backlog, reconcile, acquire-skills, plugin
Execution	build, onboard, align, client-retire
Learning	challenge, research, memory, retrospective
Venture	review, venture-phase, pipeline, financial-model, proposal
Session	close
Capture	log
Tools	notebooklm-source
Utility	scheduler, export-pdf, gsheets, respondio-prompts, meta-template

All skills are invoked as /brana:<name>. See Skill Reference for full details.

Agents

Agent	Model	Auto-fires when
memory-curator	Haiku	Starting work, familiar problem, stuck
client-scanner	Haiku	New client, project health check
venture-scanner	Haiku	New business project
challenger	Opus	Plan or architecture decision forming
debrief-analyst	Opus	End of implementation session
scout	Haiku	Research tasks (spawned by skills)
archiver	Haiku	Retiring a client
daily-ops	Haiku	Session start on venture project
metrics-collector	Haiku	Business reviews
pipeline-tracker	Haiku	Pipeline tracking, deal events
pr-reviewer	Sonnet	PR creation (auto-triggered)

All agents are read-only. See Agent Reference for full details.

Documentation