reviewflow 3.0.0

package/dist/usecases/tracking/trackAssignment.usecase.js

@@ -0,0 +1,69 @@
+import { createTrackedMrId } from '../../entities/tracking/trackedMr.js';
+export class TrackAssignmentUseCase {
+    trackingGateway;
+    constructor(trackingGateway) {
+        this.trackingGateway = trackingGateway;
+    }
+    execute(input) {
+        const { projectPath, mrInfo, assignedBy } = input;
+        const mrId = createTrackedMrId(mrInfo.platform, mrInfo.project, mrInfo.mrNumber);
+        const existing = this.trackingGateway.getById(projectPath, mrId);
+        if (existing) {
+            return this.updateExisting(projectPath, existing, mrInfo, assignedBy);
+        }
+        return this.createNew(projectPath, mrId, mrInfo, assignedBy);
+    }
+    updateExisting(projectPath, existing, mrInfo, assignedBy) {
+        const now = new Date().toISOString();
+        const shouldResetState = existing.state === 'merged' || existing.state === 'closed';
+        this.trackingGateway.update(projectPath, existing.id, {
+            title: mrInfo.title,
+            assignment: {
+                username: assignedBy.username,
+                displayName: assignedBy.displayName,
+                assignedAt: now,
+            },
+            ...(shouldResetState ? { state: 'pending-review' } : {}),
+        });
+        return this.trackingGateway.getById(projectPath, existing.id) ?? existing;
+    }
+    createNew(projectPath, mrId, mrInfo, assignedBy) {
+        const now = new Date().toISOString();
+        const trackedMr = {
+            id: mrId,
+            mrNumber: mrInfo.mrNumber,
+            title: mrInfo.title,
+            url: mrInfo.url,
+            project: mrInfo.project,
+            platform: mrInfo.platform,
+            sourceBranch: mrInfo.sourceBranch,
+            targetBranch: mrInfo.targetBranch,
+            assignment: {
+                username: assignedBy.username,
+                displayName: assignedBy.displayName,
+                assignedAt: now,
+            },
+            state: 'pending-review',
+            openThreads: 0,
+            totalThreads: 0,
+            createdAt: now,
+            lastReviewAt: null,
+            lastPushAt: null,
+            approvedAt: null,
+            mergedAt: null,
+            reviews: [],
+            totalReviews: 0,
+            totalFollowups: 0,
+            totalBlocking: 0,
+            totalWarnings: 0,
+            totalSuggestions: 0,
+            totalDurationMs: 0,
+            averageScore: null,
+            latestScore: null,
+            autoFollowup: true,
+        };
+        this.trackingGateway.create(projectPath, trackedMr);
+        return trackedMr;
+    }
+}
+//# sourceMappingURL=trackAssignment.usecase.js.map

package/dist/usecases/tracking/trackAssignment.usecase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackAssignment.usecase.js","sourceRoot":"","sources":["../../../src/usecases/tracking/trackAssignment.usecase.ts"],"names":[],"mappings":"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"}

package/dist/usecases/tracking/transitionState.usecase.d.ts

@@ -0,0 +1,14 @@
+import type { UseCase } from '../../shared/foundation/usecase.base.js';
+import type { ReviewRequestTrackingGateway } from '../../interface-adapters/gateways/reviewRequestTracking.gateway.js';
+interface TransitionStateInput {
+    projectPath: string;
+    mrId: string;
+    targetState: 'approved' | 'merged' | 'closed';
+}
+export declare class TransitionStateUseCase implements UseCase<TransitionStateInput, boolean> {
+    private readonly trackingGateway;
+    constructor(trackingGateway: ReviewRequestTrackingGateway);
+    execute(input: TransitionStateInput): boolean;
+}
+export {};
+//# sourceMappingURL=transitionState.usecase.d.ts.map

package/dist/usecases/tracking/transitionState.usecase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionState.usecase.d.ts","sourceRoot":"","sources":["../../../src/usecases/tracking/transitionState.usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oEAAoE,CAAC;AAGvH,UAAU,oBAAoB;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC/C;AAOD,qBAAa,sBAAuB,YAAW,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,4BAA4B;IAE1E,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO;CAa9C"}

package/dist/usecases/tracking/transitionState.usecase.js

@@ -0,0 +1,22 @@
+const TIMESTAMP_BY_STATE = {
+    approved: 'approvedAt',
+    merged: 'mergedAt',
+};
+export class TransitionStateUseCase {
+    trackingGateway;
+    constructor(trackingGateway) {
+        this.trackingGateway = trackingGateway;
+    }
+    execute(input) {
+        const mr = this.trackingGateway.getById(input.projectPath, input.mrId);
+        if (!mr)
+            return false;
+        const timestampField = TIMESTAMP_BY_STATE[input.targetState];
+        this.trackingGateway.update(input.projectPath, input.mrId, {
+            state: input.targetState,
+            ...(timestampField ? { [timestampField]: new Date().toISOString() } : {}),
+        });
+        return true;
+    }
+}
+//# sourceMappingURL=transitionState.usecase.js.map

