WoJiSama/skill-based-architecture

解決する課題

コーディングエージェントは、分散したプロジェクトルール、複数のファイル（例：CLAUDE.md や .cursorrules）に重複する指示、そして明確な「完了定義」の欠如に苦しむことがよくあります。Skill-Based Architecture (SBA) は、これらの散在する指示を単一のルート可能で検証可能なプロジェクト「スキル」に統合し、エージェントがプロジェクトの実際のビジネスロジックやアーキテクチャルルールを推測せずに正確に遵守できるようにします。

動作方法

SBA はエージェントがリポジトリをナビゲートするためのプロジェクトレベルのオペレーティング契約を提供します。1つの巨大な指示ファイルを読み込むのではなく、エージェントは以下の手順を実行します：

1. インベントリ化：リポジトリを調査し、既存のルールを特定します。
2. 選択：ユーザーの要求に基づいて特定のワークフローを選択します。
3. ロード：現在の意思決定に必要な証拠と知識のみを読み込みます。
4. バインド：現在のコード所有者にビジネス意味を紐づけます。
5. 検証：単にコマンドやコミットを「完了」と見なすのではなく、要求された終端状態と照合して結果を検証します。
6. 記録：失敗から再利用可能な学びを記録し、再発を防ぎます。

対象者

プロジェクトの指示が大きすぎてナビゲートが困難になり、異なるエージェントエントリファイル間で矛盾が生じる、または繰り返しタスクに厳格な手順と信頼性の高い完了確認が必要な開発者やチームです。

特徴

• 中央集権的知識：AGENTS.md、CLAUDE.md、Cursorルール間の重複を排除します。
• エージェント非依存：Claude Code、Cursor、Windsurf、Gemini CLI、およびその他のファイル対応エージェントと互換性があります。
• 証拠に基づく実行：結果志向のライフサイクルを採用し、証拠が現在の前提を否定した場合はローカリゼーションまたは分解に戻ります。
• 自動移行：既存のルールをSBA構造に移行するプレビューと適用を可能にするスcaffoldツールを含みます。
• 厳格な完了管理：単なる活動（例：プッシュやコミット）ではなく、紐づけられた納品物と終端状態に基づいて「完了」を定義します。