Help us improve
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
By beevibe-ai
Automate architecture deep research for system design decisions: scan repos, draft PRDs, run live research with citations, and produce decision reports. Optionally enforce team principles through review hooks.
npx claudepluginhub beevibe-ai/beevibe-ctoRun a full Architecture Deep Research pipeline against the current repo and a named decision. Scans the repo for patterns and anti-patterns, drafts a PRD, runs live deep-research with citation audits, and returns a decision handoff the coding agent can implement under.
Run only the discover stage. Scans the local repo for patterns and anti-patterns, drafts a PRD (`pdr.draft.md`), and stops. Use when the user wants to see what ADR infers from the codebase before paying for a full deep-research run.
Set up ADR for first-time use. Audits what's already configured, then walks the user through obtaining and saving the API keys ADR needs. Use when the user asks "set up ADR", "what keys do I need?", "I don't know how to get these", or when /adr:decide reports missing keys.
Install Claude Code + git pre-commit hooks that surface team principles at write time and block commits that violate high-severity rules. Use when the user wants to wire ADR's principles into their everyday workflow so they never see the same review comment twice.
Discover the team's code-review principles from their own repo. Scans for code-review lenses (state-boundaries, llm-call-discipline, etc.), extracts positive patterns + antipatterns + ambiguities with file:line citations, walks the user through an interactive interview to confirm, and writes `.adr/principles.{md,json}`. Use when the user asks to set up team principles, or before running `/adr:review` for the first time.
Share bugs, ideas, or general feedback.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Make your AI agent code with your project's architecture, rules, and decisions.
Architecture analysis, brainstorming, ADR generation, LLM-as-judge comparison, and spec gap resolution.
AI-powered architecture documentation framework with ADRs, reviews, and pragmatic mode
Architecture Decision Records authoring and management
[Beta] 6つの専門エージェントチームでコードベースのアーキテクチャを多角的に分析するスキル
Codebase exploration, refactoring, and quality analysis
The decision layer your coding agents are missing.
The full loop, from architecture decision through PR review to drift detection:
| Command | What it does |
|---|---|
adr decide | Live deep-research on an architectural decision → an HTML report with N candidates, citations, and Mermaid diagrams. See an example → |
adr principles init | Scans your repo, discovers the team's code-review lenses (state-boundaries, schema-validate-before-write, etc.), walks you through an interview, writes .adr/principles.{md,json} |
adr principles refresh | Re-discover without losing the interview log. Asks only about new ambiguities. |
adr principles incremental | Only re-extract from files changed since last refresh. Reuses prior lenses. Fast. |
adr principles refine --id <id> | Single-principle re-discovery for one specific rule. |
adr review | Checks a PR / staged diff / branch against the principles. Walks the user through violations one-by-one, posts inline comments via gh / glab / Bitbucket API. Supports // adr-ignore: <id> suppression and --batch for one-call CI reviews. |
adr drift | Full-repo scan vs principles. Useful for "how far has the codebase drifted since principles init six months ago?". |
adr guard install | Wires the principles into Claude Code (PreToolUse hook surfaces them at write time) + git pre-commit (blocks high-severity violations). adr guard uninstall reverses it. |
The principles file evolves automatically: stale citations get flagged, accept/edit/skip stats get persisted, and confidence demotes principles users keep skipping. No static-lint trap. See ROADMAP.md for the evolvability story and the commit history.
The brain closes the rest of the loop; upcoming.
Three ways in. All share the same kernel.
claude plugin marketplace add beevibe-ai/beevibe-cto
claude plugin install adr
Then in any Claude Code session:
| Slash | What it does |
|---|---|
/adr:doctor | One-time: audit env, walk through API keys, persist to ~/.adr/config.json |
/adr:decide | Ask a decision name, scan the repo, run the full pipeline, summarize the report |
/adr:discover | Quick scan only — drafts a PRD without the full deep-research run |
/adr:principles | Discover the team's code-review principles from the repo, walk through the interview conversationally |
/adr:review | Check a PR / staged diff against the principles, walk through violations one at a time |
/adr:guard | Install the PreToolUse + pre-commit hooks so principles fire automatically on every edit |
npm install -g github:beevibe-ai/beevibe-cto
adr-doctor setup
Add to your host's MCP config:
{ "mcpServers": { "adr": { "command": "adr-mcp" } } }
Five tools become available: adr_discover, adr_deep_research, adr_read_handoff, adr_principles, adr_review.
npm install -g github:beevibe-ai/beevibe-cto
adr-doctor # audit env, exit non-zero if anything missing
adr deep-research --discover-first --include-peers --open \
--repo . \
--domain "your product domain" \
--decision "vector store for agent memory" \
--out .adr-runs/vector-store
What this does: