Gentleman-Programming/gentle-pi

解決する課題

多くのAIコーディングエージェントの失敗は、モデルの知能不足ではなく、運用上の乱れによるものです。一般的な問題には、要件が明確になる前にコードに飛び込むこと、チャット履歴にアーキテクチャの意思決定が失われること、巨大なプルリクエストを作成すること、テストを軽視することなどがあります。gentle-pi は、エンジニアリングの厳格さと構造化されたワークフローを強制することで、Piコーディングエージェントを制御された開発ハーネスに変換します。

動作方法

「シニアアーキテクト」オペレーティングレイヤーとして el Gentleman をPiにインストールします。このレイヤーは、Spec-Driven Development (SDD) と OpenSpec を導入し、大規模またはリスクの高い変更が初期化、設計、検証の厳格なパイプラインを経由することを保証します。複雑さに応じて作業をルーティング：小さな編集はインラインで処理、コンテキストが重い探索は集中型サブエージェントに委任、アーキテクチャ変更はSDDフローをトリガーします。

品質を維持するために、厳格なTDD（テスト駆動開発）サポートを実装し、RED → GREEN → TRIANGULATE → REFACTOR のサイクルの証拠を要求します。また、検証済みのネイティブランタイムを統合し、破壊的なシェルコマンドをブロックし、機密ファイルパスへのアクセスを保護します。

対象ユーザー

Piコーディングエージェントを使用し、単純なチャットベースのコーディングから、レビュー可能な作業単位とアーキテクチャのガードレールを備えた、厳格でプロフェッショナルなエンジニアリング環境へ移行したい開発者。

主な特徴

• Spec-Driven Development (SDD): 複雑な変更を処理するための段階エージェント（初期化、設計、タスク、検証など）の構造化されたチェーンを提供。
• サブエージェントオーケストレーション: 専門的な子エージェントに探索や実装を委任することで、親セッションを軽量化。
• uma Skill Discovery Registry: プロジェクトおよびユーザーのスキルを登録・管理し、タスクに適切な専門知識を適用。
• 厳格なTDD証拠: プロジェクト設定で要求された場合、テスト駆動開発サイクルの記録を強制。
• ランタイムの安全性: 破壊的なコマンドや機密パスへのアクセスをブロックする検証済みネイティブランタイムを含む。