> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octokraft.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Technical debt intelligence for AI-assisted engineering teams

# Corbulo

**AI-assisted teams ship fast. Corbulo makes sure they ship well.**

Modern engineering teams move faster than ever. AI coding assistants generate pull requests in minutes. Developers merge changes across dozens of repositories in a single sprint. The velocity is real -- but so is the cost.

## The Problem

As AI-assisted development accelerates, three problems compound:

**Context collapse.** Every PR is reviewed in isolation. No one sees that the "small refactor" in service A conflicts with the architectural direction of service B, or that the same anti-pattern has been introduced across four repositories this week.

**Missing measurement.** Teams know their code health is degrading but have no systematic way to quantify it. "We need to address tech debt" becomes a recurring conversation with no data behind it.

**System-level blindness.** Static analyzers catch syntax issues. Code review catches local logic errors. But no one is tracking whether the overall architecture is holding together -- whether coupling is increasing, whether conventions are being followed, whether the codebase is becoming harder to change.

## How Corbulo Helps

Corbulo connects to your repositories, analyzes every pull request with full system context, and tracks your code health over time. Instead of reviewing PRs in isolation, you get continuous intelligence about what is actually happening to your codebase.

<Steps>
  <Step title="Connect your repositories">
    Install the Corbulo GitHub App and select the repositories you want to track. Corbulo indexes your code, detects your tech stack, and runs an initial analysis.
  </Step>

  <Step title="Get PR analysis with system context">
    Every pull request is automatically classified, checked for issues, and evaluated for merge readiness. Corbulo considers the full codebase -- not just the diff -- so it catches problems that isolated review cannot.
  </Step>

  <Step title="Track code health over time">
    A continuously updated health score across 8 weighted categories gives you a clear, quantified picture of your codebase. Drift alerts notify you when health degrades, so you can intervene before tech debt compounds.
  </Step>
</Steps>

## Core Capabilities

| Capability              | What It Does                                                                                                                                   |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **PR Analysis**         | Classifies PRs by intent and change category, detects issues by severity, evaluates merge readiness, flags scope drift and conflicts           |
| **Code Health**         | Continuous assessment across 8 weighted categories with severity-based issue tracking, drift alerts, and letter-grade scoring                  |
| **Architecture Review** | Evaluates modularity, coupling, scalability, and patterns. Detects conventions, generates living documentation, tracks architectural decisions |
| **Multi-Repository**    | Unified visibility across all repositories in a project. Cross-repo health tracking and analysis                                               |
| **MCP Integration**     | Connect Corbulo to AI coding tools like Claude Code, Cursor, and Windsurf for context-aware development                                        |

## Choose Your Path

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get up and running in under 5 minutes. Connect your first repository and see your health score.
  </Card>

  <Card title="Core Features" icon="cube" href="/features/code-health">
    Deep dive into code health scoring, PR analysis, and architecture review.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Integrate Corbulo into your workflows with the REST API.
  </Card>

  <Card title="Self-Hosting" icon="server" href="/self-hosting/overview">
    Deploy Corbulo in your own infrastructure with full control over your data.
  </Card>
</CardGroup>