disler/super-simple-software-factory

何を解決するか

Super Simple Software Factory (SSSF) は、AI駆動のソフトウェア開発における一貫性の欠如と可視性の不足を解決します。単一のエージェントループが予測不能で、明確なフェーズ境界がなく、デバッグが困難な「縫い目のないマシン」問題を防ぎます。コントロールプレーンをプロンプトから決定論的なPythonコードに移行することで、ソフトウェアの作成が再現可能で、ゲート付き、可視化可能になることを保証します。

動作方法

SSSFは コードがループを所有する という原則に基づいています。エージェントはそのループ内の制限されたノードとして機能します。AI Developer Workflow (ADW) スクリプトを使用して、シーケンシング、リトライ、受容基準を管理します。

• フェーズ: すべての実行はフェーズのシーケンスです。これらは agent フェーズ（特定のエージェントが呼び出される）または code フェーズ（テストの実行やGitへのコミットなど、決定論的なPython/bashステップ）です。
• エージェントロスター: YAML設定ファイルで各エージェントのアイデンティティ（モデル、プロンプト、ツール、境界）を定義します。これにより、異なるタスクに異なるモデルを使用可能になります（例：計画にはフロンティアモデル、構築には安価なモデル）。
• エンベロープとゲート: エージェントは型指定されたJSONエンベロープを通じて通信します。エージェントが終了すると、「ゲート」（自動チェック）がエージェントの主張を検証します（例：ファイルが実際に存在するか、テストが通るか）。ゲートが失敗した場合、システムは同じセッション内でエージェントに再プロンプトを送り、プロセス全体を再起動するのではなく修正を促します。
• 可視性: すべてのイベント（ツール呼び出しを含む）がリアルタイムでSQLiteデータベースにストリーミングされます。提供されるVue/Viteビジュアライザーにより、トレースウォーターフォールを通じて実行中のモニタリングが可能になります。

対象ユーザー

プロンプトの単純な使用から脱却し、エージェントとコードの構造化されたシステムへと進むことで、再現可能でプロフェッショナルなAIエージェントワークフローをコーディングタスクに構築したいソフトウェアエンジニア。

特徴

• 決定論的なコントロールプレーン: シーケンシングとシーケンシングロジックをプロンプトからPythonに移行。
• エージェント-コードハイブリッド: エージェントの意思決定と決定論的なコード実行を明確に分離（例：bun test はエージェントタスクではなく、コードフェーズ）。
• カスタマイズ可能なロスター: 各エージェントごとにモデル、思考レベル、ツールアクセスをカスタマイズ可能。
• 厳格な境界: エージェントがリポジトリの不正な変更を防ぐために、読み取り専用または書き込み制限アクセスを強制。
• リアルタイムトレースUI: SQLiteデータベースをポーリングしてエージェント活動を監視する専用ビジュアライザー。
• 修正ループ: セッションベースの修正により、コンテキストを失うことなく、コールドリスタートのコストをかけずにエラーを修正。