install-loop

Loop Engineering のインストール

目標

単一の CLI を使って、リポジトリに レポートのみのループを構築し、Loop Ready スコアと明確な次のアクションを提示します。

npx @cobusgreyling/loop

既存の loop-init／loop-audit の使用箇所を非推奨にしたり、削除したりしないでください。どちらも引き続き有効です。新しい作業では loop を優先してください。

手順

1. コンテキストを検出

   • LOOP.md または STATE.md がすでに存在する場合は、doctor のみを実行します（人間から再構築を依頼されない限り、init はスキップします）。

     npx @cobusgreyling/loop doctor . --json
     npx @cobusgreyling/loop status .
     

   • それ以外の場合は続行します。

2. パターンを選択（デフォルト：daily-triage）

   課題	パターン
   朝の混乱／優先順位が不明確	daily-triage
   PR が停滞している	pr-babysitter
   CI が失敗／フレークが発生している	ci-sweeper
   CVE／Dependabot の通知が多い	dependency-sweeper
   マージ後の TODO	post-merge-cleanup
   リリースノートが古い	changelog-drafter
   issue が多すぎる	issue-triage
   GitHub Action が 1 つで、ファイルがほとんどない	thin-loop

3. ツールを選択 — claude | grok | codex | opencode（デフォルト：claude）。

4. 構築

   npx @cobusgreyling/loop init . --pattern <pattern> --tool <tool>
   

   オプションのハーネス（人間が Foundry を希望する場合のみ）：--with-foundry を追加します。

5. Doctor

   npx @cobusgreyling/loop doctor .
   

   • 終了コード 0 = 正常 · 1 = 警告 · 2 = ブロック
   • 表示された上位 3 件のアクションに従います。余分なアーキテクチャを勝手に追加しないでください。

6. 高頻度スケジュールの前にコストを確認

   npx @cobusgreyling/loop cost -p <pattern> -l L1 -c 1d
   

7. 最初の 1 週間のルール

   • レポートのみとします。自動修正も自動マージもしません。
   • init の出力にある最初の /loop またはスケジューラーのコマンドを人間に伝えます。
   • スコアが高い場合のみ、バッジを提案します：npx @cobusgreyling/loop badge .

互換性

以下は引き続き完全にサポートされます（依頼されない限り、既存のドキュメント／スクリプトを書き換えないでください）。

npx @cobusgreyling/loop-init .
npx @cobusgreyling/loop-audit . --suggest

停止条件

• 人間から L2 以上を依頼されない限り、doctor と初回実行手順の案内後に停止します。
• スコアが 80 以上で、かつ人間が希望しない限り、fleet／memory／foundry に拡張しないでください。