AI 에이전트를 '얹는' 것과 '심는' 것의 차이
AI 코딩 도구를 팀에 도입할 때 흔히 저지르는 실수가 있다. 도구를 기존 워크플로우 위에 그냥 '얹는' 것이다. ChatGPT 창을 하나 더 띄우거나, Copilot 자동완성에 의존하는 방식이 대표적이다. 결과는 예측 가능하다—초반엔 신기하고, 금방 노이즈가 된다.
진짜 생산성 변화는 AI 에이전트를 파이프라인 안에 '심을' 때 일어난다. 프롬프트 입력 단계부터 PR 머지 직전까지, 에이전트가 개발 흐름의 각 단계에 구조적으로 배치될 때 비로소 도구가 인프라가 된다. 최근 세 가지 움직임이 이 흐름을 뚜렷하게 보여준다.
Vercel 플러그인: 컨텍스트가 곧 정확도다
Vercel이 코딩 에이전트를 위한 플러그인을 출시했다(GeekNews). 표면적으로는 'Vercel 관련 지식을 에이전트에 추가하는 도구'처럼 보이지만, 실제 설계 방식이 더 흥미롭다.
이 플러그인은 단순한 문서 검색(RAG)이 아니다. 파일 편집과 터미널 명령 같은 실시간 활동을 관찰하면서, 지금 이 순간 에이전트에게 필요한 Vercel 관련 지식만 골라서 컨텍스트에 주입한다. Next.js 라우팅 파일을 건드리면 Routing Middleware 스킬이 트리거되고, 환경변수를 다루면 /env 커맨드가 활성화되는 식이다. 47개 이상의 스킬이 관계형 지식 그래프로 연결되어 있고, 7개 라이프사이클 훅을 통해 우선순위 기반으로 주입된다.
이 접근의 핵심은 컨텍스트 윈도우를 낭비하지 않는다는 점이다. 모든 플랫폼 지식을 한꺼번에 때려넣는 대신, 지금 하는 작업과 관련된 지식만 적시에 올린다. PostToolUse 검증이 deprecated 패턴이나 sunset 패키지를 실시간으로 감지하는 것도 같은 철학이다—에이전트가 틀린 방향으로 달려가기 전에 파이프라인 안에서 막는다.
현재 Claude Code와 Cursor를 지원하고, OpenAI Codex 지원도 예정되어 있다. npx plugins add vercel/vercel-plugin 한 줄로 설치된다.
Claude Code 실전 운용: 에이전트를 잘 쓰는 건 별도의 스킬이다
GeekNews에 소개된 'Claude Code 50가지 팁'은 1년간의 일일 사용 경험을 바탕으로 한 실전 모음집이다. 50개 팁 전체보다 그 안에 흐르는 공통 원리가 중요하다.
컨텍스트를 설계하라. CLAUDE.md는 단순한 설정 파일이 아니라 에이전트와의 계약서다. /init으로 초안을 만들되, "이 줄 없이 Claude가 실수할까?"를 기준으로 절반을 쳐내야 한다. 중요한 지시가 노이즈에 묻히면 준수율이 떨어진다. 실수가 반복되면 "CLAUDE.md를 업데이트해서 이 실수가 반복되지 않게 해"라고 지시하면 에이전트가 스스로 규칙을 작성하고 다음 세션부터 따른다. 살아있는 문서가 된다.
피드백 루프를 프롬프트 안에 넣어라. "auth 미들웨어를 JWT로 리팩토링해. 변경 후 기존 테스트 스위트를 실행하고, 실패를 모두 수정한 후 완료해"처럼 검증 수단을 프롬프트에 포함시키면 Claude가 스스로 실수를 잡는 루프가 형성된다. Boris Cherny에 따르면 이것만으로 2~3배 품질 향상이 가능하다. UI 변경이라면 Playwright MCP 서버를 붙여 브라우저 수준의 검증까지 루프에 포함할 수 있다.
병렬성을 활용하라. --worktree 플래그로 독립된 브랜치와 파일 시스템을 가진 Claude 세션을 3~5개 동시에 돌릴 수 있다. 서브에이전트로 탐색 비용을 메인 컨텍스트에서 분리하고, 실험적이지만 에이전트 팀 기능으로 리팩토링 작업을 병렬 분배하는 것도 가능하다.
컨텍스트 위생을 지켜라. 같은 문제를 두 번 수정해도 해결이 안 되면 /clear로 새로 시작하는 게 낫다. 실패한 접근법이 쌓인 컨텍스트는 다음 시도에 독이 된다. 깨끗한 세션에 날카로운 프롬프트가 지저분한 3시간 세션을 거의 항상 능가한다.
코드 리뷰 자동화: 파이프라인의 마지막 관문
dev.to의 '2026년 코드 리뷰 자동화 완전 가이드'는 AI 에이전트가 코드를 쓰는 것만큼, 쓰여진 코드를 검증하는 자동화도 파이프라인의 핵심 축임을 상기시킨다.
Google 엔지니어링 연구에 따르면 평균 PR은 첫 리뷰까지 24시간을 기다리고, Microsoft 내부 연구에선 개발자가 주당 6~12시간을 코드 리뷰에 쓴다. 10명 팀이라면 매년 1~2명분의 인건비가 리뷰 오버헤드로 증발하는 셈이다.
이 가이드가 제안하는 3계층 구조가 AI 에이전트 시대에 특히 유효하다. 린터(Linting)는 스타일과 문법을 결정론적으로 처리하고, 정적 분석은 null 역참조나 SQL 인젝션처럼 문법적으로 맞지만 논리적으로 틀린 코드를 잡으며, AI 리뷰(CodeRabbit, GitHub Copilot, PR-Agent 등)는 비즈니스 로직의 의도와 엣지 케이스 누락처럼 맥락이 필요한 영역을 담당한다.
세 계층은 서로 다른 카테고리의 문제를 잡는다. 린터는 로직 오류를 못 보고, 정적 분석은 팀 컨벤션을 모르며, AI 리뷰는 포맷 체크만큼 빠르거나 결정론적이지 않다. 겹치지 않기 때문에 셋 다 필요하다. 자동화가 리뷰 코멘트의 60~80%를 처리하면, 시니어 엔지니어는 아키텍처와 비즈니스 로직—진짜 인간 판단이 필요한 영역에 집중할 수 있다.
파이프라인을 연결하면 보이는 것
세 흐름을 하나의 파이프라인으로 이어보면 구조가 선명해진다.
- 코딩 단계: Vercel 플러그인이 플랫폼 지식을 실시간으로 주입하고, Claude Code가 피드백 루프가 내장된 프롬프트로 코드를 생성한다.
- 검증 단계: LSP 플러그인과 테스트 명령이 에이전트의 자기 검증 루프 안에 포함되고,
--worktree로 병렬 실험이 격리된다. - 리뷰 단계: 린터→정적 분석→AI 리뷰의 3계층이 PR 머지 전 자동으로 게이트를 형성한다.
각 단계에서 에이전트는 '생성'뿐 아니라 '검증'과 '컨텍스트 관리'의 역할까지 수행한다. 이것이 AI를 얹는 것과 심는 것의 차이다.
전망: 플랫폼이 에이전트를 흡수하는 속도
Vercel 플러그인의 등장이 흥미로운 이유는 플랫폼이 스스로 에이전트 친화적 인터페이스를 설계하기 시작했다는 신호이기 때문이다. 앞으로는 더 많은 SaaS와 클라우드 플랫폼이 자신의 지식 그래프를 에이전트 컨텍스트에 주입하는 플러그인을 제공할 것이다. 개발자가 플랫폼 문서를 찾아 읽는 행위 자체가 줄어드는 방향으로 흐른다.
Claude Code의 50가지 팁이 결국 말하는 것도 하나다—에이전트를 잘 쓰는 것은 별도의 스킬이고, 그 스킬의 핵심은 컨텍스트 설계와 피드백 루프 구성이다. 코드 리뷰 자동화의 3계층 구조는 AI가 생성한 코드를 AI가 검증하는 루프를 파이프라인에 정식으로 편입시키는 첫 걸음이다.
프롬프트를 잘 쓰는 것은 시작일 뿐이다. 에이전트가 파이프라인의 각 단계에 구조적으로 배치될 때, 개발 속도와 코드 품질이 동시에 올라가는 진짜 레버리지가 생긴다.