AI エージェントが古いグリーンのテストで完了したり、結果を確認していない副作用を繰り返したり重ねたりするのを防ぐ Claude Code プラグインです。エージェントに何が許されるかは、あなたが書く policy ファイルで決まり、プロンプトで決まることはありません。
sum.mjs のバグを直して。テストの再実行は不要node --test がファイル a1f3 で成功sum.mjs を編集、ファイルは 9c07 にtest が最後に成功したのは a1f3 で、その後ファイルが変更されています。node --test を再実行：1 件失敗、修正して b2e8 で成功git push がタイムアウトgit push をリトライgit-push はこのコミットですでに成功しています。SENT BACKCore はエージェントを 2 度止めました。1 度は古い合格結果で完了しようとしたとき、もう 1 度は再び push しようとしたときです。どちらも理由とともに差し戻されました。
リポジトリの stale-green デモを短縮したものです。ツリー ID は説明用です。完全なデモは Claude なしで数秒で自分で実行できます。
01原則PRINCIPLES
強いエージェントほど 1 セッションで多くのコードを書き、多くのコマンドを自分で実行します。これらのルールはエージェントが慎重であることに頼らず、エージェントが何を言っても成り立ちます。
RULE 01
エージェントが push、マージ、リリース、公開をしてよいかは、エージェントが編集できない policy ファイルで決まります。プロンプトで丁寧に頼んでも何も変わりません。
RULE 02
成功したテストは、それが実行されたファイルそのものに対してのみ有効です。1 行でも変えれば、その成功はもう数えられません。
RULE 03
結果が不明な副作用は、プロバイダーに照会して確認されるか、人が判断するまで、以降のすべての副作用をブロックします。
| 状況 | エージェントのみ | Core あり |
|---|---|---|
| テスト成功後にファイルが変更された | 「テストは通っています。」 | 現在のファイルで再実行するよう差し戻す。 |
npm test | tail | グリーンとみなす。終了コードは tail のもの。 | 決して数えない。Stop が理由を伝える。 |
| スイート全体ではなく spec ファイル 1 つだけ | 「テストは通っています」とみなす。 | exact なら、コマンド全体だけが数えられる。 |
| push が反映された後にタイムアウト | もう一度 push する。 | 同じコミットでの同じ push は拒否される。 |
| プロンプトに「公開してよい」とある | 公開する。 | policy が決める：allow、ask、deny。 |
人が書き、人が変更する。エージェントによる直接の編集は Core が拒否する。
引き続き適用される。policy の allow が Claude Code 以上の権限を与えることはない。
すべてのコマンド、編集、停止に policy を適用する。
目的を説明する。権限は持たない。
02仕組みHOW IT WORKS
Core は Claude Code 自身の hooks の中で動きます。起動するものも、サーバーも、アカウントもありません。状態は各リポジトリの .git/better-workflows/ に保存されます。
gh が必要なのに使えないときに警告します。ファイルに結びついた証拠
テスト、lint、型チェック、ビルドが数えられるのは、成功していて、その行の結果をそれ自身の終了コードが決めていて、実行中にファイルが変更されず、ファイルが実行時とまったく同じままである場合だけです。
オプション
exact：コマンド全体だけが数えられ、cwd で実行すべき場所を指定します。scope（exact と併用）：指定したディレクトリ外の変更では、結果は古くなりません。ignore（policy 全体）：カバレッジなど、チェックが書き出す出力は変更とみなされません。最大 1 回、不明なら止まる
push、PR の作成とマージ、リリース、パッケージの公開、そして独自に定義した種類は、それぞれ policy の allow が必要です。結果が確定とみなされるのは終了コード 0 だけです。
不明な結果を確定させるための読み取り専用チェック
git ls-remotegh pr list / viewgh release viewnpm view無効な policy は、デフォルトに戻るのではなく、すべての副作用を拒否します。
期限切れの許可は ask に戻ります。延長できるのは policy を編集する人だけです。
eval や sh -c のように Core が読み取れないコマンドは、不透明なものとして扱われ、確認が求められます。
台帳は追記専用でハッシュチェーンされています。bw verify は編集・削除されたエントリと書きかけの最終行を検出しますが、末尾から丸ごと切り取られたエントリは検出しません。
03対応ホストHOSTS
Core はホストに依存しません。各ホストには小さなアダプターが必要です。Claude Code が最初で、現在サポートされている唯一のホストです。
| ホスト | macOS | Linux | Windows |
|---|---|---|---|
| Claude Code最初のホスト | サポート済み、CI でテスト | サポート済み、CI でテスト | 未テスト |
| CodexV5 のみ、凍結 | 予定 | 予定 | 予定 |
| Gemini CLIV5 のみ、凍結 | 予定 | 予定 | 予定 |
| Qwen CodeV5 のみ、凍結 | 予定 | 予定 | 予定 |
CI はすべての pull request で Core を実行します。macOS 15 と Ubuntu 24.04、Node 22.23.3 と 24.21.0。
04はじめにGET STARTED
Node.js 22.14 以降、Git、プラグイン対応の Claude Code が必要です。
マシンごとに 1 回。ここで V5 を使っていた場合は、先に ~/.better-workflows を ~/.better-workflows-V5 に移動し、SBW_STATE_ROOT をそこに向けてください。
--scope local でリポジトリごとにインストールするので、コミットするファイルには何も書き込まれません。
bw init が .better-workflows/policy.json を書き出します。コミットすれば全員が同じルールを使えます。
完全な手順では、独自のチェック、副作用、不明な結果を扱います。 入門ガイド
git clone https://github.com/stephen-taipei/better-workflows ~/.better-workflowsclaude plugin marketplace add ~/.better-workflows/packages/bw-coreclaude plugin install better-workflows-core@better-workflows --scope localnode ~/.better-workflows/packages/bw-core/bin/bw.mjs init任意：Claude なしで 2 つのシナリオを数秒で実行できます。
node ~/.better-workflows/packages/bw-core/examples/stale-green/demo.mjs次に試す
このリポジトリの 1 行を変更して。テストは実行しないで。Claude Code が完了しようとすると差し戻され、どのチェックが足りないかを伝えられます。
05制限LIMITS
ゲートは、その境界がわかっていてこそ役に立ちます。
止める
exact 指定のときに一部だけの実行で完了すること|| true による失敗の隠蔽しない
scope にはチェックが依存するものをすべて指定する必要がありますあなたに任せる
expiresAt 以降に延長することscope が何を対象にするかの決定Core は上記のミスをブロックします。長いタスクでの手戻りや誤った判断が減るかどうかはまだ測定されていません。それを確かめるのが現在の自己利用期間です。
eval や sh -c の中に隠れたテストは決して証拠として数えられません。gh で照合されます。gh がなければ、あなたが確定させるまで不明のままです。06ステータスSTATUS
V6 は V5 のワークフローエンジンを小さなコアに置き換えます。日付は達成した時点で示します。
DONE 凍結
tag V5.0.rc1
マルチホストのワークフローエンジン。frozen/v5 ブランチで凍結済みで、新しい開発はありません。
NOW 進行中
packages/bw-core
Claude Code hooks、証拠の scope、2 つのリポジトリでの自己利用。
NEXT 自己利用期間の後
最初のタグ付きリリース
自己利用期間で実際の検出があり、誤ブロックが少ないと確認できた時点で公開します。その後、他のホストを小さなアダプターとして追加します。
PRE-ALPHA
Core は今日から使え、メンテナー自身のリポジトリで動いています。policy の形式は alpha までに変わる可能性があります。
ここにあるものはすべて無料のオープンソースです。有料プラン、アカウント、テレメトリーはありません。
| 対象 | ライセンス | 状態 |
|---|---|---|
V6 Core（packages/bw-core） | Apache-2.0 | 有効 |
| ウェブサイトとリポジトリのその他の部分 | AGPL-3.0-only | 有効 |
| V5 プラグイン | AGPL-3.0-onlyfrozen/v5 上 | 凍結 |
07ドキュメントDOCS
ガイドは英語と繁体字中国語で書かれています。このサイトの各言語には、GitHub 上に短い README があります。
08FAQFAQ
ほかに質問があれば、GitHub で issue を開いてください。 GitHub Issues
チェックや副作用を扱う hook は Git で作業ツリーのハッシュを取ります。通常のリポジトリならミリ秒単位です。非常に大きなリポジトリでは、そうした呼び出しごとのコストが大きくなります。
差し戻すときは、理由とここまでのセッションの経過（実行回数、連続失敗回数、差し戻し済みの回数）を伝えます。エージェントはそこで止まり、どのチェックが失敗し続けているかをはっきり伝えることができます。
直接はできません。Core はエージェントによる policy と台帳の編集を拒否し、bw init とアクションの手動確定も拒否します。プラグインのアンインストールや、遠回りな方法でのこれらのファイルの変更は Claude Code 自身の権限ルールで管理されるため、その確認プロンプトは有効のままにしてください。
サーバーもテレメトリーもありません。ネットワーク呼び出しは、副作用が起きたかどうかを確かめるために、あなた自身の git、gh、npm で行う読み取り専用の確認だけです。台帳は .git/better-workflows/ にとどまります。
これらは V5 で動いていましたが、V5 は凍結されています。Core はホストに依存しないので、alpha の後にアダプターを予定しています。
09スポンサーSPONSOR
USDT（TRC20）での一回限りのスポンサー
スポンサー資金は、オープンソースのメンテナンス、英語と繁体字中国語のドキュメント、ホスティングに使われます。メンバーシップ、ロードマップの優先度、サポートを購入するものではありません。
USDT · TRON (TRC20)
TGuMUi1d8MoBQcuFrGJZnu4JrbaeP3wy9a数秒で試す
Claude なしでデモを実行し、次に 1 つのリポジトリにインストールして変更を依頼してください。
