Loop Engineering 최신 정리

1. 핵심 요약

2. Loop Engineering이란?

최근 Addy Osmani, Kilo, Langfuse 등에서 공통적으로 말하는 핵심은 같습니다. AI 에이전트를 “답변 생성기”가 아니라 “작업을 완수할 때까지 반복하는 실행 시스템”으로 다루는 것입니다.

Prompt Engineering과의 차이

3. 왜 2026년에 갑자기 중요해졌나?

4. Loop Engineering 아키텍처

실전에서는 아래 6개 요소가 루프의 뼈대가 됩니다.

가장 단순한 루프 의사코드

가독성을 위해 이 코드 블록은 다른 예시보다 글자 크기와 대비를 높였습니다.

while not done and iteration < MAX_ITERATIONS:
    goal = read_task()
    context = collect_relevant_context(goal)
    plan = agent.plan(goal, context)
    diff = agent.apply_small_change(plan)
    result = run_validation(diff)

    write_memory(goal, plan, diff, result)

    if result.passed:
        create_summary_and_pr()
        done = true
    elif result.is_blocked or result.is_risky:
        ask_human_for_decision()
        break
    else:
        context += result.errors
        continue

5. 대표 루프 패턴

목표 → 관련 테스트 찾기/작성 → 코드 수정 → 테스트 실행 → 실패 로그 반영 → 반복

타입 오류 수집 → 작은 수정 → typecheck → 남은 오류 분류 → 반복

리뷰 댓글 읽기 → 수정 계획 → patch → test → 답글 초안 → 반복

증상 수집 → 재현 → 로그/trace 분석 → 최소 수정 → 재현 테스트 → 반복

화면 경로 실행 → 스크린샷/콘솔 확인 → CSS/컴포넌트 수정 → 재확인

trace 수집 → 실패 분류 → eval dataset → 실험 → 품질 비교 → 배포

6. Claude Code / Codex 관점의 적용

Claude Code 쪽 구성

OpenAI Codex 쪽 구성

7. 리스크와 실패 모드

8. 팀 도입 플레이북

1단계 — 작은 루프부터 시작

처음부터 “자율 개발자”를 만들지 말고, 성공 기준이 명확한 작업부터 자동화합니다.

• 실패 테스트 수정
• lint/typecheck 오류 감소
• PR 리뷰 댓글 처리
• 문서와 코드의 불일치 수정
• 의존성 업데이트 후 빌드 검증

2단계 — 검증 명령을 표준화

에이전트가 “무엇을 실행해야 성공인지” 모르면 루프가 닫히지 않습니다. 모든 repo에 아래를 명확히 둡니다.

# 필수 검증 명령 예시
pnpm lint
pnpm typecheck
pnpm test
pnpm build
pnpm e2e -- --project=chromium

3단계 — 프로젝트 메모리 작성

대화창이 아니라 repo 안에 규칙을 둡니다. 그래야 세션·도구·담당자가 바뀌어도 루프가 유지됩니다.

