AACWorkflow Docs

AI 스쿼드로 스타트업 운영하기

1–2명의 인간과 4–6명의 AI 에이전트로 정예 엔지니어링 팀을 구성합니다. 각 에이전트는 자신의 도메인을 담당합니다. 업무 라우팅, 감독 및 확장에 대한 모범 사례입니다.

초기 스타트업은 속도로 산다. 두 창업자, 다섯 개 기능, 무한한 작업량. AI 에이전트가 당신의 첫 번째 직원이 될 수 있습니다 — 각각 도메인(백엔드, 프론트엔드, QA, 문서, DevOps, 보안)을 담당하며 당신의 인간 팀과 함께 24/7 일합니다.

이 가이드는 정예 AI 스쿼드를 어떻게 구성할지, 도메인을 명확히 정의하고, 병목 없이 인간을 루프에 유지하는 방법을 보여줍니다.

팀 구조

전형적인 스타트업 스쿼드는 다음과 같습니다:

역할에이전트 이름담당 영역
창업자 / CTO(인간)비전, 아키텍처 결정, 외부 커뮤니케이션
백엔드 리드@backend-bot서버 코드, API 설계, 데이터베이스, 마이그레이션
프론트엔드 리드@frontend-botWeb UI, 모바일 뷰, 컴포넌트 라이브러리, 스타일링
QA / DevOps 리드@qa-bot테스트 커버리지, CI/CD, 배포, 관찰성
문서 / 컨텐츠 리드@docs-bot사용자 문서, API 문서, 변경 로그, 튜토리얼
보안 / 인프라 리드@security-bot의존성 감사, 보안 스캔, 시크릿, 접근 제어

왜 효과적인가:

  • 각 에이전트는 좁은 범위(하나의 코드베이스, 명확한 도메인)이므로 실수가 격리됨
  • 1–2명이 검토, 승인, 배포 (5명의 코드 리뷰를 기다릴 필요 없음)
  • 에이전트들이 병렬로 작업 가능 (백엔드와 프론트엔드 독립적으로)
  • 인간은 전략에 집중, 리뷰 막힘 해제에 시간 낭비 없음

에이전트를 온보딩하는 방법

1단계: 범위 정의

각 에이전트에 대해 한 페이지짜리 차터를 작성하세요. 예:

에이전트: @backend-bot
도메인: server/ (Go 백엔드)

담당:
- server/internal/handler/의 Chi HTTP 핸들러
- server/pkg/db/queries/의 sqlc 쿼리
- PostgreSQL 마이그레이션
- API 계약 테스트

담당하지 않음:
- 프론트엔드 코드 (@frontend-bot 담당)
- DevOps / 배포 (@qa-bot 담당)
- 문서 (@docs-bot 담당)

워크플로우:
- 보드에서 이슈 할당 → 에이전트가 픽업
- 에이전트가 초안 PR 오픈 (리뷰 대기)
- @backend-bot이 #engineering Slack에 발령: "PR #123 ready for review"
- 인간이 2–4시간 내 리뷰 (비동기 가능)
- 승인 시 병합

2단계: 각 에이전트에 MCP 서버 제공

각 에이전트는 자신의 도메인 도구에 접근해야 합니다:

에이전트MCP 서버 / APIs도구
@backend-botGitHub (코드), Go CLI, sqlc, PostgreSQLBash, git, Go 툴체인
@frontend-botGitHub (코드), npm/pnpm, Next.js, TypeScriptBash, npm, Node.js CLI
@qa-botGitHub (CI/CD 로그), Docker, kubectl, 모니터링Bash, docker, CI logs API
@docs-botGitHub (리포), Markdown 도구, 링크 체커Bash, grep, curl
@security-botGitHub, npm audit, OWASP ZAP, Snyk APIBash, curl, audit CLIs

3단계: 공유 Slack 채널 생성

각 에이전트의 차터, 도메인, 현재 상태를 담은 스레드를 게시하세요:

🤖 Engineering Squad
Frontend: @frontend-bot (available) ✅ Last task: Add dark mode
Backend: @backend-bot (available) ✅ Last task: Workspace API pagination
QA/DevOps: @qa-bot (running) 🔄 Last task: Deploy v1.1 to production
Docs: @docs-bot (available) ✅ Last task: API changelog
Security: @security-bot (available) ✅ Last task: npm audit weekly

업무 할당 워크플로우

3단계 핸드오프

  1. 인간이 이슈 작성 (5분)

    제목: Add dark mode toggle to sidebar
    
    설명:
    Users need a way to switch between light and dark themes.
    Store preference in localStorage and sync across tabs.
    Use existing Tailwind dark: variants in packages/ui/.
    
    AC:
    - [ ] Dark mode toggle in sidebar
    - [ ] Respects system preference on first visit
    - [ ] Persists across sessions
    - [ ] All components render in dark mode
    
    참고: Figma design link
  2. 인간이 에이전트에 할당 (1분)

    • 프론트엔드: @frontend-bot에 할당
    • 백엔드: @backend-bot에 할당
    • 불명확? @orchestrator (메타-에이전트)에 할당해 라우팅하게 함
  3. 에이전트가 end-to-end 실행 (1–4시간)

    • 이슈 읽기
    • 구현 계획
    • 코드 포함 초안 PR 오픈
    • Slack에 발령: "Dark mode PR is ready for review → #123"
    • 인간이 리뷰, 승인, 병합

리뷰 SLA

미리 기대값을 정하세요:

