# Bito's AI Architect plugin for Claude Code

Bito's AI Architect plugin brings cross-repository intelligence to Claude Code. Search code, explore dependencies, analyze architecture, and discover patterns across all your organization's repositories. Use it to build implementation plans, write requirements documents, diagnose production issues, and understand complex codebases.

It enables users to explore and understand any codebase — from high-level architecture to line-level code traces — calibrated for multiple personas (Developer, EM, PM, VP, CTO).

**Key capabilities:**

* Deep codebase exploration across multiple repositories
* AI-powered architecture analysis and documentation
* Production incident triage with blast radius mapping
* Feature planning grounded in real system context

## Installation

#### Step 1: Add the marketplace

Run this command in Claude Code:

```bash
/plugin marketplace add gitbito/claude-plugins
```

#### Step 2: Install the plugin

```bash
/plugin install bito-ai-architect@bito-claude-plugins
```

#### Step 3: Configure your credentials

Run the interactive setup:

```bash
/bito-ai-architect:bito-setup
```

This command guides you through configuring your workspace ID, bearer token, and email.

**Alternative: manual configuration**

Set these environment variables manually:

```bash
export BITO_WORKSPACE_ID="your-workspace-id"
export BITO_MCP_TOKEN="your-bearer-token"
export BITO_EMAIL="your-email@company.com"
```

After configuration, restart Claude Code and run `/mcp` to verify the server is connected.

## Available commands

Once installed, access these slash commands in Claude Code:

| Command                                | Description                                                                                                                                                                                                                     |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/bito-ai-architect:bito-setup`        | Configure credentials interactively                                                                                                                                                                                             |
| `/bito-ai-architect:codebase-explorer` | Explore and understand any codebase from high-level architecture to line-level code traces. Uses "The One Test" methodology with a 4-phase exploration workflow calibrated for different personas (Developer, EM, PM, VP, CTO). |
| `/bito-ai-architect:feature-plan`      | Build a detailed implementation plan for complex features with cross-repo context                                                                                                                                               |
| `/bito-ai-architect:prd`               | Write a Product Requirements Document grounded in real system context                                                                                                                                                           |
| `/bito-ai-architect:trd`               | Produce a Technical Requirements Document by analyzing existing architecture                                                                                                                                                    |
| `/bito-ai-architect:production-triage` | Diagnose production incidents with cross-repo context and blast radius mapping                                                                                                                                                  |
| `/bito-ai-architect:epic-to-plan`      | Convert an approved epic or PRD into a complete, sprint-ready implementation plan                                                                                                                                               |
| `/bito-ai-architect:feasibility`       | Produce a go/no-go feasibility and impact analysis before committing to implementation                                                                                                                                          |
| `/bito-ai-architect:scope-to-plan`     | Convert any approved work item into a complete, sprint-ready implementation plan                                                                                                                                                |
| `/bito-ai-architect:spike`             | Conduct a structured technical investigation when the team doesn't know enough to plan                                                                                                                                          |

## Getting started

#### Explore a codebase

Use the codebase explorer to understand any repository:

```bash
/bito-ai-architect:codebase-explorer
```

The explorer uses a 4-phase workflow to analyze architecture, dependencies, and code patterns. Choose your persona (Developer, EM, PM, VP, CTO) to get insights calibrated to your role.

#### Plan a feature

Create an implementation plan with cross-repo context:

```bash
/bito-ai-architect:feature-plan
```

The plugin analyzes your codebase to identify affected components, dependencies, and potential conflicts.

#### Triage production issues

Diagnose incidents across repositories:

```bash
/bito-ai-architect:production-triage
```

Get cross-repo context and blast radius mapping to understand the full impact of production issues.

## GitHub repository

* <https://github.com/gitbito/claude-plugins>