CodeRabbit Plan으로 Slack에서 아이디어를 코드로 만들기
해당 블로그는 Priyanka Kukreja 원저자의 글 'Plan with CodeRabbit Agent: Where great engineering work begins'을 번역한 것입니다. 더 나은 이해를 위해서 약간의 의역이 반영되었습니다.
어떤 기능이든 늘 같은 경로를 거쳤습니다. Slack 스레드에서 시작해 Zoom 회의를 잡고 디자인 문서를 쓰다 보면 작업이 절반쯤 진행됐을 때 형제 팀이 의존성을 뒤늦게 지적합니다. 그러고 나면 엔지니어가 그 모든 맥락을 손수 긁어모아 전혀 다른 곳에 있는 코딩 에이전트에 밀어 넣어야 했죠.
CodeRabbit Agent for Slack의 Plan은 이 흐름을 단번에 줄여 줍니다.
아이디어, 계획, 구현이 모두 대화가 시작된 바로 그 Slack 스레드 안에 머뭅니다.
Slack 스레드 어디서든 /plan을 입력하든, CodeRabbit Agent for Slack이 제안할 때 "Plan this work"를 누르든, 메시지 액션으로 실행하든, 모호한 엔지니어링 요청이 아이디어가 제기된 그 대화를 떠나지 않은 채 코드베이스를 이해하는 구조화된 구현 계획으로 바뀝니다.
Plan이 하는 일
Plan은 의도와 코드 사이에 자리한 워크플로입니다. "이걸 하고 싶다"에서 "여기 코드 변경이 있다"로 넘어가는 과정을 빠르게 만들어 줍니다. 세 가지를 함께 살핍니다.
- 요청 그 자체
- 요청을 둘러싼 Slack 스레드의 맥락
- Agent가 이미 이해하고 있는 연결된 저장소(repository)의 맥락
그런 다음 실제 코드베이스에 뿌리내린 계획을 만들어 냅니다. 이 워크플로는 의도적으로 두 단계로 나뉘어 동작합니다.
1단계: 범위가 정해진 브리프(scoped brief).
연관될 법한 저장소와 모듈, 주요 작업 흐름, 위험 요소와 미지수, 검증해야 할 영역, 그리고 어떻게 진행하면 좋을지에 대한 간결한 권고를 짚어 주는 가볍고 빠른 패스입니다. 몇 초 안에 반응할 수 있는 수준이죠. 여기서의 목표는 방향을 다시 잡거나 그대로 받아들이는 식으로 에이전트를 조율하는 데 있습니다.
2단계: 상세 계획(detailed plan).
범위가 정해진 브리프가 만들어지면 Agent는 상세 계획을 생성할지 선택지를 줍니다. 이 단계에서 Agent는 브리프를 완전한 구현 계획으로 확장합니다. 저장소 범위, 가정, 단계별 작업, 각 단계의 구체적인 태스크, 저장소 간 협업, 비목표(non-goal), 그리고 접근 방식 요약까지 담깁니다. 계획은 Slack 스레드로 다시 게시되고 필요한 경우 Slack 캔버스(Canvas)로도 저장됩니다. 이 캔버스는 여러분과 팀이 다듬고 협업하고 공유하며 대화 속에서 참조할 수 있는 지속적인 산출물입니다.
계획을 실행할 준비가 되면 Agent는 "Implement this plan" 옵션을 제시하고 그 계획을 Agent에 넘겨 실제로 만들게 합니다.
이것이 중요한 이유
CodeRabbit Agent for Slack이 실제 코드 변경에 앞서 Plan을 만들어 주면 재작업을 막을 수 있습니다.
여러 파일에 걸친 기능, 스키마 마이그레이션, API 컨트랙트 변경, 작업 순서가 중요한 리팩토링은 일이 어긋나기 쉬운 변경들입니다. 누군가 코드를 쓰기 시작하기 전에 아무도 "작업 영역(work surface)"을 그려 두지 않아서 벌어지는 경우가 많죠. 계획 단계는 값싸고 빠른 공동 사고 단계이며 이런 문제들을 PR 안의 머지 충돌이 아니라 스레드 속 글로 남아 있을 때 잡아냅니다.
구체적인 이점 몇 가지를 보겠습니다.
-
계획에서 PR까지 클릭 한 번. 계획이 맞아 보이면 "Implement this plan"을 누르세요. CodeRabbit이 승인된 계획에서 열린 풀 리퀘스트(PR)까지, Slack 스레드를 벗어나지 않고 한 번에 진행합니다.
-
범위 명확화, 더 빠르게. 범위가 정해진 브리프는 코드베이스를 이해한 첫 판단을 몇 분 안에 내려 줍니다. 팀 정렬을 위해 30분 회의를 잡고 디자인 문서를 쓰는 것보다 훨씬 빠릅니다.
-
암묵지가 아니라 공유된 맥락. Plan은 대화가 벌어지는 Slack 스레드 안에 그대로 남습니다. PM, 테크 리드, 그리고 작업을 이어받을 엔지니어가 같은 캔버스 산출물을 봅니다.
-
일반론이 아니라 코드베이스 기반. CodeRabbit은 이미 여러분의 저장소를 이해하고 있어서 계획이 실제 서비스와 모듈을 참조합니다. 코드를 보지 못한 채 답하는 챗 어시스턴트가 내놓는 가설적 조언이 아닙니다.
-
Slack 캔버스에서의 팀 협업을 위한 설계. 계획 캔버스는 팀이 함께 빚어 가는 살아 있는 문서이며 대화가 일어나는 바로 그 자리에 있습니다. 함께 허들로 논의하고 서로에게 피드백을 남기며 제자리에서 편집하고 소유자, 편집자, 코멘터 역할을 부여할 수 있습니다. 버전 기록은 누가 언제 무엇을 바꿨는지 보여 줍니다. 스레드 답글은 논의를 그 논의가 가리키는 라인에 붙여 둡니다.
무엇이 다른가
코드베이스에 접근할 수 있는 일반 LLM 챗 도구도 계획처럼 보이는 무언가를 만들어 낼 수 있습니다. 다만 잘해야 추측이고 나쁘면 코드의 실제 상황에서 멀어지도록 여러분을 오도합니다. 그 도구는 고객 구독 플랜이 동작하는 방식의 진실 원천이 ID 서비스가 아니라 빌링 서비스라는 사실을 모릅니다. 모바일 클라이언트는 이번 분기 범위 밖이라는 현실 세계의 맥락도 알지 못하죠. 일반적인 계획은 읽기에는 그럴듯하지만 실제 기능 구현과 마주하면 무너집니다.
CodeRabbit의 계획은 여러분이 이미 연결해 둔 저장소, 그리고 팀과 나눈 Slack 대화에 뿌리내립니다. 모듈과 의존성 그래프, 팀이 실제로 쓰는 패턴을 알고 있으며 Slack 안의 대화 맥락까지 함께 파악합니다.
짚어 둘 만한 차이가 두 가지 있습니다.
-
계획이 작업을 논의하는 자리에서 이뤄집니다. 대부분의 계획 도구는 맥락 전환을 요구합니다. 문서를 열고 티켓을 열고 별도의 AI 탭을 열고 프롬프트를 붙여 넣고 결과를 다시 복사해 와야 하죠. CodeRabbit Agent for Slack의 계획은 스레드 안에서 돌아가며 아이디어를 낳은 대화가 곧 계획을 낳는 대화가 됩니다.
-
CodeRabbit은 모든 스레드를 조용히 계획 세션으로 바꾸지 않습니다. "Planning could help here" 제안은 계획이 실제로 위험을 줄여 줄 만큼 작업이 크거나 모호할 때만 나타납니다. 작은 버그 수정, 한 파일짜리 변경, 일상적인 질문에는 끼어들지 않고 바로 구현으로 넘어가게 둡니다.
계획이 Agentic SDLC에 들어맞는 방식
이번 릴리스는 더 큰 흐름의 일부입니다. 저희는 AI 에이전트가 코드 리뷰에만 머무는 것이 아니라 모든 단계에서 진정한 협업자가 되는 소프트웨어 개발 수명주기(SDLC)를 향해 나아가고 있습니다.
CodeRabbit Agent for Slack은 이미 코드 리뷰를 하고 코드베이스에 대한 질문에 답하며 변경을 구현할 수 있습니다. 계획은 수명주기에서 비어 있던 앞단이며 이후 모든 단계를 더 믿음직하게 만드는 전략 단계입니다. 계획이 좋으면 구현이 빨라지고 리뷰가 날카로워지며 롤아웃이 안전해집니다. 계획이 없으면 이후의 모든 단계가 그 모호함을 떠안아야 합니다.
각 조각이 어떻게 이어지는지 보겠습니다.
-
Plan(계획): 모호한 요청을 구조화되고 코드베이스를 이해하는 접근으로 바꿉니다(이번 릴리스).
-
Implement(구현): 이미 같은 맥락이 로드된 상태로 CodeRabbit Agent for Slack에 계획을 넘겨 만들게 합니다.
-
Review(리뷰): CodeRabbit이 그 결과물을 계획과 코드베이스에 비춰 리뷰합니다.
-
Iterate(반복): Slack 스레드가 의사결정의 이유를 담은 지속적인 기록으로 남습니다.
가장 좋은 agentic SDLC는 엔지니어를 대체하는 도구가 아니라, 의도와 코드 사이의 시간을 압축하면서도 모든 결정 지점에서 사람이 통제권을 쥐도록 빌더에게 힘을 실어 주는 플랫폼이라고 저희는 믿습니다.
CodeRabbit 앱에서 Agent for Slack의 /plan 기능 문서 업데이트를 요청하는 모습.
Agent 시스템 통합과 업데이트를 위한 태스크를 상세히 담은 기술 문서.
시작하기
팀에서 CodeRabbit Agent for Slack을 쓰고 있다면 계획 기능을 지금 바로 사용할 수 있습니다. 아무 스레드에서나 다음을 시도해 보세요.
/plan \ <prompt here, for example: Add admin-only audit log export for enterprise workspaces. CSV export from the dashboard, reuse existing permissions, ship behind a feature flag\>
프롬프트가 좋을수록 계획도 좋아집니다. 제품 동작, 예상 범위, 제약, 범위 밖인 것을 함께 적어 주세요. 한 줄짜리 요청이라도 스레드 안에서 다듬을 수 있는 범위 브리프를 만들어 줍니다.
관련 글로 CodeRabbit Plan 소개, 개발자가 끝까지 읽을 단 한 가지, Slack 에이전트 활용 사례도 함께 읽어 보시길 권합니다.