┌───────────────────────────────────┐
                │        MegaBrain SQLite DB        │
                │     (~/.megabrain/megabrain.db)   │
                └─────────────────┬─────────────────┘
                                  │ (MCP / CLI)
         ┌────────────────────────┼────────────────────────┐
         │                        │                        │
         ▼                        ▼                        ▼
┌──────────────────┐    ┌──────────────────┐    ┌──────────────────┐
│  Claude Desktop  │    │  VS Code (Cline) │    │ Antigravity IDE  │
│  & Claude Code   │    │  & llama.cpp     │    │                  │
└──────────────────┘    └──────────────────┘    └──────────────────┘

# 1. Clone the repository
git clone https://github.com/dougrn/MCP-MegaBrain.git
cd MCP-MegaBrain

# 2. Sync dependencies with uv
uv sync

# View knowledge base stats
uv run megabrain stats

# Add a strict rule
uv run megabrain record-rule "All code comments and docs must be in English" --category language --project my-app

# Require a spec before touching design
uv run megabrain record-spec "specs/design-tokens.md" --trigger "design,ui,layout" --project my-app

# Record an anti-pattern vaccine
uv run megabrain record-experience --context "php mysql" --failed "Called set_charset on uninitialized PDO" --fix "Pass charset=utf8mb4 inside DSN string"

# Save a verified Golden Pattern
uv run megabrain golden-pattern --title "PHP PDO UTF8MB4" --context "php mysql pdo" --code "$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', $user, $pass, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);"

# Consult MegaBrain (see what the AI receives!)
uv run megabrain consult "php mysql query" --project my-app

# List and delete obsolete records
uv run megabrain list rules
uv run megabrain delete rules 1

{
  "mcpServers": {
    "megabrain": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\dougl\\Desktop\\Serviços\\_Pessoais\\MCP-MegaBrain",
        "megabrain-server"
      ]
    }
  }
}

{
  "mcpServers": {
    "megabrain": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\dougl\\Desktop\\Serviços\\_Pessoais\\MCP-MegaBrain",
        "megabrain-server"
      ],
      "disabled": false,
      "autoApprove": [
        "brain_consult",
        "brain_record_experience",
        "brain_stats"
      ]
    }
  }
}

{
  "mcpServers": {
    "megabrain": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\dougl\\Desktop\\Serviços\\_Pessoais\\MCP-MegaBrain",
        "megabrain-server"
      ]
    }
  }
}

uv run python examples/llama-cpp-wrapper/query_megabrain.py

# MegaBrain Protocol (Persistent Knowledge & Vaccine)

You are equipped with MegaBrain via MCP tools. You MUST follow these mandatory protocols:

## 1. MANDATORY PRE-FLIGHT CONSULTATION
BEFORE generating code, proposing architecture, querying databases, or touching UI design:
- Call `brain_consult(context="<stack/keywords>", project="<project_id_or_global>")`.
- **Prerequisite Specs**: If any mandatory specs are returned, you are strictly FORBIDDEN from writing code or plans until you inspect the spec file using your file reading tool.
- **Golden Patterns**: If a verified snippet is provided, you MUST adopt it instead of inventing your own implementation.
- **AI Blind Spots / Traps**: Carefully avoid the listed anti-patterns and apply the proven fixes.

## 2. AUTONOMOUS SELF-IMPROVEMENT (POST-MORTEM VACCINE)
Whenever you:
- Spend 2 or more attempts trying to fix an error in a terminal/script, OR
- Discover a non-obvious bug or runtime pitfall:
  - IMMEDIATELY call `brain_record_experience(context="...", what_failed="...", fix_applied="...", project="...")`.
  - If a clean, reusable code snippet solved the issue, pass it to `verified_snippet`.

## 3. HUMAN TRIGGERS
If the user says:
- "Grava isso no cérebro" / "Aprende isso" / "Vacina contra esse erro" / "Remember this":
  - Immediately extract the context keywords, what failed, and the working fix.
  - Call `brain_record_experience`.

uv run pytest