좋은 루프의 7가지 구성 요소

루프를 '그냥 여러 번 실행되는 에이전트'로 생각하면 위험합니다. 검증이 없거나, 종료 조건이 없거나, 예산이 없는 루프는 엉뚱한 방향으로 계속 달리다가 API 비용을 무한정 쓰거나 파일을 망가뜨릴 수 있습니다. 좋은 루프에는 반드시 갖춰야 할 7가지 요소가 있습니다.

7요소 한눈에 보기

1. 목적 — 검증 가능한 형태로

'코드 품질 개선'처럼 모호한 표현은 안 됩니다. '테스트 커버리지를 60%에서 80%로 올리기' 또는 'TypeScript 타입 오류를 0개로 만들기'처럼 기계가 측정할 수 있는 형태여야 합니다. 목적이 명확해야 루프가 끝날 수 있습니다.

2. 편집가능범위 — 범위가 곧 안전망

루프를 시작하기 전에 '이 루프는 src/components/ 폴더 내 파일만 수정할 수 있다'처럼 범위를 명확히 정의하세요. 그 외 파일은 읽기(read)만 허용하거나 완전히 차단합니다. 범위가 좁을수록 실수의 영향이 작습니다.

3·4. 지표와 예산 — 나침반과 연료통

지표는 루프가 올바른 방향으로 가는지 확인하는 나침반입니다. 테스트 통과 수, 타입 오류 수, 린트 경고 수처럼 자동으로 측정 가능해야 합니다. 예산은 최대 반복 횟수와 비용 상한선 두 가지를 모두 설정하세요. 예산이 없으면 루프가 무한정 실행될 수 있습니다.

5. 품질게이트 — '통과해야 다음으로'

품질게이트는 각 단계에서 '이 수준을 통과해야만 다음 단계로 간다'는 체크포인트입니다. '코드를 수정했으면 반드시 타입 체크를 통과해야 커밋할 수 있다'처럼요. 게이트를 통과하지 못하면 루프는 수정을 재시도하거나 에스컬레이션합니다.

6. 메모리 — 이전 반복의 기록

에이전트의 대화 창(context window)은 세션이 끝나면 사라집니다. 좋은 루프는 중요한 정보를 외부 파일에 기록합니다. 무엇을 시도했고, 어떤 오류가 났고, 어떤 방법을 이미 써봤는지 — 이런 기록이 있어야 다음 반복에서 같은 실수를 반복하지 않습니다.

7. 정지조건 — 세 가지 유형

• 성공 조건: 목적이 달성되었을 때 — 예: '타입 오류 0개 달성'
• 실패 조건: 예산 소진 또는 N번 시도 후 진전 없음 — 예: '3회 연속 변화 없음'
• 에스컬레이션 조건: 사람의 판단이 필요한 상황 — 예: '같은 오류 5회 반복'

루프 설계 템플릿 (의사코드)

loop:
  purpose: 테스트 통과율 80% 달성 (현재 52%)
  scope:
    write:
      - src/
    read:
      - tests/
      - package.json
    blocked:
      - supabase/migrations/
  metric: npm test -- --coverage
  budget:
    max_iterations: 15
    max_cost_usd: 3.0
  quality_gates:
    - npx tsc --noEmit   # 타입 오류 0
    - npm run lint        # 린트 경고 0
  memory: tasks/loop-state.md
  stop_conditions:
    success: coverage >= 80%
    stall: 3회 연속 변화 없음
    escalate: 같은 오류 5회 반복

처음 루프를 설계할 때는 예산을 작게 잡고 시작하세요. 최대 반복 3~5번, 비용 $1 이하. 작은 루프가 잘 작동하는 것을 확인한 후 점진적으로 범위를 늘리는 것이 안전합니다.

7요소 중 하나라도 빠지면 루프의 안전성이 크게 떨어집니다. 특히 정지조건과 품질게이트가 없는 루프는 절대 무인 자동화로 돌리지 마세요. 처음에는 사람이 각 반복을 승인하는 모드로 시작하세요.