package/dist/usecases/tracking/transitionState.usecase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionState.usecase.js","sourceRoot":"","sources":["../../../src/usecases/tracking/transitionState.usecase.ts"],"names":[],"mappings":"AAUA,MAAM,kBAAkB,GAA0E;IAChG,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,UAAU;CACnB,CAAC;AAEF,MAAM,OAAO,sBAAsB;IACJ;IAA7B,YAA6B,eAA6C;QAA7C,oBAAe,GAAf,eAAe,CAA8B;IAAG,CAAC;IAE9E,OAAO,CAAC,KAA2B;QACjC,MAAM,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvE,IAAI,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QAEtB,MAAM,cAAc,GAAG,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAE7D,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE;YACzD,KAAK,EAAE,KAAK,CAAC,WAAW;YACxB,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/usecases/triggerReview.usecase.d.ts

@@ -0,0 +1,41 @@
+import type { Logger } from 'pino';
+import type { ReviewJob } from '../queue/reviewQueue.js';
+import type { ReviewRequestTrackingGateway, Platform } from '../interface-adapters/gateways/reviewRequestTracking.gateway.js';
+export interface TriggerReviewParams {
+    platform: Platform;
+    projectPath: string;
+    localPath: string;
+    reviewRequestNumber: number;
+    title: string;
+    sourceBranch: string;
+    targetBranch: string;
+    mrUrl: string;
+    skill: string;
+    jobType?: 'review' | 'followup';
+    assignedBy?: {
+        username: string;
+        displayName?: string;
+    };
+}
+export type TriggerReviewResult = {
+    status: 'success';
+    jobId: string;
+} | {
+    status: 'deduplicated';
+    reason: string;
+} | {
+    status: 'failed';
+    reason: string;
+};
+export interface ReviewQueuePort {
+    hasActiveJob(jobId: string): boolean;
+    enqueue(job: ReviewJob): boolean;
+    createJobId(platform: string, projectPath: string, mrNumber: number): string;
+}
+export interface TriggerReviewDependencies {
+    queuePort: ReviewQueuePort;
+    reviewRequestTrackingGateway: ReviewRequestTrackingGateway;
+    logger: Logger;
+}
+export declare function triggerReview(params: TriggerReviewParams, deps: TriggerReviewDependencies): TriggerReviewResult;
+//# sourceMappingURL=triggerReview.usecase.d.ts.map

package/dist/usecases/triggerReview.usecase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggerReview.usecase.d.ts","sourceRoot":"","sources":["../../src/usecases/triggerReview.usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,4BAA4B,EAAE,QAAQ,EAAE,MAAM,iEAAiE,CAAC;AAE9H,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAChC,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC;IACjC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9E;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,eAAe,CAAC;IAC3B,4BAA4B,EAAE,4BAA4B,CAAC;IAC3D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,yBAAyB,GAC9B,mBAAmB,CA8CrB"}

package/dist/usecases/triggerReview.usecase.js

@@ -0,0 +1,34 @@
+export function triggerReview(params, deps) {
+    const { queuePort, reviewRequestTrackingGateway, logger } = deps;
+    const jobIdPrefix = params.jobType === 'followup'
+        ? `${params.platform}-followup`
+        : params.platform;
+    const jobId = queuePort.createJobId(jobIdPrefix, params.projectPath, params.reviewRequestNumber);
+    if (queuePort.hasActiveJob(jobId)) {
+        logger.info({ jobId }, 'Review already in progress, deduplicating');
+        return { status: 'deduplicated', reason: 'Review already in progress' };
+    }
+    const job = {
+        id: jobId,
+        platform: params.platform,
+        projectPath: params.projectPath,
+        localPath: params.localPath,
+        mrNumber: params.reviewRequestNumber,
+        skill: params.skill,
+        mrUrl: params.mrUrl,
+        sourceBranch: params.sourceBranch,
+        targetBranch: params.targetBranch,
+        jobType: params.jobType,
+        title: params.title,
+        assignedBy: params.assignedBy,
+    };
+    const enqueued = queuePort.enqueue(job);
+    if (!enqueued) {
+        logger.warn({ jobId }, 'Failed to enqueue job');
+        return { status: 'failed', reason: 'Queue full or job rejected' };
+    }
+    reviewRequestTrackingGateway.recordPush(params.localPath, params.reviewRequestNumber, params.platform);
+    logger.info({ jobId, reviewRequestNumber: params.reviewRequestNumber, jobType: params.jobType }, 'Review triggered');
+    return { status: 'success', jobId };
+}
+//# sourceMappingURL=triggerReview.usecase.js.map

