2026 年版：初めての AI ループを構築する方法

1npm i -g @randomlabs/slate

1cd /path/to/your/project
2slate

1# AGENTS.md
2
3## このコードベースの役割
4[プロジェクトの1段落の説明]
5
6## アーキテクチャ
7- src/api/ — Express API ルート
8- src/services/ — ビジネスロジック
9- src/db/ — データベースモデル（Prisma 経由の PostgreSQL）
10- tests/ — Jest テストスイート
11
12## 主要コマンド
13- npm test — 全テストスイートを実行
14- npm run build — TypeScript コンパイル
15- npm run lint — ESLint チェック
16- npm run typecheck — tsc --noEmit
17
18## ルール
19- 人間の承認なしに src/billing/ または src/auth/ を変更しないこと
20- タスク完了をマークする前に必ずテストを実行すること
21- src/utils/errors.ts の既存のエラーハンドリングパターンを使用すること
22
23## 環境
24- .env.slate には Slate が必要とするすべての環境変数が含まれています

1/workspace add ./src
2/workspace add ./tests
3/workspace list

1@src/api/routes.ts をレビューして改善案を提案してください

1{
2  "$schema": "https://randomlabs.ai/config.json",
3  "permission": {
4    "*": "allow",
5    "bash": "ask"
6  },
7  "models": {
8    "main": { "default": "anthropic/claude-opus-4.6" },
9    "subagent": { "default": "anthropic/claude-sonnet-4.6" },
10    "search": { "default": "anthropic/claude-haiku-4.5" },
11    "reasoning": { "default": "openai/gpt-5.6" }
12  }
13}

1slate run "テストスイートを実行して、失敗があれば修正してください" --dangerously-skip-permissions --output-format stream-json

1コードベース全体のアーキテクチャをレビューしてください。
2ARCH.md を作成し、以下を含めてください：
3- 現在の構造
4- モジュール間の依存関係
5- 改善すべき 3 つの点
6最初に @src/ を確認し、次に @tests/ を確認してください

1ねえ Slate、認証フローについてコードベースを調査して、
2OAuth2 サポートを追加する計画を立ててください。
3@src/auth/ と @src/api/routes.ts を必ず確認してください

1いいえ、新しい認証プロバイダークラスは追加しないでください。
2src/auth/api-key.ts の既存の ApiKeyAuth と同じパターンに従わせてください

1mkdir -p .slate/skills/ci-triage
2touch .slate/skills/ci-triage/SKILL.md

1---
2name: "ci-triage"
3description: "CI 失敗を根本原因で分類し、簡単なものには修正案を作成します。"
4---
5
6# CI トリアージスキル
7
8## 私が行うこと
9CI 実行が失敗したとき、以下のことを行います：
101. テスト出力を読み取る
112. 失敗を分類する：環境問題 / 不安定なテスト / 実際のバグ / 依存関係のバンプ / インフラ
123. バグと依存関係の問題の修正案を作成する
134. 環境問題とインフラ問題を人間にエスカレーションする
14
15## 分類ルール
16- env: シークレット欠落、環境変数間違い → 人間にフラグを立てる
17- flake: コード変更なしで再実行すると合格する → 一度再試行し、その後 issue を登録する
18- bug: 最近のコミットに関連する決定論的失敗 → 修正案を作成する
19- dependency: バージョンバンプに関連する失敗 → ロールバック PR を作成する
20- infra: タイムアウト、OOM、ランナー問題 → 即座にエスカレーションする
21
22## 修正パターン
23- 認証テストの失敗 → 最初に src/auth/middleware.ts を確認する
24- データベーステストの失敗 → CI 環境でマイグレーションが実行されたか確認する
25- E2E の失敗 → 最新のスナップショットに対して UI セレクタを確認する
26
27## 決して行わないこと
28- 失敗するテストを無効にする
29- 確認なしに CI 設定を変更する
30- src/billing/ または src/payments/ に触れる
31
32## 状態
33実行後は毎回 STATE.md を更新する：
34- 確認したファイル
35- 行った分類
36- 開いた PR
37- エスカレーションした項目

1/skills

1@ci-triage 今日の失敗テストをトリアージしてください

1# ループ状態 — CI トリアージ
2
3## 前回の実行
42026-06-28 03:30 UTC — 7 件の失敗を分類、3 件の修正案を作成、4 件をエスカレーション
5
6## 進行中
7- claude/fix-auth-token-refresh — ローカルでテスト合格、CI 待ち
8- claude/fix-flaky-payment-webhook — 再試行パターンを適用、監視中
9
10## 完了
11- claude/bump-axios-1.7.4 → マージ済み（CI グリーン）
12- claude/lint-fix-pass-june-28 → マージ済み
13
14## 人間にエスカレーション済み
15- src/billing/refund.ts — 3 つの方法でテスト失敗、根本原因不明
16- ci/staging-runner — インフラタイムアウト、コード問題ではない
17
18## 学んだ教訓
19- 2026-06-27: PowerShell がこの Windows ランナーで TLS 1.2 問題に遭遇。bash を使用すること。
20- 2026-06-26: tests/e2e/checkout には Stripe webhook シークレットが env に必要。ない場合はスキップすること。

