Agent Loop Architect (루프 엔지니어링)은(는) 무엇을 하나요?
개요
Agent Loop Architect는 지속적인 메모리와 상태 추적을 통해 다중 에이전트 워크플로우를 복잡한 다단계 작업을 위한 폐쇄 루프 반복으로 조율하는 실행 표준이자 설계 패턴입니다.
에이전트 실행을 일회성 프롬프트나 선형 파이프라인으로 처리하는 대신, Agent Loop는 하위 에이전트가 전문화되고, 객관적인 게이트를 통해 작업을 검증하며, 실행 간에 체계적으로 학습하는 반복적인 라이프사이클을 강제합니다.
루프의 두 가지 황금률
- 사전 학습 없는 실행 금지: 솔루션을 제안하거나 구현하기 전에, 에이전트는 학습 단계를 실행하여 메모리에 있는 기존 긍정 및 부정 패턴을 반드시 참고해야 합니다.
- 압축 없는 완료 금지: 코드나 콘텐츠가 작성되었다고 해서 사이클이 끝난 것이 아닙니다. 압축 단계가 결과를 메모리에 증류하고 상태를 업데이트한 후에야 완료됩니다.
flowchart TD
Start([작업 시작]) --> Learn[1. 학습: .loop-memory/ 참조]
Learn --> Plan[2. 계획: 단계 분해 및 etapas.json]
Plan --> Exec[3. 실행: 전문화된 하위 에이전트 파견]
Exec --> Verify{4. 검증: 객관적 게이트 통과?}
Verify -- 아니오: 회귀/전환 --> Learn
Verify -- 예 --> Compress[5. 압축: 메모리 증류 및 상태 업데이트]
Compress --> Done([루프 완료])
루프의 5단계
모든 루프 사이클은 엄격하게 다섯 단계를 통해 진행됩니다.
1단계: 학습 (사전 실행 정보 수집)
- 필수 확인: 하위 에이전트는 다음을 반드시 읽어야 합니다.
.loop-memory/positive-cases/(성공 패턴, 검증된 수정, 전환율이 높은 카피 앵글, 최적의 프롬프트 템플릿).loop-memory/negative-cases/(안티 패턴, 실패한 가설, 엣지 케이스 회귀, 금지된 접근 방식)
- 목표: 에이전트가 이전에 기록된 실수를 반복하는 것을 방지하고 입증된 패턴의 재사용을 강제합니다.
2단계: 계획 및 조율 (상태 초기화)
- 목표를 개별적인 순서가 있는 단계로 분해합니다.
- 단계 상태, 할당된 하위 에이전트, 입력, 출력 및 승인 기준으로
etapas.json을 초기화하거나 업데이트합니다. - 도메인 요구 사항에 맞는 전용 하위 에이전트 역할을 할당합니다.
3단계: 실행 (전문화된 하위 에이전트 파견)
- 단계 종속성에 따라 하위 에이전트를 순차적으로 또는 병렬로 실행합니다.
- 하위 에이전트는 격리된 컨텍스트에서 작업하며, 대화 기록 전체가 아닌 간결한 아티팩트나 diff를 전달합니다.
4단계: 검증 및 평가 (객관적 승인 게이트)
- 명시적이고 자동화되었거나 결정론적인 기준(예: 단위/통합 테스트 결과, 린팅, 인용 사실 확인, 어조 준수)에 대해 실행 출력을 검증합니다.
- 검증에 실패한 경우:
- 실패를 중간 부정 패턴으로 문서화합니다.
- 실패 피드백과 함께 학습/계획으로 돌아갑니다.
- 검증에 통과한 경우: 압축으로 진행합니다.
5단계: 압축 (사후 메모리 증류)
- 긍정 증류: 성공한 정확한 패턴, 템플릿, 프롬프트 조각 또는 코드 수정을 추출하여
.loop-memory/positive-cases/CASE-<ID>.md에 기록합니다. - 부정 증류: 막다른 길, 기각된 가설 및 회귀를
.loop-memory/negative-cases/CASE-<ID>.md에 문서화합니다. - 상태 최종화: 완료 타임스탬프, 최종 아티팩트 및 실행 메트릭으로
etapas.json을 업데이트합니다.
디렉터리 구조 및 메모리 아키텍처
루프 패턴으로 운영되는 모든 프로젝트는 다음 루트 또는 워크스페이스 구조를 준수해야 합니다.
<프로젝트-루트>/
├── .loop-memory/
│ ├── positive-cases/
│ │ ├── CASE-001-fix-auth-race-condition.md
│ │ └── CASE-002-high-conversion-cold-hook.md
│ └── negative-cases/
│ ├── CASE-001-failed-jwt-in-localstorage.md
│ └── CASE-002-clickbait-hook-bounce.md
├── etapas.json
├── references/
│ └── domain-examples.md
└── SKILL.md
메모리 케이스 스키마 (.loop-memory/*/CASE-*.md)
각 케이스 파일은 다음 표준화된 마크다운 템플릿을 따라야 합니다.
# 케이스: [짧은 설명 제목]
- **날짜:** YYYY-MM-DD
- **도메인:** [엔지니어링 | 카피라이팅 | 영업 | 연구]
- **유형:** [긍정 | 부정]
- **트리거/컨텍스트:** [정확한 상황, 오류 메시지 또는 프롬프트 목표]
## 패턴 / 기술
[무엇이 효과가 있었는지 또는 왜 실패했는지에 대한 자세한 설명]
## 구체적인 아티팩트 / 코드 스니펫 / 프롬프트
```[언어]
[구체적인 스니펫, 템플릿 또는 diff를 여기에 붙여넣으세요]
핵심 요점 및 휴리스틱
- Do: [향후 에이전트를 위한 실행 가능한 규칙]
- Don't: [피해야 할 사항]
### `etapas.json` 스키마
`etapas.json` 파일은 현재 라이프사이클 진행 상황을 추적합니다.
```json
{
"project": "agent-loop-project",
"loop_version": "2.0.0",
"updated_at": "2026-11-06T21:00:00Z",
"current_stage": "fix",
"stages": [
{
"id": "reproduce",
"role": "QA 재현 하위 에이전트",
"status": "completed",
"input": "버그 보고서 #402",
"output": "tests/repro_spec.ts",
"memory_consulted": ["CASE-001-fix-auth-race-condition.md"]
},
{
"id": "fix",
"role": "핵심 수정 엔지니어 하위 에이전트",
"status": "in_progress",
"input": "tests/repro_spec.ts",
"output": null,
"memory_consulted": []
}
],
"metrics": {
"total_cycles": 1,
"positive_patterns_harvested": 0,
"negative_patterns_avoided": 1
}
}
통합 도메인 아키타입
Agent Loop Architect는 4가지 전투 테스트를 거친 도메인 파이프라인을 포함합니다. 각 아키타입에 대한 완전한 단계별 지침 및 프롬프트는 domain-examples.md를 참조하십시오.
1. 버그 수정 및 엔지니어링
- 파이프라인:
재현 -> 근본 원인 -> 수정 -> 테스트 -> 문서화 - 학습 확인: 관련 하위 시스템에 대한 이전 수정 사항을 참고하여 과거 회귀를 방지합니다.
- 검증 게이트: 재현 테스트가 RED에서 GREEN으로 변경되었으며, 다른 테스트가 손상되지 않았습니다.
- 압축: 근본 원인 설명과 최소한의 수정 diff를
.loop-memory/positive-cases/에 저장합니다.
2. 콘텐츠 및 카피라이팅
- 파이프라인:
대상 및 앵글 조사 -> 훅 및 내러티브 초안 -> 비평 및 어조 다듬기 -> 교정 및 사실 확인 -> 배포 패키징 - 학습 확인: 최고 성과를 낸 훅과 금지된 유행어/클리셰를 읽습니다.
- 검증 게이트: 대상 읽기 수준, 브랜드 보이스 루브릭 점수 8.5/10 이상, 확인된 사실 주장.
- 압축: 고성과 앵글과 훅 공식을 메모리에 저장합니다.
3. 영업 아웃리치
- 파이프라인:
ICP 인텔리전스 -> 가치 가설 -> 개인화된 시퀀싱 -> 이의 제기 대응 -> 발송 준비 - 학습 확인: 가치 제안, 이의 제기 패턴 및 잘못된 가정에 대한 응답률을 조회합니다.
- 검증 게이트: 구체성 체크리스트(일반적인 메일 머지 라인 금지), 스팸 가이드라인 준수.
- 압축: 성공적인 개인화 훅을 저장하고 응답률이 낮은 앵글을 부정 케이스에 기록합니다.
4. 연구, 재무 및 법률 분석
- 파이프라인:
발견 및 소스 수집 -> 사실 확인 및 위험 매트릭스 -> 정량적/법적 종합 -> 시나리오 스트레스 테스트 -> 경영진 브리핑 - 학습 확인: 선례 사례, 과거 분석 누락 및 데이터 유효성 표준을 참고합니다.
- 검증 게이트: 100% 인용된 소스 추적 가능; 위험 매트릭스가 스트레스 시나리오에 대해 테스트됨.
- 압축: 합성 템플릿, 소스 신뢰도 등급 및 위험 평가 휴리스틱을 저장합니다.
하위 에이전트 파견 지침
루프 내에서 하위 에이전트를 파견할 때:
- 역할 특정성: 일반 에이전트에게 프롬프트를 보내지 마십시오. 프롬프트 앞에 도메인 역할 지침을 붙이십시오(예:
당신은 QA 재현 하위 에이전트입니다...). - 메모리 주입: 초기 하위 에이전트 프롬프트에 관련
.loop-memory/케이스의 경로 또는 요약을 항상 제공하십시오. - 개별적인 인계: 하위 에이전트는 대화 기록보다는 명시적인 파일(예: 재현 스크립트, 초안 파일, 평가 루브릭)을 통해 통신해야 합니다.
- 자율 단계 게이트: 하위 에이전트는 검증 가능한 증거(로그, 테스트 출력, 검증 점수) 없이
etapas.json상태를"completed"로 변경할 수 없습니다.
일반적인 실수 및 안티 패턴
| 안티 패턴 | 루프를 깨뜨리는 이유 | 올바른 사례 |
|---|---|---|
| 학습 단계 건너뛰기 | 에이전트가 알려진 버그를 재발견하거나 기각된 카피 앵글을 사용합니다. | 모든 프롬프트에서 0단계로 .loop-memory/ 읽기를 강제합니다. |
| 압축 단계 생략 | 세션 컨텍스트가 재설정되자마자 교훈이 손실됩니다. | 성공/실패 케이스를 파일로 증류하지 않고 작업을 종료하지 마십시오. |
| 모놀리식 에이전트 실행 | 단일 에이전트가 계획, 코딩, 검증 및 문서화를 동시에 시도하다가 혼란스러워집니다. | 각 개별 단계에 대해 전문화된 하위 에이전트를 파견하십시오. |
| 소프트 검증 ("괜찮아 보임") | 할루시네이션이 프로덕션에 유입됩니다. | 결정론적 게이트(테스트 스위트, 린터 출력, 사실 인용)를 사용하십시오. |
| 무제한 재시도 루프 | 에이전트가 수정 불가능한 결함에 대해 무한 루프에 빠집니다. | 루프 재시도를 3회 반복으로 제한한 후 인간 에스컬레이션 게이트를 트리거하십시오. |