package/dist/usecases/triggerReview.usecase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggerReview.usecase.js","sourceRoot":"","sources":["../../src/usecases/triggerReview.usecase.ts"],"names":[],"mappings":"AAsCA,MAAM,UAAU,aAAa,CAC3B,MAA2B,EAC3B,IAA+B;IAE/B,MAAM,EAAE,SAAS,EAAE,4BAA4B,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEjE,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,KAAK,UAAU;QAC/C,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,WAAW;QAC/B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACpB,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAEjG,IAAI,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,2CAA2C,CAAC,CAAC;QACpE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;IAC1E,CAAC;IAED,MAAM,GAAG,GAAc;QACrB,EAAE,EAAE,KAAK;QACT,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,mBAAmB;QACpC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;IAEF,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,uBAAuB,CAAC,CAAC;QAChD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACpE,CAAC;IAED,4BAA4B,CAAC,UAAU,CACrC,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,mBAAmB,EAC1B,MAAM,CAAC,QAAQ,CAChB,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EACnF,kBAAkB,CACnB,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "reviewflow",
+  "version": "3.0.0",
+  "description": "AI-powered code review automation for GitLab/GitHub using Claude Code",
+  "type": "module",
+  "main": "dist/main/server.js",
+  "bin": {
+    "reviewflow": "dist/main/cli.js"
+  },
+  "license": "MIT",
+  "author": "Damien Gouron",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DGouron/review-flow.git"
+  },
+  "bugs": {
+    "url": "https://github.com/DGouron/review-flow/issues"
+  },
+  "homepage": "https://github.com/DGouron/review-flow#readme",
+  "files": [
+    "dist/",
+    "templates/",
+    "scripts/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "code-review",
+    "claude",
+    "ai",
+    "webhook",
+    "gitlab",
+    "github",
+    "merge-request",
+    "pull-request",
+    "automation",
+    "reviewflow"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/main/cli.ts start --skip-dependency-check",
+    "build": "tsc && node scripts/copyAssets.mjs",
+    "start": "node dist/main/cli.js start",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:ci": "vitest --run",
+    "coverage": "vitest --coverage",
+    "lint": "biome check src/",
+    "lint:fix": "biome check --write src/",
+    "verify": "yarn typecheck && yarn lint && yarn test:ci",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  },
+  "dependencies": {
+    "@fastify/static": "^8.0.0",
+    "@fastify/websocket": "^11.0.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "dotenv": "^16.4.0",
+    "fastify": "^5.0.0",
+    "p-queue": "^8.0.0",
+    "pino": "^8.18.0",
+    "pino-pretty": "^10.3.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.0",
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/ui": "^4.0.18",
+    "tsx": "^4.7.0",
+    "typescript": "^5.8.0",
+    "vitepress": "^1.6.4",
+    "vitest": "^4.0.18",
+    "vue": "^3.5.27"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/scripts/copyAssets.mjs

@@ -0,0 +1,10 @@
+import { cpSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const rootDir = join(dirname(fileURLToPath(import.meta.url)), '..');
+const source = join(rootDir, 'src', 'interface-adapters', 'views', 'dashboard');
+const target = join(rootDir, 'dist', 'interface-adapters', 'views', 'dashboard');
+
+mkdirSync(dirname(target), { recursive: true });
+cpSync(source, target, { recursive: true });

package/scripts/launcher.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+
+# Claude Review Automation Launcher
+# Starts the server and opens the dashboard in the browser
+
+PROJECT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+PORT=3847
+LOG_FILE="$PROJECT_DIR/logs/server.log"
+
+# Create logs directory if needed
+mkdir -p "$PROJECT_DIR/logs"
+
+# Check if server is already running
+if lsof -i :$PORT > /dev/null 2>&1; then
+    # Server already running, just open dashboard
+    xdg-open "http://localhost:$PORT/dashboard/" &
+    exit 0
+fi
+
+# Start server in background
+cd "$PROJECT_DIR"
+nohup yarn dev > "$LOG_FILE" 2>&1 &
+
+# Wait for server to be ready
+echo "Starting server..."
+for i in {1..30}; do
+
+    if curl -s "http://localhost:$PORT/health" > /dev/null 2>&1; then
+        break
+    fi
+    sleep 0.5
+done
+
+# Open dashboard
+xdg-open "http://localhost:$PORT/dashboard/" &

package/templates/SETUP.md

@@ -0,0 +1,183 @@
+# Project Setup for Automatic Reviews
+
+## Required Structure
+
+In your project, create the following structure:
+
+```
+.claude/
+├── reviews/
+│   └── config.json          # Review configuration
+└── skills/
+    └── review-{{type}}/     # Review skill
+        └── SKILL.md
+```
+
+## 1. Configuration (`config.json`)
+
+Copy `config.json.template` to `.claude/reviews/config.json`:
+
+```json
+{
+  "github": false,
+  "gitlab": true,
+  "defaultModel": "opus",
+  "reviewSkill": "review-front",
+  "reviewFollowupSkill": "review-followup",
+  "agents": [
+    { "name": "clean-architecture", "displayName": "Clean Archi" },
+    { "name": "ddd", "displayName": "DDD" },
+    { "name": "testing", "displayName": "Testing" },
+    { "name": "code-quality", "displayName": "Code Quality" }
+  ]
+}
+```
+
+### Options
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `github` | boolean | Enable GitHub webhooks |
+| `gitlab` | boolean | Enable GitLab webhooks |
+| `defaultModel` | string | Claude model (`opus`, `sonnet`, `haiku`) |
+| `reviewSkill` | string | Main review skill name |
+| `reviewFollowupSkill` | string | Follow-up skill name |
+| `agents` | array | Agent list for the dashboard |
+
+### Agents
+
+Agents define what appears on the dashboard:
+
+```json
+{
+  "name": "clean-architecture",   // Unique ID (kebab-case)
+  "displayName": "Clean Archi"    // Display name
+}
+```
+
+**Important**: Agent names must match the `[PROGRESS:name:status]` markers in the skill.
+
+---
+
+## 2. Review Skill (`SKILL.md`)
+
+Copy `SKILL.md.template` to `.claude/skills/review-{{type}}/SKILL.md`.
+
+### Customization
+
+1. Replace `{{...}}` variables
+2. Define your audit agents
+3. Adapt rules to your project
+
+### Required Markers
+
+For real-time tracking, the skill must emit:
+
+```
+[PHASE:initializing]           # Starting
+[PHASE:agents-running]         # Agents running
+[PROGRESS:agent-name:started]  # Agent started
+[PROGRESS:agent-name:completed]# Agent completed
+[PHASE:synthesizing]           # Synthesis
+[PHASE:publishing]             # Publishing
+[PHASE:completed]              # Done
+
+[REVIEW_STATS:blocking=X:warnings=X:suggestions=X:score=X]
+```
+
+---
+
+## 3. Server Configuration
+
+In `~/.config/reviewflow/config.json`:
+
+```json
+{
+  "port": 3847,
+  "webhookSecretGitlab": "your-gitlab-secret",
+  "webhookSecretGithub": "your-github-secret",
+  "gitlabUser": "your-gitlab-username",
+  "githubUser": "your-github-username",
+  "repositories": [
+    {
+      "projectPath": "group/project-name",
+      "localPath": "/path/to/project",
+      "skill": "review-front"
+    }
+  ]
+}
+```
+
+---
+
+## 4. Webhooks
+
+### GitLab
+
+1. Go to **Settings > Webhooks**
+2. URL: `http://your-server:3847/webhooks/gitlab`
+3. Secret Token: your `webhookSecretGitlab`
+4. Trigger: `Merge request events`
+
+### GitHub
+
+1. Go to **Settings > Webhooks**
+2. URL: `http://your-server:3847/webhooks/github`
+3. Secret: your `webhookSecretGithub`
+4. Events: `Pull requests`
+
+---
+
+## 5. Verification
+
+1. Assign yourself as reviewer on a MR/PR
+2. Check the dashboard: http://localhost:3847
+3. The review should trigger automatically
+
+---
+
+## Specialized Skill Examples
+
+### Frontend (React/Vue/Angular)
+
+```json
+{
+  "agents": [
+    { "name": "clean-architecture", "displayName": "Clean Archi" },
+    { "name": "react-best-practices", "displayName": "React" },
+    { "name": "solid", "displayName": "SOLID" },
+    { "name": "testing", "displayName": "Testing" },
+    { "name": "accessibility", "displayName": "A11y" },
+    { "name": "code-quality", "displayName": "Quality" }
+  ]
+}
+```
+
+### Backend (Node/Python/Go)
+
+```json
+{
+  "agents": [
+    { "name": "clean-architecture", "displayName": "Clean Archi" },
+    { "name": "ddd", "displayName": "DDD" },
+    { "name": "solid", "displayName": "SOLID" },
+    { "name": "api-design", "displayName": "API Design" },
+    { "name": "security", "displayName": "Security" },
+    { "name": "testing", "displayName": "Testing" }
+  ]
+}
+```
+
+### API (REST/GraphQL)
+
+```json
+{
+  "agents": [
+    { "name": "api-design", "displayName": "API Design" },
+    { "name": "security", "displayName": "Security" },
+    { "name": "performance", "displayName": "Performance" },
+    { "name": "documentation", "displayName": "Documentation" },
+    { "name": "testing", "displayName": "Testing" }
+  ]
+}
+```