• AGENTS.md: Codex/다중 에이전트용 작업 규칙
• CLAUDE.md: Claude Code 프로젝트 컨텍스트
• .claude/skills/*/SKILL.md: 반복 작업 절차
• LOOP_STATE.md: 장기 루프의 진행 상태

4단계 — 사람 승인 지점을 명확히

다음 변경은 자동 merge 금지 대상으로 두는 것이 안전합니다.

• DB migration, schema 변경
• 인증/권한/결제/개인정보 처리
• 인프라, CI/CD, secret, 배포 스크립트
• 대규모 refactor, public API 변경

5단계 — 루프 성능을 측정

9. 실전 템플릿

AGENTS.md 예시

# AGENTS.md

## Mission
You are working in this repository as a coding agent. Prefer small, reversible changes.

## Project rules
- Do not change public APIs without explicit approval.
- Do not modify database migrations, auth, billing, or deployment files unless the task explicitly asks for it.
- Follow existing patterns before introducing new abstractions.
- Keep diffs focused. If the task grows, stop and summarize the new scope.

## Validation commands
Run these before claiming completion:

```bash
pnpm lint
pnpm typecheck
pnpm test
pnpm build
```

## Completion report
Include:
1. What changed
2. Validation commands run and results
3. Files changed
4. Known risks or follow-up work

Claude Code SKILL.md 예시 — failing test repair loop

---
name: fix-failing-test
description: Fix a failing test by reproducing it, making the smallest code change, and verifying the result.
---

# Fix Failing Test Skill

Use this when the user gives a failing test, CI output, or regression.

## Loop
1. Identify the exact failing test and command.
2. Re-run only the targeted test first.
3. Inspect nearby implementation and existing patterns.
4. Make the smallest coherent fix.
5. Re-run the targeted test.
6. If it passes, run the related test file or package test.
7. Stop after 3 failed attempts and summarize blockers.

## Rules
- Do not rewrite broad modules to fix one test.
- Do not delete assertions unless the user explicitly asks.
- Add regression coverage when the failure reveals a missing edge case.

## Report
- Root cause
- Change summary
- Commands run
- Remaining risk

Claude Code hooks 예시 — 수정 후 자동 format

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs pnpm prettier --write"
          }
        ]
      }
    ]
  }
}

위험 명령 차단 정책 예시

# 정책 아이디어
- rm -rf, DROP TABLE, terraform apply, kubectl delete는 사람 승인 필요
- .env, secrets, credentials 파일은 읽기/쓰기 금지
- main/master 직접 push 금지
- migration 파일 생성 시 자동 중단 후 승인 요청
- 500줄 이상 diff 발생 시 루프 중단 후 요약

Claude Code에 바로 줄 수 있는 루프 지시문

이 작업은 Loop Engineering 방식으로 진행하세요.

목표:
- [여기에 목표 입력]

루프 규칙:
1. 먼저 관련 파일과 기존 패턴을 조사하세요.
2. 수정 전 간단한 계획을 작성하세요.
3. 한 번에 작은 변경만 하세요.
4. 각 변경 후 가능한 가장 좁은 검증 명령을 실행하세요.
5. 실패하면 로그를 읽고 원인을 가설화한 뒤 수정하세요.
6. 3회 이상 같은 실패가 반복되면 멈추고 원인/대안을 보고하세요.
7. 인증, 결제, DB migration, 배포 설정 변경은 승인 없이 하지 마세요.

완료 보고:
- 변경 요약
- 실행한 검증 명령과 결과
- 남은 리스크
- 다음 추천 작업

10. 엔지니어 관점 추천 도입안

우선 만들면 좋은 3개 루프

1. Bugfix Loop: 이슈 → 재현 테스트 → 최소 수정 → 테스트/빌드 → PR 요약
2. PR Review Loop: 리뷰 댓글 수집 → 항목별 수정 → 검증 → 댓글 답변 초안
3. RAG/AI Eval Loop: 실패 답변 trace → 케이스셋 추가 → prompt/retrieval 변경 → eval 비교

1인 개발/컨설팅 업무에 바로 쓰는 방식

• 고객 프로젝트마다 AGENTS.md를 첫 산출물로 작성합니다.
• 작업 전 “성공 조건/검증 명령/금지 파일”을 명시합니다.
• Claude Code에는 로컬 세밀 작업, Codex에는 독립 이슈 처리/PR 초안 작업을 맡깁니다.
• 결과물에는 “AI가 실행한 검증 증거”를 포함해 신뢰도를 높입니다.

11. 참고자료

아래 자료를 기반으로 2026년 6월 16일 기준으로 정리했습니다. 일부 블로그는 신흥 개념 설명 자료이므로, 공식 문서와 연구 자료를 함께 교차 확인했습니다.

1. Addy Osmani, Loop Engineering, 2026-06-07.
2. Kilo, What Is Loop Engineering? AI Feedback Loops, 2026-06-10.
3. Langfuse, AI is eating the AI engineering loop, 2026-06-09.
4. OpenAI Developers, Codex web.
5. OpenAI Developers, Codex cloud environments.
6. Anthropic Claude Code Docs, Automate actions with hooks.
7. Anthropic Claude Code Docs, Extend Claude with skills.
8. Anthropic Claude Code Docs, Create custom subagents.
9. Anthropic Claude Code Docs, Common workflows.
10. Annie Vella & Kelly Blincoe, The Impact of AI Coding Assistants on Software Engineering: A Longitudinal Study, 2026.
11. Vincent Gurgul et al., The State of Generative AI in Software Development, 2026.
12. Dimple Bajaj, AI-Augmented Closed-Loop Quality Engineering, 2026.