Awesome Loop Engineering
English | 中文 | Español | Français | Deutsch | 日本語 | 한국어 | Português | 번역 돕기
Loop Engineering 을 위한 구현 중심 큐레이션 목록입니다. Loop Engineering 은 prompt, context, harness engineering 위의 레이어로, 반복 실행되는 AI-agent 시스템을 설계합니다.
Prompt engineering 은 모델에게 무엇을 요청할지 개선합니다. Context engineering 은 모델이 무엇을 볼 수 있는지 개선합니다. Harness engineering 은 한 번의 agent 실행을 둘러싼 도구, 권한, sandbox, 검증을 개선합니다. Loop Engineering 은 이 세 레이어 위에 있습니다. agent 를 실행하고, 감독하고, 결과를 검증하고, 상태를 저장하고, 다시 실행하는 시스템을 설계하는 실천입니다.
Loop 는 작업을 발견하고, 하나 이상의 agents 에게 위임하고, 결과를 확인하고, 상태를 기록하고, 다음 행동을 결정한 뒤, 일정 cadence 또는 검증 가능한 목표에 도달할 때까지 다시 실행됩니다.
이 저장소는 AI agents / coding agents 맥락의 새로운 Loop Engineering 의미에만 집중합니다. software event loop, control theory, growth loop, 일반적인 workflow automation, 비 AI feedback loop 는 범위에 포함하지 않습니다.
멘탈 모델
- Prompt engineering: 모델에게 무엇을 말해야 하는가?
- Context engineering: 모델이 어떤 상태와 지식을 봐야 하는가?
- Harness engineering: agent 주변에 어떤 도구, 권한, 테스트, sandbox, feedback 이 있어야 하는가?
- Loop engineering: 사람이 내부 루프에 있지 않을 때 어떤 반복 시스템이 작업을 발견하고, agents 에게 위임하고, 결과를 검증하고, 상태를 저장하고, 다음 행동을 결정하고, 다시 실행해야 하는가?
Prompt, context, harness engineering 은 한 번의 실행을 더 좋게 만듭니다. Loop Engineering 은 agent 작업을 시간에 걸쳐 반복 가능하고, 관찰 가능하고, 거버넌스 가능하게 만듭니다.
Loop Contract
유용한 loop 는 보통 다음 요소를 명확히 해야 합니다.
| 요소 | 설계 질문 | 일반적인 산출물 |
|---|---|---|
| Objective | loop 는 무엇을 최적화하는가? | Goal, issue, PRD, runbook |
| Trigger | 언제 실행되는가? | Schedule, webhook, /loop, /goal, automation |
| Discover / Intake | 어떻게 작업을 발견하는가? | GitHub query, Linear filter, CI failure, feedback stream |
| Workspace | agent 는 어디에서 안전하게 행동하는가? | Worktree, sandbox, branch, container |
| Context | 어떤 지속 지식을 로드해야 하는가? | AGENTS.md, CLAUDE.md, SKILL.md, docs |
| Delegation | 어떤 agent 가 무엇을 담당하는가? | Explorer, implementer, reviewer, judge |
| Verification | 무엇이 성공 또는 실패를 판단하는가? | Tests, typecheck, lint, evals, trace graders |
| State | 다음 실행까지 무엇이 남아야 하는가? | Progress file, checkpoint, trace, issue comment |
| Budget | 언제 비용 소비를 멈춰야 하는가? | Max turns, max retries, token budget, time box |
| Escalation | 언제 사람이 개입해야 하는가? | PR, issue, Slack alert, triage inbox |
| Exit | loop 는 어떻게 완료를 판단하는가? | Acceptance criteria, passing checks, no work found |
성숙도 모델
| 레벨 | 이름 | 설명 |
|---|---|---|
| 0 | Manual prompting | 사람이 상태를 읽고 다음 prompt 를 작성합니다. |
| 1 | Scripted retry | script 가 오류를 agent 에게 다시 전달합니다. |
| 2 | Scheduled loop | agent 가 일정 cadence 로 실행되고 결과를 보고합니다. |
| 3 | Stateful loop | 파일, issue, checkpoint, trace 로 진행 상황이 유지됩니다. |
| 4 | Self-verifying loop | 결정적 check 또는 evaluator agent 가 잘못된 완료를 막습니다. |
| 5 | Multi-agent loop | 전문 agents 가 discovery, implementation, review, judgment 를 나눕니다. |
| 6 | Production-supervised loop | observability, budget, approval, rollback, human escalation 이 핵심 요소가 됩니다. |
시작하기
전체 리소스 목록은 영어 canonical README 에 있습니다: README.md.
추천 시작 자료:
- Loop Engineering - 수동 prompting 에서 prompt, 검증, 지속을 수행하는 시스템 설계로 이동하는 흐름을 정의합니다.
- Run long horizon tasks with Codex - plan-edit-test-observe-repair-document-repeat 작업을 위한 실용 runbook.
- Run prompts on a schedule -
/loop, scheduled tasks, recurring prompts 의 공식 메커니즘. - Building Effective Agents - workflows 와 agents 를 위한 composable patterns.
기여하기
Pull request 를 환영합니다. 먼저 CONTRIBUTING.md 를 읽어 주세요.
빠른 절차:
- 리소스가 AI/coding-agent 맥락의 Loop Engineering 또는 직접적인 기반인지 확인합니다.
- README 에서 중복 여부를 검색합니다.
- 가장 구체적인 카테고리를 선택합니다.
- 다음 형식으로 한 줄을 추가합니다.
- 📄 **Paper** [Title](https://example.com) - One sentence explaining the resource's contribution to Loop Engineering.
- PR 에서 관련성, 카테고리, 리소스 타입, builders 에게 주는 가치를 설명합니다.
번역
새 언어를 추가하거나 유지하고 싶다면 TRANSLATIONS.md 를 읽어 주세요. 번역은 scope boundary 를 지켜야 하며 event loop, growth loop, 일반 automation 을 범위에 섞지 않아야 합니다.