에이전틱 엔지니어링: AI 에이전트로 만들고 일을 놓치지 않기

에이전틱 엔지니어링이란?

코딩 에이전트는 코드 조각을 제안하는 채팅 이상의 존재입니다. 프로젝트 폴더에서 직접 일합니다. 파일을 읽고, 코드를 검색하고, 테스트를 실행하고, 여러 파일을 변경하고, 결과를 스스로 확인합니다. 에이전틱 코딩은 에이전트가 하는 일을 가리킵니다. 에이전틱 엔지니어링은 그 주변의 규율, 즉 지시를 쓰고, 결과를 검증할 수 있게 만들고, 책임을 지는 방식을 가리킵니다.

이 용어에는 잘 알려진 대부라 할 사람이 있습니다. 2025년 2월, OpenAI 공동 창업자 Andrej Karpathy는 분위기에 완전히 몸을 맡기고 코드가 존재한다는 사실조차 잊는 프로그래밍 방식을 ‘바이브 코딩’이라고 불렀습니다. Collins는 이 말을 2025년 올해의 단어로 선정했습니다. 1년 뒤인 2026년 2월, Karpathy는 전문적인 형태를 가리키는 용어로 ‘에이전틱 엔지니어링’을 선호한다고 밝혔습니다. 대부분의 시간 동안 코드를 직접 쓰지 않고 에이전트를 지휘하고 감독하기 때문에 ‘에이전틱’이고, 그 안에 기술과 경험이 담겨 있기 때문에 ‘엔지니어링’이라는 것입니다.

에이전틱 엔지니어링과 바이브 코딩의 차이

둘 다 같은 도구를 씁니다. 차이는 미리 얼마나 정하고 나중에 얼마나 철저히 확인하느냐에 있습니다.

바이브 코딩은 잘못이 아니라 알맞은 순간을 위한 도구입니다. 많은 바이브 코더가 실험이 다른 사람이 쓰는 무언가로 바뀌는 순간 엔지니어링으로 넘어갑니다.

사용자가 지휘합니다: 지시, 검토, 결정

에이전틱 엔지니어링에서는 사용자의 일이 바뀝니다. 코드를 덜 입력하고, 세 가지를 더 철저히 합니다.

• 지시: 무엇을 만들지, 언제 완료된 것으로 볼지 설명합니다. 지시가 정확할수록 수정 횟수가 줄어듭니다.
• 검토: diff를 읽고, 테스트 결과를 보고, 결과를 직접 시험합니다. 에이전트는 일이 끝난 것처럼 보이면 멈춥니다. 실제로 끝났는지는 검토만이 보여 줍니다.
• 결정: 병합 또는 재작업, 다음 작업 또는 방향 전환. 이 결정은 사용자에게 남습니다.

코딩 에이전트와 매일 일할 때 생기는 전형적인 마찰

매일 에이전트와 일한다면 이런 지점을 알고 있을 것입니다.

• 미결 사항이 채팅 기록 속에 사라집니다. 세션이 끝날 때 세 가지가 남습니다. 며칠 뒤에는 새 메시지에 묻히거나 세션과 함께 닫혀 버립니다.
• 사용자가 할 일이 긴 답변 속에 숨어 있습니다. 에이전트는 API 키, DNS 레코드 또는 App Store 승인이 필요하다는 것을 요약의 네 번째 문단에서 언급합니다.
• 여러 세션, 여러 프로젝트. 한 윈도우에서는 강의 페이지를, 두 번째에서는 버그 수정을, 세 번째에서는 리서치를 진행합니다. 어디가 어떤 상태인지는 사용자만 압니다.
• 가득 찬 컨텍스트 창. 세션이 길어지면 에이전트의 성능이 떨어집니다. 그래서 Anthropic은 서로 관련 없는 작업 사이에 /clear로 새로 시작하라고 권장합니다. 그러면 파일에 없는 것은 에이전트에게서 사라집니다.

해결책에는 공통점이 하나 있습니다. 작업 상태는 채팅이 아니라 파일에 두어야 합니다.

실전: 오래 유지되는 Claude Code 워크플로

채팅 기록 대신 파일로 된 작업

모든 작업을 에이전트가 읽고 변경할 수 있는 파일로 만듭니다. 제목, 상태, 담당자, 기록을 갖춥니다. 그러면 새 세션마다 “미완료 작업을 처리해 주세요.”로 시작하고, 에이전트는 /clear 뒤에도, 다른 도구에서도 필요한 모든 것을 찾습니다. 세션이 끝날 때 지시는 “미결 사항을 작업으로 만들어 주세요.”입니다.

수락 기준이 있는 스펙

한 줄짜리보다 큰 일에는 스펙을 씁니다. 목표, 요구 사항, 그리고 체크할 수 있는 수락 기준입니다. Anthropic은 Claude Code 모범 사례에서 큰 기능의 경우 먼저 에이전트가 질문하고 스펙을 쓰게 한 뒤, 새 세션에서 구현을 시작하라고 조언합니다. 좋은 스펙은 관련 파일을 명시하고, 범위에서 제외되는 것을 밝히며, 모든 것이 작동함을 보여 주는 확인으로 끝납니다.