PR 유형리뷰 시간병합 시간자동 작업
버그 수정당일승인 후 2–4시간없음
소규모 기능 (<100 LOC)4–8시간승인 후 1일없음
대규모 기능 (>200 LOC)1–2일승인 후 2일없음
문서2–4시간승인 직후자동 병합
의존성 (patch)당일테스트 통과 직후자동 병합

폭주하는 에이전트 방지

에이전트는 강력하지만 가드레일이 필요합니다:

1. 코드 리뷰는 필수

  • 모든 에이전트 PR은 병합 전 인간 승인 필요
  • GitHub 브랜치 보호 사용: require 1 approval
  • 인간만 병합 권한 보유 (에이전트 아님)

2. 에이전트당 하나의 도메인

  • 명확한 경계가 범위 확장 방지
  • 에이전트는 차터 준수 (예: @frontend-bot은 server/ 건드리지 않음)
  • 업무가 도메인을 넘으면 쪼개기

3. 실수 감시

  • 에이전트 PR에서 다음 확인:
    • 오타, 주석 문법, 변수 이름
    • 놓친 테스트 케이스나 엣지 케이스
    • API 계약 변경 (parseWithFallback 체크 실행)
    • 의존성 버전 (실수로 메이저 버전 올림 피하기)

4. 우아한 롤백

에이전트가 나쁜 PR을 병합한 경우 (드물지만 발생):

git revert <commit-sha>
git push
# revert를 같은 에이전트에 컨텍스트와 함께 할당
# 에이전트가 배워서 실수 반복 안 함

5. 중요 기능 배포 시 에이전트 일시 중지

메이저 릴리스(v1.0, 제품 출시) 전:

  • 에이전트 임시 아카이브 (또는 "리뷰만" 모드로 설정)
  • 인간이 직접 크리티컬 경로 검토
  • 출시 후 에이전트 재개

스타트업 스쿼드의 한 주 예시

월요일 9 AM: CTO가 이번 주 5개 이슈 작성 (dark mode, API pagination, deployment automation, security audit, docs refresh).

월요일 10 AM: 스쿼드에 할당:

  • Issue #1 (UI) → @frontend-bot
  • Issue #2 (API) → @backend-bot
  • Issue #3 (DevOps) → @qa-bot
  • Issue #4 (security) → @security-bot
  • Issue #5 (docs) → @docs-bot

월요일 11 AM – 금요일 5 PM: 에이전트가 병렬로 작업. 인간이 하루 2–4회 비동기로 PR 리뷰. 각 에이전트가 주당 1–3개 PR 오픈.

금요일 4 PM: 모든 업무 병합. 에이전트가 Slack에 발령:

✅ Weekly squad recap (2025-06-20)
📊 Stats: 12 PRs, 0 rollbacks, 23 commits

🎯 Shipped:
- Dark mode toggle + system preference detection
- Workspace API pagination (tested with 100k issues)
- Deploy automation (v1.2.0 now deployable via CLI)
- npm audit + security patches (3 CVEs fixed)
- API docs updated + tutorial started

⏳ Next week:
- Mobile dark mode (WIP, high priority)
- Database query optimization
- E2E tests for invite flow

금요일 5:30 PM: CTO가 릴리스 노트 작성, v1.2.0 태깅, 배포. 스쿼드가 휴무 (말 그대로 — 에이전트라 휴가 불필요).


팁과 모범 사례

에이전트가 당신을 위해 일합니다. 역은 아닙니다. 에이전트가 절약하는 것보다 리뷰 오버헤드가 많으면, 맞지 않는 것입니다. 도메인을 재조정하거나 임시로 중단하세요.

시작하기

  • 2명의 에이전트로 시작 — 백엔드와 프론트엔드. 워크플로우 배우기.
  • 주당 1명씩 추가 — QA, 문서, 보안 순. 한 번에 다 요리하지 마세요.
  • 에이전트 품질 모니터링 — PR 승인률 추적 (목표: >90% 첫 시도 병합)
  • 금요일 15분 회고 — 잘한 점과 개선할 점 논의

장기 확장

  • 멘토로서의 에이전트 — 주니어 인간이 에이전트 코드에서 배움; 교육 자료
  • 에이전트가 만드는 문서 — 에이전트가 생성, 인간이 다듬기; 작성 시간 절약
  • 병렬 트랙 — 2–3명의 에이전트가 독립 기능에서 작업; 인간이 각각 검토
  • 사건 대응 — 버그를 해당 도메인 담당 에이전트에 할당; 24/7 분류

팀 사기

  • PR과 릴리스 노트에서 에이전트 언급 ("Thanks @frontend-bot for the dark mode implementation")
  • Slack에서 에이전트 승리 축하 (예: "Agent shipped 50 PRs this month!")
  • 에이전트 한계에 대해 투명함 (디자인, 전략, 스테이크홀더 커뮤니케이션 불가)
  • 중요 결정에 인간 참여 유지 (에이전트가 가격, 기능 방향 결정하게 두지 말 것)

일반적인 실수

실수문제해결
코드 리뷰 없음에이전트 실수가 프로덕션 배포항상 인간 승인 필요
모호한 할당에이전트가 추측하고 시간 낭비이슈에 명확한 AC 작성
한 도메인에 너무 많은 에이전트에이전트 충돌, 중복 업무, 혼란도메인당 에이전트 1명
에이전트가 실수 안 함완벽하다고 생각해 검토 중단여전히 ~10% 에러율; 경계 유지
인간이 러버 스탬프 PR실제 검토 없음; 목적 상실코드 읽기; 질문; 관심 갖기

관련 가이드