代码智能层

graph LR
    subgraph Clients
        CC["Claude Code (MCP)"]
        UI["Chat UI (Vue 3)"]
    end

    subgraph Tiburcio
        MCP["MCP Server (12 tools)"]
        Agent["AI Agent"]
    end

    subgraph Storage
        Qdrant["Qdrant (6 collections)"]
        PG["PostgreSQL"]
        Redis["Redis"]
    end

    CC -- MCP stdio --> MCP --> Qdrant
    UI -- SSE --> Agent --> Qdrant
    Agent --> PG
    Agent --> Redis

Developer: "Write a new API endpoint for user preferences"

Claude Code (via MCP):
1. searchStandards → team's endpoint conventions (compact: 3 results, ~400 tokens)
2. getPattern → "new-api-endpoint" template (~600 tokens)
3. searchCode → existing similar endpoints (~500 tokens)

→ Writes code that matches YOUR conventions, YOUR patterns, YOUR architecture.

flowchart LR
    A["2 AM Cron"] --> B["Incremental Reindex"]
    B --> C["Clean Stale Vectors"]
    C --> D["Review Merges"]
    D --> E["Generate Test Suggestions"]

Developer: "What should I know this morning?"

Claude Code (via MCP):
1. getNightlySummary → "3 merges reviewed, 1 CRITICAL issue in PaymentService,
   2 warnings, 2 files need tests"

→ Developer knows exactly what needs attention before writing a single line of code.

git clone https://github.com/JoaoMorais03/tiburcio.git
cd tiburcio
cp .env.example .env
# Edit .env — MODEL_PROVIDER=ollama (no API key needed)
docker compose --profile ollama up -d
# Pull models (first time only):
docker exec ollama ollama pull qwen3:8b
docker exec ollama ollama pull nomic-embed-text

git clone https://github.com/JoaoMorais03/tiburcio.git
cd tiburcio
cp .env.example .env
# Edit .env — fill in your INFERENCE_API_KEY from https://openrouter.ai
# Defaults: qwen/qwen3-8b (LLM) + qwen/qwen3-embedding-8b (embeddings)
# MCP-only (no frontend):
docker compose up db redis qdrant backend -d
# Full stack (with chat UI):
docker compose up -d

cd backend
claude mcp add tiburcio -- npx tsx src/mcp.ts

claude mcp add tiburcio \
  --transport sse \
  --url http://your-server:3333/mcp/sse \
  --header "Authorization:Bearer <team-api-key>"

pnpm install
docker compose up db redis qdrant -d
cp .env.example .env              # configure your model provider
cd backend && pnpm db:migrate     # run database migrations
cd .. && pnpm dev                 # backend + frontend dev servers

standards/
  architecture/    # System design docs (auth flows, data pipelines, etc.)
  backend/         # Backend coding conventions
  frontend/        # Frontend conventions
  database/
    schemas/       # Table-by-table documentation
  patterns/        # Code templates ("new API endpoint", "new Vue page")
  integration/     # Git workflow, CI/CD, deployment docs

# Via admin API (login first via the UI for httpOnly cookie auth)
curl -X POST http://localhost:5174/api/admin/reindex --cookie "token=$TOKEN"

# Or via CLI
cd backend
pnpm index:standards
pnpm index:codebase        # set CODEBASE_REPOS in .env first
pnpm index:architecture

tiburcio/
  backend/
    src/
      config/          # Environment, logger, Redis client
      db/              # Drizzle schema, connection, migrations
      indexer/         # Code chunker, embedding, indexing pipelines
      jobs/            # BullMQ background jobs + nightly cron
      mastra/
        tools/         # 12 RAG tools (Qdrant vector search)
        workflows/     # Nightly review workflow
        infra.ts       # Shared singletons (qdrant client, ensureCollection)
      middleware/       # Rate limiters (global, auth, chat)
      routes/          # HTTP routes (auth, chat, admin, MCP SSE)
      mcp.ts           # MCP stdio server for local Claude Code
      server.ts        # HTTP server entry point
    scripts/           # CLI indexing scripts
  frontend/
    src/
      components/      # UI primitives + chat components
      lib/             # API client, Vue Query, web vitals
      stores/          # Pinia stores (auth, chat, rate-limit)
      views/           # Page components (Auth, Chat)
  standards/           # Your team's knowledge base (docs go here)
  docs/                # Changelog, contributing guide, roadmap

cd backend && pnpm test    # 137 tests
cd frontend && pnpm test   # 30 tests
cd backend && pnpm check   # biome lint + tsc
cd frontend && pnpm check  # biome lint + vue-tsc

cd backend
claude mcp add tiburcio -- npx tsx src/mcp.ts