coding-standards

問題点

AI が生成したコードはローカルでは動作しても、チーム固有のレビュー基準を満たさないことがよくあります。

Corbat は、実装前にエージェントへチームの標準を提示し、レビューや引き継ぎの前に検証ツールを提供することで支援します。

クイックスタート

1. MCP 設定に追加します：

{
  "mcpServers": {
    "corbat": {
      "command": "npx",
      "args": ["-y", "@corbat-tech/coding-standards-mcp"]
    }
  }
}

2. 設定ファイルの場所：

MCP 対応の一般的なツールについては、セットアップガイドをご覧ください。

3. 完了です。 Corbat は技術スタックを自動検出し、対応する標準を返します。

オーバーヘッドはゼロ。 Corbat はローカルで動作し、技術スタックの検出に約 50ms 追加されるだけです。その後は AI 向けのコンテキストとして機能します。

完全にカスタマイズ可能。 ルールが気に入らない場合は、.corbat.json で上書きできます。カスタマイズへ移動 →

動作を見る

You: "Create a user registration service"

Corbat なしの場合、次のようになります。

class UserService {
  private users: Map<string, User> = new Map();

  register(name: string, email: string, password: string) {
    if (!name || !email || !password) throw new Error('Invalid input');
    const user = { id: crypto.randomUUID(), name, email, password };
    this.users.set(user.id, user);
    return user;
  }
}
// ✗ Hardcoded storage  ✗ Password in plain text  ✗ Generic error  ✗ No tests

Corbat ありの場合、次のようになります。

// Domain
interface UserRepository {
  save(user: User): Promise<void>;
  findByEmail(email: string): Promise<User | null>;
}

class EmailAlreadyExistsError extends Error {
  constructor(email: string) {
    super(`Email already registered: ${email}`);
  }
}

// Application
class RegisterUserUseCase {
  constructor(
    private readonly repository: UserRepository,
    private readonly hasher: PasswordHasher
  ) {}

  async execute(input: RegisterUserInput): Promise<User> {
    const existing = await this.repository.findByEmail(input.email);
    if (existing) throw new EmailAlreadyExistsError(input.email);

    const user = User.create({
      ...input,
      password: await this.hasher.hash(input.password)
    });
    await this.repository.save(user);
    return user;
  }
}
// ✓ Repository interface  ✓ Password hashing  ✓ Custom error  ✓ Testable

// Test included
describe('RegisterUserUseCase', () => {
  const repository = { save: vi.fn(), findByEmail: vi.fn() };
  const hasher = { hash: vi.fn() };
  const useCase = new RegisterUserUseCase(repository, hasher);

  beforeEach(() => vi.clearAllMocks());

  it('should hash password before saving', async () => {
    repository.findByEmail.mockResolvedValue(null);
    hasher.hash.mockResolvedValue('hashed_password');

    await useCase.execute({ name: 'John', email: '[email protected]', password: 'secret' });

    expect(hasher.hash).toHaveBeenCalledWith('secret');
    expect(repository.save).toHaveBeenCalledWith(
      expect.objectContaining({ password: 'hashed_password' })
    );
  });

  it('should reject duplicate emails', async () => {
    repository.findByEmail.mockResolvedValue({ id: '1', email: '[email protected]' });

    await expect(
      useCase.execute({ name: 'John', email: '[email protected]', password: 'secret' })
    ).rejects.toThrow(EmailAlreadyExistsError);
  });
});

これは、引き継ぎの前にエージェントへ検討を促す構成の例です。

Corbat が提供するもの

Corbat は、生成前のガードレールと、反復作業中の検証チェックを提供します。

コード品質

アーキテクチャ

エラー処理

セキュリティを重視したチェック

ベンチマーク結果 v3.0

