{"id":47004666,"url":"https://github.com/martineserios/thebrana","last_synced_at":"2026-05-24T20:06:05.224Z","repository":{"id":343235884,"uuid":"1160000786","full_name":"martineserios/thebrana","owner":"martineserios","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-19T15:17:19.000Z","size":4509,"stargazers_count":1,"open_issues_count":536,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-19T17:26:11.429Z","etag":null,"topics":["ai-agents","ai-development","claude-code","claude-code-plugin","developer-tools","plugin"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/martineserios.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-17T12:28:02.000Z","updated_at":"2026-04-19T15:17:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/martineserios/thebrana","commit_stats":null,"previous_names":["martineserios/thebrana"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/martineserios/thebrana","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martineserios%2Fthebrana","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martineserios%2Fthebrana/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martineserios%2Fthebrana/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martineserios%2Fthebrana/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/martineserios","download_url":"https://codeload.github.com/martineserios/thebrana/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martineserios%2Fthebrana/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32803689,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"ssl_error","status_checked_at":"2026-05-08T08:22:45.650Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-development","claude-code","claude-code-plugin","developer-tools","plugin"],"created_at":"2026-03-11T20:00:44.371Z","updated_at":"2026-05-09T01:16:20.150Z","avatar_url":"https://github.com/martineserios.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# brana\n\n![Version](https://img.shields.io/badge/version-v1.0.0-blue)\n![License](https://img.shields.io/badge/license-MIT-green)\n![Claude Code](https://img.shields.io/badge/Claude%20Code-v1.0.33+-purple)\n\nEvery Claude Code session, your model re-infers what it already knew: your stack, your naming conventions, your past decisions. This invisible per-session cost is the **knowledge retrieval tax** — and it compounds.\n\nBrana eliminates it. A plugin for Claude Code that accumulates your engineering conventions, corrections, and decisions — so each session starts from where the last one ended, not from zero.\n\n## The compounding loop\n\nEach session, brana captures what went wrong and what worked. Next session, those patterns surface automatically before you start. Corrections don't repeat. Patterns proven across 3+ sessions get promoted and recalled with higher confidence than new ones.\n\n**Without brana:** Claude resets every session — re-infers your stack, re-learns your conventions, repeats the same mistakes.  \n**With brana:** Claude remembers your corrections, follows your conventions, and gets harder to fool over time.\n\n## What's included\n\nSkills, rules, hooks, and agents that enforce the loop automatically:\n\n- **Skills** -- slash commands for building, researching, reviewing, managing tasks, and more\n- **Rules** -- git discipline, test-first, context budget, research methodology — always active\n- **Hooks** -- automatic behaviors: pattern recall, spec-before-code gate, learning capture, cascade detection\n- **Agents** -- specialized sub-agents that auto-fire for code review, adversarial challenge, research, and more\n\n## Quick start\n\n### Install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/martineserios/thebrana/main/install.sh | bash\n```\n\nOr manually:\n\n```bash\ngit clone https://github.com/martineserios/thebrana.git ~/brana\ncd ~/brana \u0026\u0026 ./bootstrap.sh\n```\n\nRestart Claude Code. The plugin loads automatically.\n\n**Custom install directory:** `BRANA_DIR=~/my-dir bash install.sh`\n\n### Start working\n\n```\n/brana:build \"add user authentication\"   -- auto-detects strategy (feature, bug fix, refactor...)\n/brana:backlog                            -- manage tasks\n/brana:close                             -- end session, capture learnings\n```\n\n## Feature highlights\n\n### Build anything with one command\n\n`/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.\n\n### Learns from every session\n\nHooks 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.\n\n### Adversarial review built in\n\n`/brana:challenge` runs an Opus-powered adversarial review with four flavors: pre-mortem, simplicity challenge, assumption buster, adversarial user. Auto-triggers after plan mode.\n\n### Enforcement, not reminders\n\nRules are active constraints, not suggestions. The PreToolUse hook blocks implementation writes on `feat/*` branches until a spec or test exists. The worktree gate prevents accidental commits to `main`. The doc gate blocks commits that change behavior without updating docs. You can't skip the fundamentals because they aren't optional.\n\n## Skills\n\nOrganized by job:\n\n| Job | Skills |\n|-----|--------|\n| **DECIDE** | `backlog`, `brainstorm`, `sitrep`, `challenge` |\n| **UNDERSTAND** | `research`, `onboard`, `memory`, `notebooklm-source` |\n| **BUILD** | `build`, `align`, `docs`, `reconcile` |\n| **SHIP** | `ship`, `review`, `client-retire` |\n| **CAPTURE** | `close`, `retrospective`, `log`, `gsheets`, `export-pdf` |\n| **Tools** | `acquire-skills`, `plugin`, `scheduler`, `rust-skills`, `mcp-builder` |\n\nAll skills are invoked as `/brana:\u003cname\u003e`. See [Skill Reference](docs/reference/skills.md) for full details.\n\n## Agents\n\n| Agent | Model | Auto-fires when |\n|-------|-------|-----------------|\n| memory-curator | Haiku | Starting work, familiar problem, stuck |\n| client-scanner | Haiku | New client, project health check |\n| venture-scanner | Haiku | New business project |\n| challenger | Sonnet | Plan or architecture decision forming |\n| debrief-analyst | Opus | End of implementation session |\n| scout | Haiku | Research tasks (spawned by skills) |\n| archiver | Haiku | Retiring a client |\n| daily-ops | Haiku | Session start on venture project |\n| metrics-collector | Haiku | Business reviews |\n| pipeline-tracker | Haiku | Pipeline tracking, deal events |\n| pr-reviewer | Sonnet | PR creation (auto-triggered) |\n\nAll agents are read-only. See [Agent Reference](docs/reference/agents.md) for full details.\n\n## Documentation\n\n| Section | Contents |\n|---------|----------|\n| **[Reference](docs/reference/)** | Complete specs: [skills](docs/reference/skills.md), [hooks](docs/reference/hooks.md), [agents](docs/reference/agents.md), [rules](docs/reference/rules.md), [commands](docs/reference/commands.md), [scripts](docs/reference/scripts.md), [configuration](docs/reference/configuration.md) |\n| **[Guide](docs/guide/)** | [Getting started](docs/guide/getting-started.md), [configuration](docs/guide/configuration.md), [workflows](docs/guide/workflows/) (build, research, session, capture, learn, venture), [troubleshooting](docs/guide/troubleshooting.md) |\n| **[Architecture](docs/architecture/)** | [Overview](docs/architecture/overview.md), [plugin structure](docs/architecture/plugin-structure.md), [extending](docs/architecture/extending.md) (skills, hooks, agents), [ADRs](docs/architecture/decisions/) |\n| **[Doc Index](docs/README.md)** | Full index of all documentation |\n\n## How it works\n\nBrana is structured as four layers:\n\n| Layer | What it is | Examples |\n|-------|-----------|---------|\n| **Commands** | Skills invoked as `/brana:*` slash commands | `build`, `backlog`, `research`, `close` |\n| **Specialists** | Agents that auto-fire for specific work types | challenger, pr-reviewer, debrief-analyst |\n| **Fabric** | Hooks enforcing rules automatically | spec gate, worktree guard, learning capture |\n| **Memory** | Cross-session pattern storage and recall | corrections, proven patterns, session state |\n\nPhysically, these live in two places:\n\n```\nPlugin (loaded by Claude Code)              Identity layer (~/.claude/)\n+-- skills/    -\u003e /brana:* commands         +-- CLAUDE.md  -\u003e who Claude is\n+-- hooks/     -\u003e automatic behaviors       +-- rules/     -\u003e behavioral rules\n+-- agents/    -\u003e specialized sub-agents    +-- scripts/   -\u003e helper scripts\n+-- commands/  -\u003e agent commands            +-- scheduler/ -\u003e scheduled jobs\n```\n\nThe **plugin** is the toolkit — what Claude can do. Loads via Claude Code's plugin system.\n\nThe **identity layer** is the foundation — how Claude thinks. Deploys once via `bootstrap.sh`.\n\n## Dev mode\n\nFor contributors:\n\n```bash\ngit clone https://github.com/martineserios/thebrana.git\ncd thebrana\nclaude --plugin-dir ./system    # edits take effect on next session\n```\n\n## Requirements\n\n- [Claude Code](https://claude.com/claude-code) v1.0.33+\n- Git\n\n**Optional:** Node.js v20+ (MCP integrations), [claude-flow](https://www.npmjs.com/package/claude-flow) (cross-client memory search)\n\n## Version\n\nv1.0.0 | [Changelog](#changelog)\n\n### Changelog\n\n| Version | Milestone |\n|---------|-----------|\n| v1.0.0 | Marketplace publication, full documentation |\n| v0.7.0 | Plugin packaging, namespace migration, bootstrap.sh |\n| v0.6.0 | Unified repo (enter + thebrana merged) |\n| v0.5.0 | Project alignment, venture management |\n| v0.4.0 | Validation, context budget, self-documentation |\n| v0.3.0 | Learning loop, knowledge health |\n| v0.2.0 | Hook system (session start/end, spec-first gate) |\n| v0.1.0 | Skills, rules, deploy scripts |\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for setup, branch naming, and PR process. Issues tagged [`good first issue`](https://github.com/martineserios/thebrana/labels/good%20first%20issue) are a great starting point.\n\n### Contributors\n\n\u003c!-- Add yourself here when your first PR is merged --\u003e\n- [Martin Eserios](https://github.com/martineserios) -- creator, maintainer\n\n## Security\n\nSee [SECURITY.md](SECURITY.md).\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmartineserios%2Fthebrana","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmartineserios%2Fthebrana","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmartineserios%2Fthebrana/lists"}