gszhangwei/open-spdd

何を解決するか

OpenSPDDは、一時的なAIコーディングプロンプトや曖昧な計画書がAIの即興的生成、トレーサビリティの欠如、設計のずれを引き起こす問題に対処します。AIプロンプトを実行可能な設計契約に変換し、AIが高レベルなタスクリストを生成するのではなく、正確なアーキテクチャパターンとコーディング規準に従うことを保証します。

仕組み

このプロジェクトは、Cursor、Claude Code、GitHub Copilotなど、さまざまなAIコーディング環境と統合できるクロスプラットフォームCLIツールを提供します。REASONS Canvas（要件、エンティティ、アプローチ、構造、操作、規範、セーフガードの7次元構造化設計フレームワーク）を実装し、機能の「なぜ」「何」「どのように」を定義します。

ユーザーは以下の構造化されたワークフローに従います：戦略的分析 → REASONS Canvasの生成 → コード生成 → リバース同期。CLIツールは、AIツールのネイティブコマンドシステム内でこれらのステップをトリガーするために必要なテンプレートとコマンドファイルを管理します。

対象ユーザー

• エンタープライズ開発者：設計と実装のトレーサビリティ、長期的な保守性が必要な方。
• 開発チーム：スタイルの衝突を減らすために統一されたAIコーディング基準を求める方。
• アーキテクト：依存関係の混乱を防ぐために厳密な操作順序が必要な複雑なリファクタリングを行う方。

特徴

• 双方向同期：コードの変更を設計文書に同期して、プロンプトと実装の整合性を維持可能。
• クロスプラットフォーム対応：Cursor、Claude Code、GitHub Copilot、Antigravity、OpenCode、Codexに対応。
• 構造化フレームワーク：REASONS Canvasを使用して、明確なメソッドシグネチャ、エラーハンドリング、DIパターンを指定可能。曖昧な指示ではなく、正確な指示が可能。
• 自動検出：アクティブなAIコーディング環境を自動認識し、正しいコマンドディレクトリを設定。