AI 코딩 에이전트 런타임 가이드

AI 코딩 에이전트를 실제 개발 환경에서 운영하기 위한 목표 설정, 실행 루프, 메모리, 권한, 검증, 멀티 에이전트 구조를 정리한 가이드입니다.

AI 코딩 에이전트를 안정적으로 쓰려면 프롬프트가 아니라 실행 계약이 필요합니다. 목표와 완료 조건을 고정하고, 실행 루프와 도구 권한을 정의하고, 작업 기록과 검증 증거를 남기는 구조가 핵심입니다.

왜 런타임 관점이 필요한가

코딩 에이전트를 도구가 아니라 실행 환경으로 봐야 하는 이유입니다.

코딩 에이전트는 왜 런타임이 되는가SWE-bench, SWE-agent, Codex harness 흐름을 기준으로 AI 코딩 도구가 목표, 상태, 권한, 검증을 가진 개발 런타임으로 바뀌는 이유를 정리합니다.
AI 시대의 개발자는 무엇을 설계해야 할까AI 코딩 도구가 실무에 들어오면서 개발자가 새롭게 설계해야 할 컨텍스트, 도구, 권한, 검증, 추적 구조를 정리합니다.
MCP와 A2A 이후, 개발 환경은 IDE가 아니라 Agent Runtime이 된다MCP와 A2A가 AI 개발 환경을 어떻게 바꾸는지, IDE 중심 개발에서 Agent Runtime 중심 개발로 이동하는 흐름을 정리합니다.

에이전트가 언제 작업을 끝내야 하는지 정의하는 방법입니다.

Codex CLI /goal 기능 정리Codex CLI의 /goal로 작업 목표와 완료 조건을 설정하는 방법, /plan·/resume과의 차이, 실무 적용 시나리오와 비용·보안 주의점을 정리합니다.
Codex CLI /goal 내부 구조 분석Codex CLI /goal 기능을 state DB, app server API, model tools, core runtime, continuation prompt 관점에서 코드 레벨로 분석합니다.
Codex /goal로 보는 목표 기반 개발Codex CLI의 persisted /goal 흐름을 기준으로 장시간 코딩 에이전트에 필요한 Goal Contract, Done Criteria, Stop Conditions 설계법을 정리합니다.
AI 코딩 도구를 잘 쓰는 팀은 프롬프트가 아니라 작업 계약서를 만든다AI 코딩 도구를 팀 개발에 적용하기 위해 필요한 AI_GUIDE, TASK_CONTRACT, AI_WORK_LOG, VERIFY_REPORT, PR_TEMPLATE 작성법을 정리합니다.

세션을 넘어 유지해야 할 정보와 그렇지 않은 정보를 구분합니다.

에이전트 메모리와 상태 관리: 단기/장기 메모리와 컨텍스트 압축AI 에이전트의 지속성과 추론 품질을 결정짓는 메모리 아키텍처와 상태(State) 스키마 설계, 단기/장기 메모리 연동, 그리고 컨텍스트 윈도우 압축 기법을 다룹니다.
AI Memory는 RAG가 아니다GitHub Copilot Memory, Claude Code memory, 장기 기억 벤치마크를 기준으로 AI Memory와 RAG의 차이, Run Ledger, 실패 산출물, memory 승격 정책을 정리합니다.
Ctx2Skill을 개발 하네스에 적용해보니Ctx2Skill 논문의 self-play와 Cross-Time Replay 아이디어를 AI 코딩 에이전트 하네스의 AWTL, RSME, MemoryGraph 승격 구조로 적용해 봅니다.
MemoryGraph는 자동 저장소가 아니다AI 코딩 에이전트의 장기 기억을 raw trace가 아니라 replay와 human approval을 통과한 compact rule로 운영해야 하는 이유를 정리합니다.

루프 구조와 여러 에이전트를 나눠야 하는 조건을 봅니다.

AI 에이전트 아키텍처: 루프, 과업 분해, 그리고 추론 경계단순한 LLM 프롬프트 호출을 넘어, 스스로 목표를 세우고 루프를 돌며 행동하는 프로덕션 레벨 AI 에이전트의 핵심 루프와 추론 경계(Reasoning Boundary)를 다룹니다.
도구 연동과 MCP 규격: Tool Calling과 스키마 검증LLM Tool Calling 메커니즘부터 Model Context Protocol(MCP) 표준 규격, Pydantic v2 기반 스키마 검증, 방어적 인자 검증 체크리스트까지 엔터프라이즈 에이전트 도구 연동의 전 과정을 다룹니다.
오케스트레이션과 멀티 에이전트: 수퍼바이저와 HITL 승인 게이트단일 에이전트의 한계를 극복하는 그래프 기반 오케스트레이션, 수퍼바이저 라우팅, 전문 서브에이전트 간 동적 핸드오프, 그리고 안전한 프로덕션 배포를 위한 HITL(Human-in-the-Loop) 승인 게이트와 트랜잭션 상태 관리 기법을 상세히 다룹니다.
A2A와 MCP로 보는 멀티 에이전트 개발 워크플로우A2A Protocol v1.0과 MCP의 차이를 기준으로 Agent Card, Task, Artifact를 개발 하네스의 작업 위임과 산출물 계약으로 해석합니다.

작업이 끝났다는 증거를 남기고 실패를 다음 실행에 반영합니다.

AI 코딩 작업이 끝났다는 증거를 남기는 법: Moonshot Relay 워크플로우Claude Code와 Codex 작업에서 계획, 실행, 검증, 기록을 하나의 흐름으로 묶어 끝났다고 말할 근거를 남기는 Moonshot Relay 구조를 정리합니다.
AI 작업을 끝내는 법복잡한 작업을 AI와 함께 진행할 때 계획, 실행, 확인, 기록을 단계별로 관리하는 방법을 쉽게 정리합니다.
Moonshot Phase Runner 구조 깊게 보기Moonshot Phase Runner의 계획 디렉터리, 상태 파일, 실행 산출물, 검토 게이트를 통해 긴 AI 작업을 안정적으로 운영하는 방법을 정리합니다.
AWTL: 실패 로그를 다음 실행 힌트로 바꾸기Agent Work Trace Logging으로 action, judge result, failure attribution, failed turn case, replay scorecard를 연결해 실패를 재발 방지 힌트로 바꾸는 구조를 정리합니다.
AI 에이전트에게 일을 맡기기 전에 고정해야 할 문서 세트AI 에이전트 작업을 안전하게 맡기기 위해 goal.md, run ledger, artifact contract, memory policy로 작업 경계와 산출물 기준을 고정하는 방법을 정리합니다.