Steadfast Repository Governance について
Steadfastは、開発者やコーディングエージェント向けのローカル優先CLIで、リポジトリの状態確認とガバナンスポリシーの適用を支援します。読み取り専用の検証、監査レポート、任意のMCP接続を備え、リポジトリの内容をSteadfastのホストサービスへ送信しません。
主な機能
- 01変更範囲と証拠の確認
- 02ドキュメントとコードのずれを検出
- 03目標とリリース準備状況の検証
- 04エージェント向け指針と連携の設定
- 05読みやすい監査レポートの生成
活用シーン
- 01レビュー前のリポジトリ変更検証
- 02証拠と文書の整合性監査
- 03コーディングエージェントのガバナンス設定
MCP 対応
互換性のあるエージェント向けに、読み取り専用のMCPサーバーを起動できます。リポジトリのガバナンスと検証機能を提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Steadfast
コーディングエージェント向けのリポジトリチェックとガードレールです。
Steadfast はローカルファーストの CLI で、開発者と AI エージェントがリポジトリの健全性を調べ、変更範囲を適用し、証拠を検証し、ドキュメントの不整合を見つけるのに役立ちます。コードを生成したり、AI API キーを要求したり、リポジトリの内容を Steadfast がホストするサービスに送信したりすることはありません。
クイックスタート
Python 3.10 以降と Git が必要です。
python -m pip install --upgrade steadfast-governance
cd /path/to/your/repository
steadfast onboard --agent codex
steadfast verify
別の対応エージェントを設定するには、codex を claude、cursor、または all に置き換えてください。生成されたファイルは、リポジトリを信頼する前に確認してください。既存のファイルはデフォルトで保持されます。
最新の未リリースソースを使用するには、代わりに Git からインストールしてください。
python -m pip install --upgrade "git+https://github.com/rllibo833-sudo/Steadfast.git"
多くの人が必要とするコマンド
| コマンド | 目的 |
|---|---|
steadfast onboard | リポジトリのガイダンスと、選択したエージェントとの統合を設定します。 |
steadfast verify | 統合された読み取り専用のガバナンスチェックを実行します。 |
steadfast report | 人が読める監査レポートを生成します。 |
steadfast audit | 変更されたファイル、証拠、コントラクト、ドキュメントの不整合を確認します。 |
steadfast discover | ツールとエージェント向けに、機械可読な機能マップを出力します。 |
steadfast mcp-server | 対応エージェント向けに読み取り専用の MCP サーバーを起動します。 |
短い手順についてはクイックスタートガイド、対応する AI クライアントの接続についてはMCP クライアント設定ガイド、CLI コマンド一覧についてはコマンドリファレンスをご覧ください。コピーして使えるプルリクエストのワークフローと導入チェックリストについては、GitHub Actions での導入をご覧ください。
チェックすることと、できないこと
- スコープ: 変更されたパスをリポジトリのポリシーと照合します。
- 証拠: 必須の証拠ファイルと証拠バンドルの整合性をチェックします。
- セキュリティシグナル: 選択したリスクの高いソースパターンと、ワークフローの信頼境界に関する問題を検出します。
- ドキュメントとコードの整合性: 古くなったコマンド例と、パッケージのエントリーポイントの不整合を検出します。
- 目標とリリース: 目標間の依存関係を検証し、リリースの準備状況を評価します。
- エージェントのサポート: スキルを検出し、MCP 設定を調べ、リポジトリ内のガイダンスをインストールします。
これらのチェックはガードレールであり、サンドボックスでも意味的な正しさの証明でもありません。結果はリポジトリのポリシーと設定に左右されるため、結果をリリース判断として扱う前に、検出事項を確認してください。Steadfast は計画をひそかに書き換えたり、verify の一環として設定済みのパイプラインを実行したりしません。マニフェストを確認してから、steadfast pipeline を別途実行してください。
設定
steadfast init を実行すると、スターター用のガバナンスファイルが作成されます。リポジトリのポリシーは .steadfast/policy.json にあり、パイプラインのステップは .steadfast/pipeline.json で設定します。パイプラインのマニフェストは実行可能な設定として扱い、実行前にコマンドを確認してください。
プロジェクトリンク
開発
python -m pip install -e .
python -m unittest discover -s tests -v
steadfast docs-check
steadfast code-truth
MIT ライセンスです。詳細は LICENSE をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。