【要約】skillsに全振りしてdocs,rules,commandsを削るコスパ重視のハーネス実装案 [Qiita_Trend] | Summary by TechDistill
> Source: Qiita_Trend
Execute Primary Source
// Problem
開発者が Claude Code や Cursor などの複数のAIエージェントを併用する際、プロジェクトの指示管理が複雑化するという問題に直面している。各ツールが独自の管理構造を持つため、以下の課題が発生する。
- ・プロバイダーごとに専用の構造（rules等）を維持する必要があり、管理が重くなる。
- ・同じ指示を複数の場所に記述することによる、重複管理のコストが増大する。
- ・指示の総量が増えると、AIのコンテキストが肥大化し、推論精度が低下する。
// Approach
管理コストの最小化とスケーラビリティ確保のため、プロジェクトルートに 'skills/' を配置する構成を採用する。指示の性質に応じて、以下の二段構えで運用する。
- ・重要スキルの管理：CLAUDE.md や AGENTS.md に、常時参照すべき少数の重要スキルを記述する。
- ・多数スキルの管理：それ以外の膨大なスキルは 'skills/' に格納し、検索システム経由で呼び出す。
- ・検索の高度化：トリガーワードとセマンティック検索を組み合わせたハイブリッド検索により、必要な時に必要なスキルを抽出する。
- ・構造の統合：docs, rules, commands の役割をすべて 'skills/' に集約し、一元管理を実現する。
// Result
この構成により、プロバイダーの差異に依存しない、シンプルで破綻しにくいプロジェクト構造を実現できる。具体的には以下の成果が得られる。
- ・重複管理の解消：SSOTを確立することで、指示の更新漏れや矛盾を防げる。
- ・スケーラビリティの向上：コンテキストの肥大化を抑え、大規模な指示セットでも精度を維持できる。
- ・将来的な拡張性：指示の中に scripts や references を組み込みやすく、高度な自動化へ移行しやすい。
Senior Engineer Insight
> 非常に合理的かつ実戦的な設計思想である。従来の「全自動でルールを適用させる」アプローチは、コンテキストの肥大化によりLLMの推論精度を落とすリスクがある。本案のように、指示を「検索可能なスキル」として定義し、オンデマンドに注入する戦略は、大規模プロジェクトにおけるAI活用において不可欠だ。ただし、検索精度が開発体験（DX）のボトルネックになるため、ハイブリッド検索基盤の整備が運用の成否を分けるだろう。