Claude Code でコードレビューを完全自動化する―ハーネスエンジニアリングの実装パターン

# MyProject — CLAUDE.md
 
## 最重要ルール
 
### 1. TypeScript 厳密モード必須
- `strict: true` をtsconfig.jsonで有効化
- 暗黙の `any` は禁止
- 理由: ビルド時型安全性確保
 
### 2. テストファイルは src/tests/ に集約
- ❌ src/components/Button.test.tsx
- ✓ src/tests/components/Button.test.tsx
- 理由: ファイル構造の明確化、npm test での統一
 
### 3. 外部ライブラリ追加禁止
許可ライブラリ:
- react, react-dom
- typescript
- vitest, playwright
 
禁止ライブラリ:
- lodash (既存のユーティリティで十分)
- moment, date-fns (Intl API で対応)
- axios (fetch で十分)
 
理由: バンドルサイズ管理、脆弱性最小化
 
### 4. CSS は Tailwind CSS のみ
- ❌ styled-components, emotion
- ✓ Tailwind className
- 理由: CSS-in-JS のランタイム脱依存
 
### 5. スナップショットテスト禁止
- ❌ expect(output).toMatchSnapshot()
- ✓ expect(output).toBe('expected')
- 理由: スナップショット更新の誤爆防止
 
## 設計方針
 
### アーキテクチャの3層構造

npm run lint:fix  # 自動修正可能なエラーを直す

# Claude Code で以下の指示を実行:
"Review payment.ts against CLAUDE.md rules"

# Claude Code が以下を実行:
npm run lint:fix        # Lint自動修正
npm run type-check      # TypeScript型チェック
npm run test:unit       # ユニットテスト実行
npm run test:integration # 統合テスト実行

# 全テストが pass したら自動コミット
git add .
git commit -m "feat: payment system - auto-reviewed by Claude Code"
git push origin feature/payment

## 責務の定義
- 「1つの責務 = 1つのビジネスルール変更で影響を受ける処理」
- 以下は「1つの責務」としてカウント:
  ✓ 複数のステップ（入力検証 → 計算 → 出力）
  ✗ 関数が呼ぶ他の関数の数（関数の粒度ではない）
 
## 許容基準
- 関数行数: < 300行
- 循環複雑度: < 10
- ネスト深度: < 3

## 修正の優先度（矛盾は禁止）
1. TypeScript 型エラー（非交渉）
2. テスト失敗（非交渉）
3. アーキテクチャ違反（修正必須）
4. ケーススタイル・命名（修正推奨）
5. コメント不足（追加推奨）
 
ルール:
- Priority 1-3 は修正しない限り再指摘しない
- Priority 4-5 で矛盾する指摘は2回目以降は指摘しない

## Step 4: Verify（バリデーション）チェックリスト
- [ ] TypeScript コンパイル成功: tsc --noEmit
- [ ] ユニットテスト pass: npm test
- [ ] 統合テスト pass: npm run test:integration
- [ ] Lint エラーゼロ: npm run lint
- [ ] ビルド成功: npm run build
 
全てチェック済みまで Correct ステップに戻らない

// mcp-code-review/index.ts
import Anthropic from "@anthropic-sdk/sdk";
 
const client = new Anthropic({
  apiKey: process.env.ANTHROPIC_API_KEY,
});
 
interface ReviewRequest {
  filePath: string;
  rules: string;  // CLAUDE.md の内容
}
 
async function reviewCode(req: ReviewRequest): Promise<string> {
  // ステップ1: ファイル読み込み
  const fileContent = await fs.readFile(req.filePath, "utf-8");
 
  // ステップ2: Claude でレビュー実行
  const review = await client.messages.create({
    model: "claude-opus-4-1",
    max_tokens: 4096,
    messages: [
      {
        role: "user",
        content: `
You are a code reviewer using Harness Engineering principles.
 
Rules (from CLAUDE.md):
${req.rules}
 
File to review:
${fileContent}
 
Follow these steps:
1. Check each rule violation
2. Categorize by priority (Critical/High/Medium/Low)
3. Suggest fixes ONLY for Critical/High
4. For each suggestion, explain why
 
Output format:
PRIORITY: <level>
RULE: <violated rule>
ISSUE: <description>
FIX: <suggested code>
---
        `,
      },
    ],
  });
 
  return review.content[0].type === "text" ? review.content[0].text : "";
}
 
// ステップ3: トリアージ
function triageReview(review: string): Map<string, string[]> {
  const issues = new Map<string, string[]>();
 
  review.split("---").forEach((block) => {
    const priorityMatch = block.match(/PRIORITY: (\w+)/);
    if (priorityMatch) {
      const priority = priorityMatch[1];
      issues.set(priority, [...(issues.get(priority) || []), block]);
    }
  });
 
  return issues;
}
 
// ステップ4: 自動修正
async function autoFix(
  filePath: string,
  issues: string[]
): Promise<boolean> {
  // Critical/High のみ修正
  const criticalsAndHighs = issues.filter((i) =>
    i.match(/PRIORITY: (Critical|High)/)
  );
 
  if (criticalsAndHighs.length === 0) {
    return true;  // 修正対象なし
  }
 
  const fixPrompt = criticalsAndHighs.map((i) => i.match(/FIX: ([\s\S]+?)---/)?.[1]).join("\n");
 
  const fixed = await client.messages.create({
    model: "claude-opus-4-1",
    max_tokens: 4096,
    messages: [
      {
        role: "user",
        content: `Apply these fixes to the code:\n${fixPrompt}`,
      },
    ],
  });
 
  // ステップ5: バリデーション
  await execSync("npm test", { cwd: process.cwd() });
  await execSync("npm run lint", { cwd: process.cwd() });
 
  return true;
}
 
// メイン処理: 最大6ループ
async function reviewLoop(filePath: string, rules: string) {
  let iteration = 0;
  const maxIterations = 6;
 
  while (iteration < maxIterations) {
    iteration++;
 
    // Step 2: レビュー
    const review = await reviewCode({ filePath, rules });
 
    // Step 3: トリアージ
    const triaged = triageReview(review);
 
    // Critical/High がなければ終了
    if (
      !triaged.has("Critical") &&
      !triaged.has("High")
    ) {
      console.log(`✓ Review passed after iteration ${iteration}`);
      return;
    }
 
    // Step 4: 自動修正
    const fixed = await autoFix(
      filePath,
      Array.from(triaged.values()).flat()
    );
    if (!fixed) {
      console.log(`✗ Auto-fix failed at iteration ${iteration}`);
      return;
    }
  }
 
  console.log(`⚠ Max iterations (${maxIterations}) reached`);
}