gszhangwei/open-spdd

解決する課題

OpenSPDDは、「使い捨て」のAIコーディングプロンプトや、制約・精度・トレーサビリティを欠いた曖昧な計画ドキュメントの問題に対処します。プロンプトを「実行可能な設計契約」に変換することで、AIが勝手にコードを再構築したり、自由気ままに生成したりすることを防ぎ、設計と実際の実装が常に同期している状態を保証します。

仕組み

本プロジェクトは、7次元の構造化設計フレームワークである REASONS Canvas（Requirements, Entities, Approach, Structure, Operations, Norms, and Safeguards）を実装したクロスプラットフォームCLIツールを提供します。

ユーザーは以下のワークフローに従います：

1. 分析 (Analysis)：要件の戦略的分析を行う。
2. 設計 (Design)：REASONS Canvas設計ドキュメントを生成する。
3. 生成 (Generation)：キャンバスを契約として使用し、AIに正確なコードを生成させる。
4. 同期 (Sync)：コードのリファクタリングや変更が行われた際、逆同期コマンドを使用して設計ドキュメントを更新する。

対象ユーザー

• エンタープライズ開発者：設計と実装のトレーサビリティおよび長期的な保守性が必要な方。
• 開発チーム：AIコーディングの標準を統一し、スタイルの競合を減らしたいチーム。
• 複雑なリファクタリングを行う開発者：依存関係の混乱を避けるために厳格な操作順序を必要とする方。

ハイライト

• クロスプラットフォーム対応：Cursor, Claude Code, GitHub Copilot, Antigravity, OpenCode, Codexをサポート。
• 双方向同期：コード内の変更を設計プロンプトに同期させることが可能。
• 構造化フレームワーク：単純なタスクリストを、メソッドシグネチャ、DIパターン、エラーハンドリングを明記した詳細な契約に置き換えます。
• 自動検出：AIコーディング環境を自動的に識別し、適切な設定を適用します。