AI와의 개발 방식이 「보완 (Autocomplete)」에서 「위임 (Agent)」으로 크게 변화했습니다. 구현 태스크를 AI 에이전트에게 맡기는 에이전틱 코딩 (Agentic Coding) 의 실천적인 진행 방법을, 2026년 시점의 상황을 바탕으로 정리합니다.

조금 전까지만 해도 AI 활용은 에디터 상에서 코드의 다음 내용을 제안받는 「보완」이 중심이었습니다. 현재의 AI 코딩 에이전트는 지시를 받으면 계획을 세우고, 관련 파일을 읽고, 여러 파일을 편집하며, 테스트를 실행하고, 실패하면 스스로 수정하는 것까지 일련의 과정으로 진행합니다.

인간의 역할은 「코드를 쓰는 사람」에서 「방침을 결정하고, 결과물을 리뷰하는 사람」으로 옮겨가고 있습니다.

둘 다 장단점이 있으므로, 워크플로우에 맞춰 선택하는 것이 현실적인 해답입니다.

「인증 기능을 전부 만들어줘」가 아니라 「로그인 유효성 검사(Validation)를 추가해줘」와 같이, **인간이 리뷰할 수 있는 입도(Granularity)**로 나눕니다. 크게 맡길수록 속도는 빠르게 느껴지지만, 리뷰 불가능한 차분(Diff)은 결국 재작업으로 이어집니다.

테스트 커맨드나 기대하는 동작을 미리 전달하면, 에이전트는 스스로 성패를 판단하여 수정할 수 있습니다.

# 「이 테스트가 통과하도록 구현해줘」라고 의뢰한다
pytest tests/test_login.py -q

「만들고 → 인간이 시도하고 → 고치게 한다」보다, 「만들고 → 스스로 시도하게 하고 → 통과하면 리뷰한다」가 압도적으로 빠르게 돌아갑니다.

2026년 시점에 정착된 실천법은, 리포지토리에 에이전트용 규약 파일을 두는 것입니다.

AGENTS.md— 도구에 의존하지 않는 통일된 포맷. Codex · Cursor · Copilot 등 여러 에이전트가 참조 -
CLAUDE.md— Claude Code가 참조하는 파일

여기에 프로젝트 구성 · 코딩 규약 · 사용하는 커맨드 · 해서는 안 되는 일을 적어두면, 매번 구두로 설명하지 않아도 기존 코드에 어울리는 구현이 돌아옵니다. 홈 → 프로젝트 루트 → 서브 디렉토리 계층으로 덮어쓸 수 있는 운용 방식도 일반적입니다.

# AGENTS.md의 예
## 커맨드
- 테스트: pytest -q
...

에이전트는 고속으로 대량의 코드를 생성합니다. 그렇기 때문에, 차분(Diff)을 반드시 읽는 것이 품질의 핵심입니다.

• 의도와 다른 구현 · 과도한 변경을 걸러낸다
• 「돌아가니까 OK」가 아니라 「왜 이런 구현인가」를 확인한다
• 생성량이 늘어날수록 리뷰가 병목(Bottleneck)이 된다는 전제하에 태스크를 작게 유지한다

에이전트에게 실행 권한을 줄수록 편리해지지만, 그만큼의 대비가 필요합니다.

권한은 최소한으로. 파괴적인 커맨드의 자동 실행은 허가제로 운영한다. 비밀 정보 (API 키 · 패스워드)를 프롬프트나 리포지토리에 두지 않는다. 외부 문서나 Web을 읽게 하는 경우에는, 가져온 텍스트 내의 지시에는 따르지 않게 한다 (프롬프트 인젝션 (Prompt Injection) 대책)

• 에이전틱 코딩의 핵심은 「작게 나누기 · 검증을 맡기기 · 컨텍스트를 정돈하기」 -
• AGENTS.md / CLAUDE.md로 규약을 파일화하면 정밀도가 안정적으로 상승한다 -
• 빨라진 만큼, 리뷰와 권한 관리가 품질과 안전의 핵심이 된다

맡기는 범위를 조금씩 넓혀가며 자신의 워크플로우에 익숙해지도록 합시다.

SNOW CODE / 雪符しき — 프로그램 × 음악 × 칵테일을 사랑하는 눈고양이 엔지니어

• 공식 사이트: snowcode.jp
• 기술 기사 모음: snowcode.jp/tech-blog
• X: @SNOWCODE_JP