Repolode
ruvnet

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. 1

    doctor コマンドでインストールを確認します(Node.js 20 以降が必要です)

    npx --yes @ruvnet/sparc@1.0.0 doctor
  2. 2

    SPARC の状態を初期化します

    npx --yes @ruvnet/sparc@1.0.0 init
  3. 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 の数値は毎日更新されます。

関連プロジェクト