AI 코딩 에이전트 결과물 리뷰하기: 실무 코드 리뷰 체크리스트

AI 코딩 에이전트를 사용하면 개발 속도는 확실히 빨라집니다. 요구사항을 설명하면 컴포넌트, API 호출 코드, 테스트 코드, 리팩토링까지 빠르게 만들어 줍니다. 특히 반복적인 CRUD, 폼 처리, 타입 정의, 테스트 초안처럼 구조가 어느 정도 정해진 작업에서는 체감 효과가 큽니다.하지만 AI가 만든 코드가 빠르다고 해서 그대로 머지해도 된다는 뜻은 아닙니다. 오히려 AI 코드는 사람이 작성한 코드보다 더 조심해서 봐야 할 때가 많습니다.요구사항을 일부만 반영했을 수 있습니다.기존 프로젝트 규칙과 다른 패턴을 만들 수 있습니다.정상 케이스만 처리하고 예외 케이스를 놓칠 수 있습니다.테스트는 통과하지만 실제 UX가 어색할 수 있습니다.관련 없는 파일을 함께 수정했을 수 있습니다.이전 글에서 Vibe Cod..

MCP 서버 실전 예제: GitHub 이슈를 AI 에이전트에게 연결하기

최근 AI 코딩 도구들은 단순히 질문에 답하는 수준을 넘어 실제 개발 환경과 연결되는 방향으로 발전하고 있습니다. 파일을 읽고, 코드를 수정하고, 테스트를 실행하고, GitHub 이슈나 문서를 참고하면서 작업하는 식입니다.이때 중요한 개념 중 하나가 MCP(Model Context Protocol) 입니다.MCP는 AI 에이전트가 외부 도구나 데이터에 접근할 수 있도록 해주는 표준화된 연결 방식입니다. 쉽게 말하면 AI에게 “이 도구를 이런 방식으로 사용할 수 있다”고 알려주는 인터페이스입니다.이전 글에서 MCP가 무엇인지 개념을 살펴봤다면, 이번 글에서는 조금 더 실전적인 예제로 들어가보겠습니다. 목표는 간단합니다.AI 에이전트가 GitHub 저장소의 이슈 목록을 조회할 수 있도록 MCP 서버를 만들어..

AI 코딩 에이전트와 테스트 주도 개발: 테스트부터 맡기는 실무 흐름

AI 코딩 도구를 사용하면 기능 구현 속도는 확실히 빨라집니다. Cursor, Claude Code, GitHub Copilot, Codex 같은 도구에게 요구사항을 설명하면 컴포넌트, API 호출 코드, 유틸 함수, 테스트 코드까지 빠르게 생성해 줍니다.하지만 실제 프로젝트에 적용해보면 속도만큼이나 불안한 부분도 생깁니다.요구사항을 일부만 이해하고 구현한다.정상 케이스만 처리하고 예외 케이스를 놓친다.기존 코드 컨벤션과 다른 방식으로 작성한다.동작하는 것처럼 보이지만 실제로는 회귀 버그를 만든다.수정 요청을 했더니 관련 없는 파일까지 바꾼다.그래서 AI 코딩을 실무에 안정적으로 적용하려면 “코드를 먼저 만들고 사람이 확인하는 방식”에서 조금 벗어날 필요가 있습니다. 이때 도움이 되는 접근이 테스트 주도..

AI 코딩 도구를 쓰면 개발 속도는 확실히 빨라집니다. Cursor, Claude Code, GitHub Copilot, Codex 같은 도구에게 요구사항을 말하면 코드 초안이 빠르게 만들어집니다. 간단한 화면이나 프로토타입을 만들 때는 특히 유용합니다.하지만 실제 프로젝트에 적용해보면 이런 문제가 자주 생깁니다.- “처음에는 잘 돌아가는 것처럼 보였는데 요구사항과 다르다.”- “코드는 그럴듯하지만 예외 처리가 빠져 있다.”- “기존 프로젝트 구조를 무시하고 새 패턴을 만들어버렸다.”- “수정해달라고 했더니 관련 없는 파일까지 바뀌었다.”이런 방식의 AI 코딩을 흔히 Vibe Coding이라고 부릅니다. 대략적인 느낌만 전달하고, AI가 만든 코드를 실행해보면서 되는 것 같으면 넘어가는 방식입니다. 작은..

요즘 AI 개발 도구는 단순히 질문에 답하는 수준을 넘어섰습니다. 이제 AI는 코드를 읽고, 파일을 수정하고, 테스트를 실행하고, GitHub 이슈를 확인하고, 외부 API를 호출하는 방향으로 발전하고 있습니다.그런데 여기서 중요한 문제가 생깁니다. AI가 외부 도구나 데이터에 안전하고 일관된 방식으로 접근하려면 어떻게 해야 할까요?예를 들어 AI에게 이런 작업을 시키고 싶다고 해보겠습니다.“내 프로젝트의 GitHub 이슈를 조회해줘”“고객 주문 API에서 최근 주문 목록을 가져와줘”“로컬 문서에서 특정 내용을 찾아줘”“사내 데이터베이스에서 프로젝트 상태를 확인해줘”이런 작업을 하려면 AI가 외부 시스템과 연결되어야 합니다. 기존 방식이라면 각 AI 도구마다 별도의 연동 코드를 만들어야 했습니다.Clau..

최근 개발 방식은 빠르게 바뀌고 있다. 이전에는 ChatGPT에게 코드를 물어보고, 답변을 복사해서 프로젝트에 붙여 넣는 방식이 많았다.하지만 이제는 Cursor, Claude Code, GitHub Copilot, Codex 같은 AI 코딩 에이전트가 실제 코드베이스를 읽고, 파일을 수정하고, 테스트를 실행하고, PR 단위 작업까지 수행하는 방향으로 발전하고 있다. 이때 중요한 문제가 생긴다AI는 우리 프로젝트의 규칙을 어떻게 알 수 있을까?사람 개발자는 README를 읽고, 기존 코드를 보고, 팀 컨벤션을 파악하면서 작업한다. 하지만 AI 에이전트에게는 프로젝트 규칙을 더 명확하게 알려줘야 한다.이때 사용하는 파일이 바로 `AGENTS.md`다. 쉽게 말해 AI 에이전트를 위한 작업 지침서다.READ..