codestable/CodeStable

何を解決するか

CodeStable は、長期的なソフトウェア開発プロジェクトにおける AI アシスタント開発のための軽量な「スキル契約」セットを提供します。AI エージェントが時間の経過とともにコンテキストや境界を失うのを防ぎ、AI の行動が根拠に基づき、プロジェクトの境界を尊重し、既存のプロジェクトドキュメントに知識を統合するよう保証します。これにより、重複した並列システムの作成を回避します。

仕組み

複雑なエージェントオーケストレーションや硬直的なスクリプトではなく、CodeStable は「薄いハーネス、濃いコンテキスト」のアプローチを採用しています。特定のスキル（例：cs-feat で機能実装、cs-issue でバグ修正）を定義することで、目標と境界を制約しつつ、AI モデルがリポジトリの事実に基づいて実行パスを自由に選択できるようにします。

主なメカニズム：

• 根拠に基づく成果交付：バグ修正の場合は「赤から緑」など、タスク完了前に検証を必須とします。
• プロジェクトメモリ：最小限のスケルトン（.codestable/）を用いて、重要なプロジェクト事実（attention.md）、検証済みの教訓（lessons/）、アクティブなタスクカーソル（work/）を追跡します。
• 正規の所有権：ドキュメントの重複を避け、安定した結論をプロジェクトの元の信頼できる情報源（ADRs、コード、既存ドキュメント）に返します。

対象ユーザー

• 数か月から数年かけて進化するソフトウェアプロジェクトに取り組むチーム。
• AI が効率的に実行する一方で、人間が製品の境界と最終承認を維持したい開発者。
• 検証可能な成果、独立したレビュー、異なる AI セッションやモデル間での知識再利用を重視するチーム。

特徴

• スキルベースのルーティング：8つの専門スキルを提供。アクションルーティング、オンボーディング、機能実装、問題診断、リファクタリング、エピック管理、レビュー、メモリ管理。
• ミニマリストメモリ：プロジェクトを肥大化させない、構造化された小さなディレクトリで高価値のプロジェクト事実と教訓を保存。
• エピック二層モデル：長期的な契約（目標／意思決定）と一時的な実行状態（進捗／根拠）を分離。
• プラグインエコシステム：Codex および Claude プラグインマーケットプレイスと統合可能。