CodeArbiter

The AI Team Lead that actually reads your docs. Stop merging code that breaks your project's DNA.

---

---

🚀 The Vision

Manual code reviews are the #1 bottleneck for fast-moving teams. Senior developers spend hours every day pointing out the same architectural flaws and style violations buried in internal documentation.

CodeArbiter bridges the gap between your Static Documentation and your Live Diffs. It acts as a Digital Team Lead that understands the nuance of your project's specific "Code of Conduct" to ensure every PR is production-ready before a human ever has to look at it.

✨ Key Features

• 🧠 Contextual Auditing: Cross-references PR titles, descriptions, and full diffs against your custom Markdown style guides.
• 📊 0-100% Readiness Score: A dynamic scoring algorithm that prioritizes security and architecture over minor style tweaks.
• ⚡ Holographic Scanner: A premium, agentic UI that simulates a high-fidelity scanning sequence during analysis.
• 💬 1-Click Feedback Loop: Generates natural-language developer responses and allows for merging directly from the dashboard.
• 💎 Neo-Brutalist Design: A high-contrast, professional interface built for a state-of-the-art developer experience.

---

🏗️ Architecture

graph TD
    subgraph "Frontend (Next.js 14)"
        A[Dashboard UI] --> B[PR Analysis Terminal]
        A --> C[Style Guide Manager]
        B --> D[Holographic Scanner UI]
    end

    subgraph "Backend Engine (FastAPI)"
        E[HTTP Analysis Endpoint] --> F[Agentic Workflow]
        G[Webhook Listener] --> F
    end

    subgraph "AI Reasoning Layer (Gemini)"
        F --> H[Gemini 2.5 Flash]
        H --> I[Context Processor]
        I --> J[PR Auditor]
        J --> K[Scoring & Feedback Engine]
    end

    subgraph "Data & External"
        L[(SQLite / Prisma)] <--> A
        L <--> E
        F <--> M[GitHub REST API]
        M <--> N[User Repositories]
    end

    style H fill:#0b6df6,stroke:#fff,stroke-width:4px,color:#fff
    style D fill:#f0f7ff,stroke:#0b6df6,stroke-width:2px

Loading

---

🛠️ Tech Stack

• Core: Next.js 14 (App Router), TypeScript, Tailwind CSS
• AI Agent: Google Gemini 2.5 Flash (Long-context reasoning)
• Backend Engine: FastAPI (Python), Uvicorn
• Persistence: Prisma ORM with SQLite
• Automation: GitHub API (Octokit), NextAuth.js

🚦 Installation & Setup

1. Prerequisites

• Node.js 18+ & Python 3.10+
• uv (Python package manager)
• Gemini API Key & GitHub Personal Access Token

2. Backend Setup (Engine)

cd engine
cp .env.example .env # Add your keys
uv run uvicorn main:app --reload

3. Frontend Setup (Client)

cd client
npm install
npm run dev

---

"Your documentation is no longer a graveyard of ideas—it's the law. CodeArbiter: Bridge the gap between 'Looks Good To Me' and 'Production Ready'."