ループとは正確には何ですか?
ループは、目標、進捗を客観的に検証する検査コマンド、退出条件、最大反復回数の4つで構成される、AI コーディングエージェント向けの再利用可能なワークフローです。起動プロンプトをエージェントに貼り付ければ、退出条件を満たすまで検査コマンドを再実行しながら自律的にタスクを進めます。
コーディングエージェントがタスクを完了するまで自律的に進められる、再利用可能なプロンプトと段階的なワークフロー。
Run the production build, fix compile and bundling errors, and loop until the build succeeds.
Run automated accessibility checks on changed routes, fix violations, and repeat until the audit is clean.
Add focused tests until coverage meets your threshold (e.g. 80%), without changing production behavior unnecessarily.
Poll CI on an interval, investigate failures when checks go red, and push fixes until green.
Fetch the latest failed CI run, reproduce the failure locally, fix it, and repeat until checks pass.
Every 15 minutes, inspect open PRs with a watch label: nudge reviewers, fix CI, rebase if behind main.
Run the formatter, fix any remaining style issues, and loop until the codebase formats cleanly with no diffs.
Fresh-context loop: pick one incomplete story from prd.json, implement it, run backpressure checks, commit, and update progress before the next iteration.
Run failing tests repeatedly, classify each failure as flaky or real, and fix only confirmed regressions.
Hook that runs tests before git commit commands to block commits when the suite is red.
After implementation, run a cleanup pass: remove debug code, tighten naming, delete dead branches, and align with project conventions.
When a check fails twice the same way, append a guardrail sign to .ralph/guardrails.md so the next iteration avoids repeating it.
On an interval, hit health and smoke endpoints after a deploy until all checks return healthy responses.
After code changes, find affected docs and update README, API references, and inline comments to match.
Poll open PRs labeled codex-watch every 15 minutes, review activity, and flag regressions or stale threads.
Fix high/critical npm audit findings one at a time with test verification — not a blind npm audit fix --force.
Test-first loop: write a failing test, implement the minimum code to pass, refactor, and repeat.
When implementation claims done, a separate verifier pass runs build, lint, and tests with no access to the implementer's rationale.
Keep openapi.yaml valid and in sync with route handlers — lint the spec and fix drift each pass.
Find and remove dead exports, unused files, and orphan dependencies — loop until knip reports clean.
Implement on a branch, run tests, push, open a PR, wait for CI, and loop until checks pass and the PR is ready to merge.
Loop until API responses match the OpenAPI or JSON Schema contract — catch drift between docs and implementation.
After shipping a feature, loop until CHANGELOG.md has a user-facing entry and conventional commits are reflected.
On each failed repro attempt, write a short reflection to disk, then retry with that memory — avoids repeating the same wrong fix.
Run database migrations, fix schema issues, and loop until migrations apply cleanly in dev.
Hook that runs smoke tests after git merge or rebase to catch integration regressions immediately.
Run a fixed smoke checklist against staging after deploy: auth, core flows, and error budgets.
Review your own diff like a senior reviewer, fix issues, and repeat for three passes before opening the PR.
Run lint and typecheck, fix reported issues, and loop until the codebase is clean.
Hook-based loop that runs related tests after file edits to catch regressions early.
AI コーディングエージェント向けの再利用可能な Loops に関するよくある質問
ループは、目標、進捗を客観的に検証する検査コマンド、退出条件、最大反復回数の4つで構成される、AI コーディングエージェント向けの再利用可能なワークフローです。起動プロンプトをエージェントに貼り付ければ、退出条件を満たすまで検査コマンドを再実行しながら自律的にタスクを進めます。
通常のプロンプトは1ターンの1つの指示です。ループは繰り返されるターンを取り巻くシステムで、エージェントに自分の作業をどう検証し、いつ停止するかを伝えます。そのため、毎回プロンプトを入力し直さなくても作業を継続できます。この手法は Loop Engineering と呼ばれます。
このページのほとんどのループは特定のエージェントに依存しません——起動プロンプトはただのテキストなので、Claude Code、Cursor、Codex など任意のコーディングエージェントに貼り付けて使えます。各ループの詳細ページには、専用に構築・テストされたエージェントが記載されています。
テスト修正、CI 失敗の解消、コードレビュー、デプロイ検証、大規模リファクタリングの完了など、複数回の修正パスと客観的な合格チェックが必要なタスクにはループを使いましょう。単発の質問や完了条件が明確でないタスクには、通常ループは不要です。
テスト、型チェック、Lint、デプロイのヘルスチェックなど、意味のある終了コードを返す安定した再実行可能なチェックを選びましょう。観測可能な完了状態を定義し、AI エージェントが無限に再試行しないよう最大イテレーション数を設定してください。
ループはプロンプトとコマンドを繰り返し実行するため、ファイル・ネットワーク・シークレット・デプロイへのアクセスを制限し、リスクのある作業は分離したブランチやサンドボックスで実行し、イテレーション上限と人によるレビューを維持してください。レビューされていないループに破壊的なコマンドを実行させてはいけません。