aptratcn/cognitive-debt-guard

cognitive-debt-guard は何をしますか？

Cognitive Debt Guard - AI生成コードによる23.5%のインシデント急増を防止。理解度ゲート、レビューフレームワーク、AIフリーゾーン。

概要

Cognitive Debt Guard（認知負債ガード）は、AIエージェントが生成したコードが原因で発生する「認知負債」を管理・軽減するためのツールです。AIが生成したコードをそのまま受け入れると、コードベースの理解度が低下し、後々のインシデントリスクが増大します。このスキルは、そのリスクを可視化し、予防するためのフレームワークを提供します。

主な機能

• 理解度ゲート: 開発者がAI生成コードをコミットする前に、そのコードの動作や影響を十分に理解していることを確認します。
• レビューフレームワーク: AI生成コードに特化したレビュー基準を提供し、従来の人間によるコードレビューでは見逃しがちなパターンを検出します。
• AIフリーゾーン: 特定のコード領域を「AIフリーゾーン」として宣言し、AIエージェントによる変更を禁止します。これにより、重要なロジックやセキュリティクリティカルな部分を保護します。

対応プラットフォーム

• Claude Code
• Cursor
• Codex (OpenAI)

使用方法

1. プロジェクトのルートディレクトリに.cognitive-debt-guard.ymlを作成します。
2. 以下の設定を記述します。

gates:
  comprehension:
    enabled: true
    require_explanation: true
    max_unreviewed_lines: 50

review_framework:
  enabled: true
  rules:
    - pattern: "TODO|FIXME|HACK"
      severity: warning
    - pattern: "gpt-.*?\-\-"
      severity: critical

free_zones:
  - path: "src/core/*"
  - path: "src/security/*"

3. AIエージェントがこの設定を読み取り、各機能を適用します。

詳細設定

各機能の詳細な設定オプションについては、公式ドキュメントを参照してください。

ライセンス

MIT