1## セッション開始
2最初に STATE.md を必ず読み取ること。前回の実行が停止した場所から再開すること。
3実行終了時には毎回 STATE.md を更新し、何を行い、次に何を行うかを記録すること。

1STATE.md を読み取り、すでに試行された内容を理解すること。
2
3最新のビルドで失敗したすべてのテストに対して CI トリアージスキルを実行すること。
4
5各失敗について：
6- ci-triage スキルのルールを使用して分類する
7- バグと依存関係の問題に対して修正案を作成する
8- 環境問題とインフラ問題をエスカレーションする
9
10修正を実行する。テストが合格するか確認する。
11テストが合格した場合 → PR を開く。
12テストがまだ失敗する場合 → STATE.md に記録して停止する。
13
14この実行で行われたすべての内容で STATE.md を更新する。
15
16ハードストップ：最大 8 回試行。制限に達した場合、現在の状態を報告する。

1slate --queue loop.md

1slate run "$(cat loop.md)" --output-format stream-json --dangerously-skip-permissions

1name: CI トリアージループ
2on:
3  workflow_run:
4    workflows: ["CI"]
5    types: [completed]
6
7jobs:
8  triage:
9    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
10    runs-on: ubuntu-latest
11    steps:
12      - uses: actions/checkout@v4
13
14      - name: Slate をインストール
15        run: npm i -g @randomlabs/slate
16
17      - name: トリアージループを実行
18        env:
19          SLATE_API_KEY: ${{ secrets.SLATE_API_KEY }}
20        run: |
21          slate run "$(cat loop.md)" \
22            --output-format stream-json \
23            --dangerously-skip-permissions \
24            --workspace ./src \
25            --workspace ./tests

1{
2  "models": {
3    "main": { "default": "anthropic/claude-opus-4.6" },
4    "subagent": { "default": "anthropic/claude-sonnet-4.6" },
5    "search": { "default": "anthropic/claude-haiku-4.5" }
6  }
7}

1失敗している認証テストを修正してください。
2
3ステップ 1: 検索エージェントに src/auth/ を探索させ、現在の実装を理解させる。
4ステップ 2: 別のエージェントに、見つかった内容に基づいて修正を実装させる。
5ステップ 3: 3 番目のエージェントに、元のテスト要件に対して修正を検証させる —
6         このエージェントは実装を見ていない必要がある。
7ステップ 4: 検証者が承認した場合のみ PR を開く。

1あなたはマルチセッションループを実行しています。
2
3目標：すべての Express ルートを新しい ApiError パターンに移行する。
4進捗を STATE.md で追跡する。
5
6各セッションの開始：
71. STATE.md を読み取る
82. 「残りのルート」から最初の未完了項目を見つける
93. その項目のみを行う
10
11各セッションの終了：
121. 完了した項目を STATE.md の「完了ルート」に移動する
132. 妨害要因を「妨害要因」に記録する
143. 「最終実行」タイムスタンプを更新する
154. きれいに停止する
16
17STATE.md の形式：
18---
19## 完了ルート
20- [x] /api/users (2026-06-27)
21- [x] /api/auth/login (2026-06-28)
22
23## 残りのルート
24- [ ] /api/payments/checkout
25- [ ] /api/payments/refund
26- [ ] /api/admin/users
27
28## 妨害要因
29- /api/payments/refund — 人間のレビューが必要（課金ロジックに触れる）
30
31## 最終実行
322026-06-28 14:30 UTC
33---
34
35厳格なルール：
36- 人間の承認なしに src/billing/ に触れないこと
37- 各ルート移行後に必ずテストを実行すること
38- セッションごとに 1 つのルートを完了したら停止すること

1slate --continue "$(cat loop.md)"

1{
2  "command": {
3    "triage": {
4      "description": "CI トリアージループを実行",
5      "template": "STATE.md を読み取る。失敗したすべてのテストに対して ci-triage スキルを実行する。完了したら STATE.md を更新する。",
6      "agent": "build"
7    },
8    "review": {
9      "description": "ファイルの正確性をレビュー",
10      "template": "@$ARGUMENTS を正確性、エッジケース、周囲のコードとの一貫性についてレビューする。"
11    },
12    "migrate": {
13      "description": "1 つのルートを ApiError パターンに移行",
14      "template": "STATE.md を読み取る。次の未完了ルートを ApiError パターンに移行する。テストを実行する。STATE.md を更新する。"
15    }
16  }
17}