자율성 수준 정하기: 실행, 초안, 먼저 질문

모든 작업이 같은 자유를 감당하지는 않습니다. 의존성 업데이트는 에이전트가 그냥 해도 됩니다. 홈페이지 문구는 사용자가 확정할 초안으로 준비해야 합니다. 데이터베이스 마이그레이션은 먼저 물어야 합니다. 이것은 모든 일에 한 번이 아니라 작업마다 정합니다.

요약 대신 반환

에이전트는 일을 마치면 답변만 하지 말고 작업을 반환해야 합니다. 무엇을 했고 결과가 어디에 있는지 메모를 붙여 검토용으로, 또는 무언가 부족하면 질문과 함께 반환합니다. 사용자만 할 수 있는 일은 사용자를 위한 별도의 작업으로 생성합니다.

근거가 있는 검토

주장 대신 근거를 요구하십시오. 테스트 출력, 실행한 명령, 스크린샷. 에이전트가 스스로 확인할 수 있는 것, 예를 들어 테스트나 빌드를 주십시오. 큰 변경에는 Claude Code의 계획 모드(Shift+Tab)가 도움이 됩니다. 에이전트가 무언가를 바꾸기 전에 읽고 계획합니다. 그리고 하위 에이전트처럼 새 컨텍스트에서 한 번 더 살펴보면 에이전트가 자기 코드에서 놓친 빈틈을 찾습니다. 코드 작업은 자체 브랜치에서 하고, 병합은 사용자가 결정합니다.

AGENTS.md와 CLAUDE.md: 에이전트를 위한 안내서

모든 세션은 이전 세션의 기억 없이 시작합니다. 그래서 에이전트가 프로젝트에 관해 알아야 할 것은 시작할 때 읽는 파일에 둡니다. AGENTS.md는 이를 위한 개방형 형식으로, 에이전트를 위한 일종의 README이며 현재 Linux Foundation 산하 Agentic AI Foundation이 관리합니다. Codex, Cursor를 비롯한 많은 도구가 이 파일을 읽습니다. Claude Code는 CLAUDE.md를 읽고, CLAUDE.md가 없으면 AGENTS.md를 대신 읽습니다. @AGENTS.md로 한 파일에 다른 파일을 포함할 수 있습니다. Gemini CLI는 GEMINI.md를 읽으며, 파일 이름은 바꿀 수 있습니다.

# AGENTS.md

## 명령
- 테스트: npm test
- 마무리 전: npm run lint && npm run typecheck

## 규칙
- 자체 브랜치에서 작업하고, main에서는 절대 작업하지 않는다.
- 승인 없이 push나 배포를 하지 않는다.
- 새 의존성은 묻고 나서만 추가한다.

## 작업
작업은 ./tandemloop으로 링크된 TandemLoop에 있다.
먼저 ./tandemloop/AGENTS.md를 읽는다. 나만 할 수 있는 일
(접근 권한, 승인, 결정)은 그곳에 내 담당 작업으로 생성한다.

파일은 짧게 유지하십시오. Anthropic은 CLAUDE.md를 200줄 미만으로, 에이전트가 코드에서 직접 읽을 수 없는 것만 적으라고 권장합니다. 에이전트가 같은 실수를 반복하면 그 규칙을 파일에 넣고, 이미 오래전부터 지키는 규칙은 빼도 됩니다.

도구: Claude Code, Codex, Cursor, Gemini CLI

어떤 도구를 고르느냐보다 어떻게 일하느냐가 더 중요합니다. 지침, 스펙, 작업이 파일에 있으면 에이전트를 바꿔도 새 에이전트가 같은 상태에서 이어받습니다.

TandemLoop이 에이전틱 엔지니어링을 돕는 방법

TandemLoop은 사용자와 에이전트가 같은 작업을 공유하는 Mac, iPad, iPhone용 할 일 앱입니다. 작업은 iCloud Drive에 텍스트 파일로 있으며, 에이전트는 이 파일을 직접 읽고 쓰고 TandemLoop이 제공하는 안내서를 따릅니다. 플러그인이나 API는 필요 없습니다.

여러 에이전트와 세션이 같은 폴더를 읽고 같은 상태를 봅니다. 한 번에 하나만 써야 합니다. 그렇지 않으면 iCloud 동기화에서 충돌 사본이 생길 수 있습니다. 전체 워크플로는 AI 에이전트와 함께 일하기 위한 할 일 앱 페이지에서 보여 주며, 가이드 Claude Code와 Obsidian은 같은 설정이 Obsidian Vault에서 어떻게 보이는지 설명합니다.

코드 밖에서도 TandemLoop은 수신함, 프로젝트, 마감일, 나만의 뷰를 갖춘 완전한 할 일 앱입니다. GTD 방법론을 따른다면 에이전트에게 수신함을 미리 분류하고 주간 검토를 준비하게 하십시오.