피드로 돌아가기
The CORE Agentic Workflow: Task Plan Review Approve PR
Dev.toDev.to
AI/ML

Planning과 Execution 분리를 통한 Agent 제어권 확보 및 PR 기반 검증 체계 구축

The CORE Agentic Workflow: Task Plan Review Approve PR

Sahil Kathpal2026년 4월 30일15intermediate

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별 권한 및 스타일 제어 체계를 갖추었는가?

원문 읽기