Corbat を6つの言語で15のシナリオにわたって評価しました。主要なベンチマークレポートの結果は一様ではないため、正直に読み取る必要があります。元の集計スコアでは、Corbat が勝ったのは15シナリオ中1つでした。一方、別の価値分析では、コードの簡潔さと保守性において、より優れた結果が示されました。

データが裏付けること

最も強く確認された傾向は、Corbat のガイドに沿った出力が、より短く、要点を絞ったものになることが多い点です。

これは、あらゆるケースで品質が向上すると主張するには不十分です。一部のワークフローでは、標準に関するコンテキストによって過剰なコード生成を抑えられることを示す証拠です。

価値指標

価値レポートでは、同じデータセットを効率性と保守性を重視する形で再評価しています。

📊 価値分析の詳細

セキュリティ：ベンチマークのパターン検出結果はありません

OWASP Top 10 のカテゴリを参考にしたパターンチェックを使って、すべてのシナリオを分析しました。これは、SAST、DAST、依存関係スキャン、手動レビュー、脅威モデリングに代わるものではありません。

• SQL／NoSQL インジェクションのパターンは検出されませんでした
• XSS のパターンは検出されませんでした
• ハードコードされた認証情報は検出されませんでした
• 境界に入力検証のパターンが存在しました
• ベンチマークのサンプルでは、エラーメッセージからスタックトレースが漏えいしていませんでした

テストした言語とパターン

📖 ベンチマークの全手法 · 価値分析

組み込みプロファイル

Corbat は技術スタックを自動検出し、適切な標準を適用します。

自動検出： Corbat は pom.xml、package.json、go.mod、Cargo.toml などを読み取ります。

Corbat を使う場面

Corbat が必要ない場合

• 品質が重要ではない簡易プロトタイプ
• 使い捨ての一度限りのスクリプト
• あえて失敗を経験したい学習用プロジェクト

カスタマイズ

オプション 1：対話型セットアップ

npx corbat-init

技術スタックを検出し、適切なデフォルト値を設定した .corbat.json を生成します。

オプション 2：手動設定

プロジェクトのルートに .corbat.json を作成します。

{
  "profile": "java-spring-backend",
  "architecture": {
    "pattern": "hexagonal",
    "layers": ["domain", "application", "infrastructure", "api"]
  },
  "quality": {
    "maxMethodLines": 20,
    "maxClassLines": 200,
    "minCoverage": 80
  },
  "rules": {
    "always": [
      "Use records for DTOs",
      "Prefer Optional over null"
    ],
    "never": [
      "Use field injection",
      "Catch generic Exception"
    ]
  }
}

オプション 3：テンプレートを使用する

Java、Python、Node.js、React、Go、Rust などの**すぐに使える 14 種類のテンプレートを参照**できます。

仕組み

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ Your Prompt │────▶│ Corbat MCP  │────▶│ AI + Rules  │
└─────────────┘     └──────┬──────┘     └─────────────┘
                          │
           ┌──────────────┼──────────────┐
           ▼              ▼              ▼
    ┌────────────┐ ┌────────────┐ ┌────────────┐
    │ 1. Detect  │ │ 2. Load    │ │ 3. Inject  │
    │   Stack    │ │  Profile   │ │ Guardrails │
    └────────────┘ └────────────┘ └────────────┘
     pom.xml        hexagonal      max 20 lines
     package.json   + DDD          + interfaces
     go.mod         + SOLID        + custom errors

Corbat は AI の出力を変更しません。コンテキスト、標準、プロファイル、検証フィードバックを提供し、エージェントがレビューの期待に沿えるようにします。

重要： 実際のコード品質は、モデル、ホストツール、プロンプト、リポジトリのコンテキスト、テスト、人によるレビューによって異なります。Corbat はポリシーと検証のレイヤーとして利用し、本番環境での利用に耐えられることを保証するものとは見なさないでください。

ドキュメント

{ "mcpServers": { "corbat": { "command": "npx", "args": ["-y", "@corbat-tech/coding-standards-mcp"] }}}