複雑なアプリやワークフローのロジックを管理する、状態機械・ステートチャート・アクター向けの依存関係ゼロのJavaScript/TypeScriptライブラリ。
ruvnet/sparc
Specification、Pseudocode、Architecture、Refinement、CompletionのSPARC 5フェーズを、TypeScriptのステートマシン、CLI、MCPサーバーで強制する、証拠に基づくエンジニアリングワークフローです。
- スター
- 479
- フォーク
- 90
- 未解決の Issue
- 38
- 最終コミット
- 11 時間前
これは何?
SPARCは、プロンプトに頼るのではなくコードによって、Specification、Pseudocode、Architecture、Refinement、Completionの5フェーズを強制するソフトウェア変更向けのワークフローフレームワークです。各フェーズには必須の成果物があり、ゲートを通過した場合にのみ次のフェーズへ進めます。変更操作では現在のリビジョンとの一致が必要で、再試行時には元のリクエストと完全に同じ内容だけが再実行されます。
このプロジェクトはnpm CLIに加え、ローカルのstdioとリモートのStreamable HTTPに対応するMCPトランスポートを提供し、ClaudeおよびOpenAI互換ホスト向けの共通スキルも備えています。Completionには、対象となるすべての受け入れテストについて、検証者が認証した合格証拠が必要であり、Ed25519署名を使って証拠を検証できます。実行は認証済みプリンシパルごとに分離され、状態は制限されたファイル権限でアトミックに書き込まれ、レシートチェーンは読み込み時に検証されます。
SPARCは開発の証拠を記録するものであり、実行内に保存された受け入れテストのコマンドを実行するものではありません。以前のバージョンのPython CLIも、互換性を保つため引き続き利用できます。
主な機能
- 01SPARCの5フェーズを決定論的なゲートによって順序どおりに進めます。
- 02リビジョンチェックと冪等性キーにより、競合する変更や重複した変更を防ぎます。
- 03Completionの前に、署名付きで検証者が認証したテスト証拠を必須とします。
- 04npm CLIと、ローカルおよびリモートのMCPサーバーを提供します。
- 05状態をプライベートに保ち、アトミックに書き込むことで、改ざんを検知できるようにします。
ユースケース
- 監査可能なフェーズゲートとテスト証拠を備えた、AI支援によるコード変更の実施。
- MCPを通じて、ClaudeやCodexに構造化された開発ワークフローを提供。
- 変更を完了として受け入れる前に、署名付きの検証結果を必須にする。
クイックスタート
- 1
doctor コマンドでインストールを確認します(Node.js 20 以降が必要です)
npx --yes @ruvnet/sparc@1.0.0 doctor - 2
SPARC の状態を初期化します
npx --yes @ruvnet/sparc@1.0.0 init - 3
要件と受け入れテストを含む run 定義の JSON ファイルを作成し、run を開始します
使う前に知っておきたいこと
- 合格および例外の証拠を確認するには、状態を読み書きするすべてのプロセスで Ed25519 検証用公開鍵を設定する必要があります。
- リモート MCP を使用するには、認証済みの HTTPS リバースプロキシと外部 ID プロバイダーが必要です。
収録されている特集
トピック
よくある質問
- sparc とは?
- Specification、Pseudocode、Architecture、Refinement、CompletionのSPARC 5フェーズを、TypeScriptのステートマシン、CLI、MCPサーバーで強制する、証拠に基づくエンジニアリングワークフローです。 SPARCは、プロンプトに頼るのではなくコードによって、Specification、Pseudocode、Architecture、Refinement、Completionの5フェーズを強制するソフトウェア変更向けのワークフローフレームワークです。各フェーズには必須の成果物があり、ゲートを通過した場合にのみ次のフェーズへ進めます。変更操作では現在のリビジョンとの一致が必要で、再試行時には元のリクエストと完全に同じ内容だけが再実行されます。
- sparc は無料で使えますか?ライセンスは?
- sparc は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- sparc は今もメンテナンスされていますか?
- 活発にメンテナンス中。sparc の最終コミットは 2026年11月7日 です。
- sparc は何に使えますか?
- 監査可能なフェーズゲートとテスト証拠を備えた、AI支援によるコード変更の実施。 MCPを通じて、ClaudeやCodexに構造化された開発ワークフローを提供。 変更を完了として受け入れる前に、署名付きの検証結果を必須にする。
- sparc のインストール方法は?
- doctor コマンドでインストールを確認します(Node.js 20 以降が必要です): npx --yes @ruvnet/sparc@1.0.0 doctor SPARC の状態を初期化します: npx --yes @ruvnet/sparc@1.0.0 init 要件と受け入れテストを含む run 定義の JSON ファイルを作成し、run を開始します
- sparc はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/ruvnet/sparc
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
チャットボットやエージェントなどの意思決定アプリケーションをステートマシンとして構築し、トレースと監視用のUIも備えたPythonライブラリ。
Zoteroの研究ライブラリをClaude、ChatGPT、CursorなどのAIアシスタントに接続し、検索・閲覧・注釈を可能にするMCPサーバーとCLI。
FastGPTは、LLMアプリ向けにデータ処理、RAGナレッジベース、ビジュアルなワークフロー構築を提供するオープンソースのAI Agent開発プラットフォームです。
Claude Code、Codex、CursorなどのAIコーディングエージェントにAgent Skillsとして仕様駆動開発のワークフローを導入し、要件、設計、タスク、自律的な実装までを支援します。
Claude Codeの設定に使えるエージェント、コマンド、設定、フック、MCP連携を収録したCLIとテンプレートカタログ。