소프트웨어 엔지니어링 에이전트 구축하기

14장의 결정론적 워크플로우는 해법으로 가는 길이 분명할 때 잘 작동한다. 그러나 정답을 미리 알 수 없는 상황 — 탐색과 반복, 적응적 문제 해결이 요구되는 과제라면?

소프트웨어 엔지니어링이 바로 그런 문제다. 코드를 쓴다는 것은 요구사항과 기존 코드베이스의 컨텍스트를 다루고, 작업 분해 계획을 세우고, 다양한 전문 지식을 적용하고, 테스트하고 버그를 수정하며 여러 차례 반복하는 과정이다. 고정된 워크플로우에 깔끔하게 들어맞지 않는다.

똑똑하지만 경험이 적은 주니어 개발자를 멘토링한다고 상상하라 — 워크플로우의 윤곽을 그려줄 것이다. 에이전트는 한 가지가 다르다 — 기반 LLM이 이미 강력한 추론·코딩 기술을 갖췄다. 부족한 것은 파일 시스템과 상호작용하고 명령을 실행하고 상태를 지속시키는 능력 — 그것이 툴이 제공하는 운영 능력이다.

실행 툴이 없으면 에이전트는 눈을 감고 일하는 셈이다 — 검증할 수 없는 코드를 쓰고, 실행해 볼 수 없는 테스트를 제안하며, 실패를 디버깅할 수 없다. 메모리가 학습을 가능케 한다 — 첫 과제에서 만든 testing_pattern.md를 두 번째 과제가 검색해 적용한다. 메타인지 툴은 코드를 수정하지 않는다 — 행동에 앞서 계획하고 남은 일을 추적하는 공간을 제공한다.

툴은 능력을 제공하지만, 프롬프트는 안내한다. 최소한의 프롬프트("You can write code. Use tools.")는 빈약한 결과를 낳는다 — 에이전트는 언제 메모리를 확인할지, 워크플로우를 어떻게 구조화할지, 완료를 어떻게 판단할지 알지 못한다.

instructions = """
You are an expert software engineering agent.

## PHASE 1: MEMORY CHECK (ALWAYS DO THIS FIRST)
1. Use memory tool to view /memories directory
2. Check for relevant patterns and previous decisions

## PHASE 2: PLANNING
1. Use think tool to analyze requirements
2. Use todo_write to create a structured task list

## PHASE 3: EXECUTION
1. Use coding tools  2. Test changes immediately
3. Mark completed, start next  4. Log decisions to /memories

## PHASE 4: VERIFICATION
1. Run tests  2. Check all todos complete  3. Verify quality

## PHASE 5: COMPLETION
NEVER stop with in_progress or pending tasks.
"""

에이전트는 LLM이 더 이상 어떤 툴도 호출하지 않기로 결정할 때 멈춘다. 짧은 과제는 프롬프트 기반 기준으로 충분하다. 그러나 장기 실행 과제 — 44개 파일을 가로지르는 50회 반복의 코드 리뷰 — 는 그렇지 않다.

컨텍스트 엔지니어링 — 압축(compaction), 훅, 격리(4.12절) — 이 데모 에이전트를 실제 일을 처리하는 에이전트로부터 가른다. 적절한 구성 없이는 44개 파일의 리뷰가 쓰레싱이나 조기 종료, 폭주하는 토큰 비용으로 무너진다.