Search

AI 코딩 에이전트에게 사고 과정을 설계하다— /start부터 Agent Teams까지

URL
생성 일시
2026/02/25 00:06
최종 편집 일시
2026/02/25 00:06
태그
여기어때
파일과 미디어
|| 안녕하세요, 백오피스 웹개발팀 꼼비입니다. 이 글은 AI 코딩 에이전트를 도입한 뒤, 단순히 “빠르게 코드 생성하기”를 넘어서 에이전트가 어떻게 생각하고 일할지를 설계한 과정을 정리한 글이에요. Chain of Thought를 결합한 6단계 인지 흐름 모델, .claude/ 기반 규칙 체계, 페르소나별 에이전트 전문화, 그리고 Agent Teams를 활용한 병렬 협업까지- 티켓 하나를 /start로 시작해서 /done으로 마무리하는 워크플로우가 만들어지기까지의 이야기입니다. 1. 왜 체계화를 시작했는지광고센터 프론트엔드를 혼자 맡게 됐던 그 시점 광고센터 프론트엔드를 혼자 맡게 됐을 때, 가장 먼저 느낀 건 일이 생각보다 훨씬 겹쳐 있다는 거였어요. 일단 시간 부담이 컸습니다. 주문/결제/제휴점 화면을 오가면서 티켓마다 Jira 상태 바꾸고, Figma 확인하고, 파일 뒤지고… 이걸 반복하다 보니 할 일이 한꺼번에 몰리더라고요. 리뷰어도 없으니 최종 검증까지 제가 다 챙겨야 했습니다. 정책이 여기저기 흩어져 있던 것도 문제였어요. 최근 14일이 파일마다 -13인지 -14인지 다르게 계산되고, 필터나 disabled 조건도 제각각이라 규칙이 흔들릴 여지가 있었거든요. 리팩토링하다 정책이 슬쩍 바뀌어도 바로 눈에 안 띄는 구조였습니다. 단일 진실 원칙(Single Source of Truth)이 안 잡혀 있던 것도 아쉬웠어요. 같은 정책이 여러 파일에 복붙되어 있고, 문서도 빽빽하지 않다 보니 새 기능 만들 때마다 과거 구현을 처음부터 다시 추적해야 했습니다. AI 코딩 에이전트를 도입했지만… 그래서 AI 코딩 에이전트를 붙여봤어요. 생산성은 확실히 올라갔는데, 동시에 새로운 문제도 같이 찾아왔습니다. 에이전트마다 스타일이 달랐어요 - import 순서, 상태 관리 방식, styled 패턴이 제각각이었습니다. 비즈니스 규칙을 모르는 채로 시작하는 일이 생겼어요 - last14Days가 13일인지 14일인지, 할인 반올림 기준은 뭔지 헷갈리는 일이 반복되면서 초기 탐색 시간이 늘어났습니다. 같은 피드백을 반복해서 달아야 했어요 - 리뷰어가 없어서 제가 직접 코드를 검증하다 보니, 같은 포인트를 계속 다시 확인하게 되더라고요. 결국 문제는 “도구가 아니라 방식”이었습니다. 혼자서도 흔들리지 않게 돌아가려면, 운영 기준부터 먼저 세우고 에이전트가 그 기준 안에서 일하게 만들어야 했어요. “문서만 늘릴 게 아니라, 문서를 코드 흐름으로 옮겨야 한다.”2. 실제로 이렇게 돌아갑니다 이론부터 설명하기 전에, 완성된 워크플로우가 실제로 어떻게 동작하는지 먼저 보여드릴게요. /start 한 줄이면 작업이 시작됩니다 티켓 하나를 시작할 때, 터미널에 이렇게 입력합니다. /start BOWD-42 그러면 에이전트가 자동으로 이 흐름을 실행해요. Jira 티켓 조회 — 제목, 설명, Figma 링크를 가져오고 상태를 “진행 중”으로 변경 Figma 디자인 분석 — MCP로 디자인 스크린샷과 메타데이터를 조회 코드 분석 — 변경 대상 파일을 탐색하고, Figma와 현재 코드의 차이를 비교 복잡도 판단 — 변경 파일 수와 영향 범위를 보고 LOW / MEDIUM / HIGH 결정 /start BOWD-193 실행화면 복잡한 작업은 서브태스크로 자동 분리됩니다 복잡도가 HIGH로 판단되면, 에이전트가 작업을 서브태스크로 쪼개서 제안해요. 다음 서브태스크를 Jira에 생성할까요? (BOWD-42 하위) 1. OrderInfo 컴포넌트 수정 — 서명상태/할인사유 컬럼 제거 2. PaymentInfo 전면 재작성 — 4열 심플 테이블로 변경 3. CancelInfo 신규 추가 — 취소/환불 정보 섹션 4. ControlPanel 사이드패널 수정 — 340px, 결제일시 조건부 표시 [Y] 생성 / [N] 취소 / [E] 수정 승인하면 Jira에 서브태스크가 생성되고, 각 서브태스크를 독립적인 에이전트가 병렬로 처리합니다. /start BOWD-60 실행ai가 생성한 subtasksubtask 내용 /d