피드로 돌아가기
Dev.toAI/ML
원문 읽기
Planning과 Execution 분리를 통한 Agent 제어권 확보 및 PR 기반 검증 체계 구축
The CORE Agentic Workflow: Task Plan Review Approve PR
AI 요약
Context
기존 Agentic Loop의 단일 세션 구조로 인해 사용자 의도와 실제 실행 사이의 Checkpoint 부재 발생. Agent가 내린 결정 사항을 실행 완료 후 결과물(Code)로만 확인해야 하는 가시성 부족 및 제어 불능 상태가 핵심 한계점으로 작용.
Technical Solution
- Planning과 Execution을 별도의 세션으로 분리하여 Agent의 임의 실행 가능성을 원천 차단하는 구조 설계
- Task.md 내 명시적인 Stop Instruction을 통한 Agent의 실행 단계 진입 제어 및 강제 중단 메커니즘 구현
- Plan.md라는 명세서를 통해 수정 대상 파일, 의존성, 실행 순서를 사전 정의하고 인간의 승인 후 Execution 세션으로 전달하는 Handoff 전략 채택
- Scope, Soul, Guardrail 파일의 3계층 설정 구조를 통해 Agent의 행동 반경과 의사결정 휴리스틱을 정교하게 제어
- 실행 후 QA Inspector Agent를 독립적으로 배치하여 Approved Plan 대비 Scope Violation 및 보안 취약점을 교차 검증하는 감사 레이어 구축
실천 포인트
- [ ] Agent 세션을 '계획'과 '실행'으로 분리하여 단일 세션 내의 암묵적 승인 위험을 제거했는가? - [ ] Task 정의서 마지막에 명확한 중단 지침(Stop Instruction)을 배치하여 가중치를 높였는가? - [ ] Plan.md에 수정 파일 리스트와 의존성 버전이 구체적으로 명시되었는가? - [ ] QA Inspector Agent에게 구체적인 검증 루브릭(Rubric)을 제공하여 모호한 검토를 방지했는가? - [ ] Scope-Soul-Guardrail 파일을 통한 Agent별 권한 및 스타일 제어 체계를 갖추었는가?