1/triage
2/review src/api/payments.ts
3/migrate

1# トリガー
2slate run "$(cat loop.md)" --dangerously-skip-permissions --output-format stream-json
3
4# または GitHub Actions 内 — 上記ステップ 6 を参照

1# 朝のブリーフィング用の loop.md
2cat > morning-brief-loop.md << 'EOF'
3過去 24 時間の以下を読み取ること：
4- git log --since="24 hours ago" --oneline
5- ドラフトまたはレビュー中のオープン PR
6- 過去 24 時間に作成または更新された GitHub Issue
7
8朝のブリーフィングを作成すること：
9- 発生した最も重要なこと 3 つ
10- 今日注意が必要なこと 2 つ
11- 誰かの妨害になる危険があること 1 つ
12
13120 語以内に収めること。#engineering Slack チャンネルに投稿すること。
14EOF
15
16# cron でスケジュール実行
170 7 * * 1-5 slate run "$(cat morning-brief-loop.md)" --dangerously-skip-permissions

1cat > deps-loop.md << 'EOF'
2STATE.md を読み取ること。
3
4実行：npm outdated
5
6古い各パッケージについて：
71. バージョンバンプがメジャー（破壊的変更）かマイナー/パッチ（安全）かを確認する
82. マイナー/パッチの場合：パッケージを更新し、npm test を実行する
93. テストが合格した場合：PR を開く
104. テストが失敗した場合：STATE.md に「人間のレビューが必要」として記録する
115. メジャーバンプの場合：常に人間にエスカレーションする
12
13厳格なルール：
14- 1 回のループで 5 つ以上のパッケージをバンプしないこと
15- 「peer dependencies」セクションのパッケージをバンプしないこと
16- 各バンプ後、関連テストだけでなく、完全なテストスイートを必ず実行すること
17
18STATE.md を、何をバンプし、何をエスカレーションしたかで更新すること。
19EOF
20
21# 毎週月曜日に実行
220 9 * * 1 slate run "$(cat deps-loop.md)" --dangerously-skip-permissions

1停止条件：tests/auth/ のすべてのテストが合格し、lint が 0 を返す。
2エージェント自身の判断ではなく、別のチェック実行を使用して検証すること。
3ハードリミット：8 回の反復。制限時：状態を報告して停止する。

1# VISION.md — 各セッション開始時に読み取ること
2
3## コア目標
4すべての Express ルートを ApiError パターンに移行する。
5
6## 厳格な制約（決して違反しないこと）
7- 人間の承認なしに src/billing/ に触れないこと
8- 失敗するテストを無効にしないこと
9- PR を開く前に必ず完全なテストスイートを実行すること
10
11## 現在の優先順位
12src/api/payments/ のルート — 特別な注意を払って扱うこと

1検証エージェントは実装エージェントの作業を見るべきではありません。
2見るべきものは：元のテスト要件とテスト出力のみ。
3テストが合格した場合 → 承認。テストが失敗した場合 → 拒否。それ以外の意見はなし。

1完了条件：npm test が終了コード 0 を返し、npm run lint が終了コード 0 を返す。
2「テストが良さそう」ではない。「ほとんどのテストが合格」ではない。
3両方のコマンドで終了コード 0。それが唯一の完了条件である。

1[Slate が移行タスクを実行中...]
2
3あなた：そうだ、新しいパターンが userId が null の場合も処理できるようにして
4[Tab — キューに入った]
5
6[Slate が現在のステップを終了し、次にキューに入れられたメッセージを読み取る]

1[Slate が修正の実装を半分実行中...]
2
3あなた：待って — これに新しいクラスを追加しないで。src/utils/errors.ts の既存の BaseError を使って
4[Enter — 即座に方向修正]
5
6Slate: 了解しました。BaseError を使用するアプローチに切り替えます...

1!npm test          # テストを実行し、出力を Slate に送信
2!git diff HEAD     # 変更内容を確認
3!git status        # 現在の状態を確認

1# ターミナル 1 — サーバーを起動
2slate serve --port 7777
3
4# ターミナル 2 — TUI に接続
5slate attach http://localhost:7777 --dir /path/to/project

1□ npm i -g @randomlabs/slate がインストールされている
2□ プロジェクトの概要、コマンド、ルールを含む AGENTS.md が作成されている
3□ 権限とモデル設定を含む slate.json が作成されている
4□ 1 回の手動実行が完了し、信頼性が確認されている
5□ 最初の繰り返しタスク用の SKILL.md が作成されている
6□ STATE.md が作成され、AGENTS.md で参照されている
7□ 明示的な停止条件を含む loop.md が作成されている
8□ 反復回数のハードリミット（最初は最大 8 回）
9□ 検証者は作成者と同じエージェントではない
10□ 元に戻せないアクション（PR、デプロイ）には人間のレビューゲートがある