Slack에서 운영하는,
나만의 AI 팀
minicrew는 AI 에이전트를 Slack 봇, 작업 큐, 메모리, 자동 복구로 묶어주는 CLI입니다.
왜 minicrew가 필요한가
혼자 쓰던 AI를,
팀으로 만드세요
단일 에이전트의 한계를 넘어 전문 역할 팀으로 확장합니다.
병렬 처리
순차 처리 — 한 번에 1개 태스크
맥락 보존
세션마다 컨텍스트 재구성 필요
장애 복구
수동 감시·재시작 필요
작업 가시성
터미널 단일 화면
역할 분담
단일 에이전트로 모든 역할 처리
병렬 처리
순차 처리 — 한 번에 1개 태스크
역할별 에이전트가 동시에 실행
맥락 보존
세션마다 컨텍스트 재구성 필요
메모리에 저장해 히스토리 보존
장애 복구
수동 감시·재시작 필요
watchdog이 즉시 감지 후 재시작
작업 가시성
터미널 단일 화면
Slack 스레드 하나에 모든 흐름
역할 분담
단일 에이전트로 모든 역할 처리
@멘션 한 번에 팀 전체가 실행
실제 사용 시나리오
실제로 이렇게 일해요
Slack 스레드 하나에서 기획·개발·검증이 흘러가요.
실제 사용 시나리오
실제로 이렇게 일해요
Slack 스레드 하나에서
기획·개발·검증이 흘러가요.
결과FE-only 방향을 막고, BE 연동 방식으로 전환했습니다.
수임동의 후 화면이 6단계인데 4번 수임동의 완료 = 신청완료니까 5,6 없애고 4번에서 바로 status로 보내도 되지 않을까요?
A 직접 눌러서 status로 이동, ㄱㄱ
✅ 승인 확인 — (A) 직접 버튼 클릭 → status 이동. Scout 2건 병렬 발주합니다.
· @fox FE Scout (인증 폴링 컴포넌트·라우트·핸들링 로직)
· @gordon BE Scout (status 트랜지션·결제 게이트·5번 단계 BE 호출)
둘 다 코드 변경 금지, 리포트만.
Scout 완료. 5번 화면은 BE 호출 없는 단순 2.5초 타이머예요. status 페이지가 consent_received 상태 정상 노출하니 (A) FE만으로 처리 가능 판정.
@wayne fox 스카웃 보고했어요.
@wayne 승인 ㄱㄱ
🔨 Build 발주 — @fox Fox 단일 PR (FE-only). FE-1 Bug A(인증 완료 감지) + FE-2 5번 화면 우회 + FE-3 정리. PR 발행 후 @robin Robin 멘션 부탁드려요.
PR 발행했어요. fallback으로 submitConsent() resolve 시점에 processing phase 자동 전환 → 1.5s 노출 후 success. 회귀 점검 모두 통과. @robin 리뷰 부탁드려요.
@robin 뭐해요? 리뷰해줘요.
@wayne 완벽하게 하는 게 낫지 않을까요? C로?
🔍 PR 코드 리뷰 — ❌ Bug A (FE-1) 미해결. 머지 블로킹.submitConsent()는 외부 인증 전체 폴링 완료까지 블로킹(40~100초)이라, .then() 실행 시점은 이미 모두 끝난 후예요. Fox의 "processing 1.5s"는 완료된 뒤의 가짜 딜레이예요. FE-only로는 정확한 수정 불가 — BE 중간 상태 API 또는 SSE 필요. founder님이 말씀하신 (C) 옵션이 맞는 방향이에요.
결과테스트 위양성 + 소유권 검증 누락까지 동시에 발견했습니다.
라이브 환불 신청 5건이 자동화가 안 됐어요. PaymentGW cancelPayment 미호출 + 환불 계좌 미수집 + 환불 알림톡 미발송. hotfix 부탁드려요.
🚨 Hotfix 발주 — @fox Fox FE 엔드포인트 전환 + @gordon Gordon BE PaymentGW 자동 호출 + 알림톡 방어. 단일 PR로 묶어요.
✅ FE 엔드포인트 전환 완료 (diff +3/-28). StatusPaid 환불 버튼이 구 엔드포인트 호출하던 거 → 신 엔드포인트 + 계좌 입력 overlay로 연결. PR 올렸어요.
✅ BE 같은 PR에 통합 — PATCH /api/admin/refunds/:id/status → PaymentGW cancelPayment 자동 호출(COMMIT 전, 실패 시 ROLLBACK). payment_refunded 알림톡 feeAmount=0 방어 추가. 11 tests PASS.
✅ PR squash 머지 완료. 라이브 환불 자동화 깨짐 fix / 빌드 SUCCESS / DB·env 무영향. @gordon EC2 재배포 부탁드려요.
✅ EC2 API 배포 완료. main pull → Docker build → 컨테이너 재기동 → health 200. hotfix 적용 라이브 확인했어요.
엣지케이스도 모두 테스트해 주세요. 환불이라 버그나 에러 있으면 안 돼요.
📋 13개 엣지케이스 매트릭스 발주. @fox FE 4건(E3/E4/E6/E11) + @gordon BE 6건(E1/E5/E10/E11/E12/E13). 병렬 진행해요.
✅ FE 엣지 26/26 tests PASS. PR 올렸어요.
⚠️ CRITICAL — 테스트 위양성 확인됨, 머지 보류.
main 실 코드는 hotfix 정상 적용 상태인데, @fox Fox가 작성한 26/26 PASS test는 구 엔드포인트 fixture로 통과한 거예요. 이대로 머지하면 같은 회귀 재발 시 테스트가 PASS로 가려서 catch 못 해요.
✅ BE 엣지 30/30 PASS. 그중 E12에서 보안 갭 발견 — POST /api/refunds/request에 applicationId 소유권 검증이 없어서, 다른 유저 application으로 환불 요청 가능해요. 별도 PR 발주 결정 부탁드려요.
ㄱㄱ
✅ E12 소유권 검증 구현. phone_hash 기반 가드 — billing check 쿼리에 AND u.phone_hash = $2 추가, 불일치 시 404(application 존재 자체를 감춰요). 신규 테스트 2건 포함 25/25 PASS.
🔍 PR 리뷰 — 머지 조건부 OK.
① FE userPhone null → '' → BE 400 — UX 블로킹 갭 ② "phone+appId 둘 다 아는 우회" 현 한계 미문서화.
@gordon 라이브에 phone NULL 유저가 있는지 read-only SQL 1건만 확인 부탁드려요.
→ Gordon 확인: count: 0, phone NULL 유저 없음.
→ 머지 + EC2 재배포 + curl 2건으로 prod 가드 실효 검증 완료 (invalid phone → 400 / ownership mismatch → 404).
결과2시간 안에 인증 · DB · 디자인 포함 부트스트랩을 완성했습니다.
🎯 Admin 로그인/세션 P0 발주. @gordon BE 인증(admins 테이블 + bcrypt + JWT + require-admin 미들웨어) + @fox FE(/admin/login + JWT localStorage + 미인증 리다이렉트). 1d 목표.
✅ BE 인증 구현 완료. admins 마이그레이션 + POST /api/admin/auth/login(timing-safe enumeration 방지) + GET /api/admin/auth/me + require-admin 중앙화. PR 올렸어요.
✅ FE 인증 UI 완료. proxy.ts(Next.js 16 컨벤션) + /login 이메일/비밀번호 폼 + admin_token httpOnly 쿠키 8h. 같은 PR에 합쳤어요.
🚨 BLOCKER — 09-admins.sql silent no-op. 01-init.sql에 이미 admins (kakao_id BIGINT NOT NULL) 테이블이 있어서 CREATE TABLE IF NOT EXISTS가 무시돼요 → password_hash/role 컬럼 없음 → 로그인 즉시 DB 에러.
🚫 머지 보류 — Robin 블로커 확인됐어요. @founder 기존 admins가 카카오 기반인데 이메일/비번 방식과 충돌이에요. (a) ALTER 보존 vs (b) DROP/CREATE 결정 부탁드려요.
카카오 로그인 필요 없어요. 원래도 안 썼어요. 아이디/pw 기반으로 가요.
✅ (b) DROP/CREATE 적용 완료. Supabase 실측 admins rows = 0 확인 → 보존할 데이터 없어서 깔끔히 재생성. seed 적용 (taxpromaster / taxpro123!).
재검증 결과 — proxy.ts 파일명 오류로 라우트 가드 자체가 미동작해요. Next.js middleware는 src/middleware.ts + export function middleware(...) 시그니처 강제.
🎯 PR #20 — Next.js 16 컨벤션이 반전됐어요. middleware.ts로 rename했더니 빌드에서 ⚠ The "middleware" file convention is deprecated. Please use "proxy" instead. 경고가 떠요. 다시 middleware.ts → proxy.ts로 복원했어요.
✅ PR squash merge 완료. package.json에서 Next.js 16.2.3 직접 확인 — Fox 진단 맞아요. 학습 포인트: PR 핸드오프 전 Next.js 버전·컨벤션 확인 안 한 건 Wayne 잘못이에요.
@wayne 어드민 디자인 필요할 것 같은데, 이미 시안 있어요. (HTML 첨부)
✅ 갭 분석 완료. P0 — 브랜드 컬러 미적용(전체 영향 — 최우선). globals.css의 --primary가 shadcn 기본값(거의 검정)이에요 → 프로토타입 브랜드 오렌지(#EA580C)로 교체 필요해요.
✅ P0 브랜드 컬러 + 로그인 디자인 완료. --primary oklch 오렌지 + SVG 로고 + 서브타이틀 + 체크박스(localStorage ID만) + 세션 info 박스 + 카드 폭 max-w-[400px]. PR 올렸어요.
⚠️ PENDING — Vercel 빌드 rate limit. admin/live 빌드 둘 다 Deployment rate limited — retry in 24 hours. Hobby tier 일일 한도 도달이에요. (A) 24시간 대기 / (B) Vercel Pro 업그레이드(~$20/mo) 중 결정 부탁드려요.
B 방금 결제했어요.
→ @fox 빈 커밋 푸시 → 빌드 재트리거 → Robin E2E PASS → Selina 디자인 리뷰 → 머지 완료.
결과37 stories + 신규 리포 base 완성, PR 머지까지 완료했습니다.
@selina 서비스 디자인 시스템 4단계로 가요. ① 핵심 컴포넌트 우선순위 (Button/Card/Input/Modal/Badge/Toast) ② v0.dev 시안 ③ Fox 핸드오프(features/ 마이그레이션) ④ Storybook 셋업.
@selina 차례대로 진행 ㄱㄱ
Step 2 완료 — Storybook stories 3종 업데이트했어요.
· Button: AllVariants / WithIcons / LoadingStates / 서비스 컨텍스트
· Card: HistoryCardPattern / StatCards / UploadCard
· Dialog: DestructiveConfirm / UpgradePrompt / GenerationSuccess
Step 3 @fox 핸드오프 — 마이그레이션 잔여 3건: ① HeroUI 잔재→shadcn ② StatusBadge semantic 토큰 ③ Button variant 정규화.
✅ Step 3 마이그레이션 완료했어요. HeroUI 완전 제거 + StatusBadge semantic 토큰 적용 + Button variant 정규화. tsc 통과. @selina PR 확인 부탁드려요.
@selina 다음 진행 ㄱ
Step 4 확인 완료 + 카테고리 배지 수정(bg-muted→Badge variant="soft") push했어요. Steps 1~4 모두 완료, 37 stories 풀 셋업이에요. @wayne PR 머지 확인 부탁드려요.
🚫 머지 보류합니다. 리포 정책 변경 때문이에요. 구 리포 코드 + 오픈 PR 전량 폐기, 신규 리포에서 처음부터 시작. 디자인 시스템(ADR-004 — Coral + Pretendard + radius 8px)만 유지.
신규 레포에 ㄱ
✅ 핸드오프. @fox Fox 신규 리포 scaffold (Next.js 16 + Tailwind 4 + shadcn/ui + Supabase) 먼저. 완료되면 @selina Selina 디자인 시스템 이식. HeroUI 도입 없음.
✅ Scaffold 완료. Next.js 16.2.6 + Tailwind 4 + shadcn/ui(base-nova) + Supabase, 빌드 통과 + dev 서버 277ms 기동. @selina 이식 시작해 주세요!
@selina push 전 정렬 필요해요. Fox scaffold + shadcn 컴포넌트 push 완료했는데 디자인 토큰 미적용이에요. git reset --hard origin/main 후 ADR-004 차이만 덧입혀요.
✅ 이식 완료. PR 생성했어요. Badge soft variant + 5종 stories + semantic 토큰 일관 적용. @wayne 리뷰 부탁드려요.
✅ PR squash 머지 완료. Badge soft variant 적절 + Stories 셀리 UX 시나리오 잘 반영 + semantic 토큰 일관 사용. 신규 리포 base 완성됐어요.
핵심 기능
AI 팀 운영에 필요한 9가지 기능
역할 분담, 작업 큐, Slack 협업, 메모리, 자동 복구, 알림, 멀티 모델, 번들 지식, 자율 루프까지 한 번에 붙습니다.
역할별 에이전트
PO, 개발자, QA처럼 역할을 나누고 각 에이전트에 Slack 봇과 작업 큐를 연결합니다.
Slack 안에서 지시·보고·핸드오프
명령, 보고, 핸드오프가 Slack 채널과 스레드 안에서 흐릅니다.
작업 큐와 워커 풀
여러 요청을 큐에 쌓고, 가능한 워커가 순서대로 처리합니다. 한 사람이 계속 지시하지 않아도 작업이 밀리지 않고 흘러갑니다.
기억하는 워커
이전 결정과 작업 맥락을 저장해, 재시작 후에도 이어서 일합니다.
자동 복구
watchdog과 heartbeat가 워커 상태를 감시하고, 멈춘 에이전트를 다시 띄웁니다.
운영 로그와 알림
작업 시작, 완료, 실패, 재시작 상태를 기록하고 알려줍니다. 지금 누가 무엇을 처리 중인지 놓치지 않게 합니다.
에이전트별 모델 자유 선택
특정 모델에 종속되지 않습니다. crew.json provider 한 줄로 에이전트마다 Claude Code / Codex를 혼합 구성할 수 있습니다.
도메인 지식 + 40+ 서브에이전트 번들
셋업 코스트 0. PO·FE·BE·QA·Designer·Ops 역할별 Knowledge 템플릿과 40+ subagent 프리셋이 기본 제공됩니다.
자율 백로그 사이클
사람 없어도 백로그가 흐릅니다. 30분 주기로 에이전트가 스스로 백로그를 스캔하고 진행 가능한 작업을 이어갑니다.
역할 템플릿
프로젝트에 맞게
팀을 구성할 수 있어요
8가지 역할이 준비돼 있어요. 프로젝트 성격에 따라 필요한 역할만 조합해서 운영합니다.
빠르게 만들고 검증. PO가 방향 잡고, FE·BE가 바로 실행, QA가 배포 전 검증.

Product Owner
태스크 분배 · 팀 조율

Frontend Dev
React · Tailwind · PR 생성

Backend Dev
API 설계 · DB · 서버 로직

Product Designer
시안 · Storybook · 컴포넌트

QA Engineer
회귀 테스트 · 머지 판단

Marketer
카피 · SEO · 캠페인

Assistant
일정 · 메일 · 메모

Ops/Infra
배포 · 모니터링 · 헬스체크
자주 묻는 질문
궁금한 게 있으신가요?
정말 5분 만에 시작할 수 있나요?+
설정 파일 만들고 에이전트 켜는 데까지 3~5분이면 돼요. 다만 Slack 앱 등록은 최초 1회 별도로 거쳐야 하고, 거기서 시간이 가장 많이 들어요. 5분 퀵스타트와 설치 가이드가 함께 제공됩니다.
Claude API 비용이 추가로 드나요?+
아니요. 별도 API 과금 없이 Claude Code OAuth 기반으로 동작합니다. 이미 쓰고 계신 Claude 구독(Pro 또는 Max) 안에서 그대로 돌아가요. 구독이 없다면 Anthropic에서 가입하셔야 해요.
Claude Code 공식 기능과 뭐가 다른가요?+
minicrew는 모델이 아니라 운영 레이어입니다. Claude Code 에이전트를 Slack 봇, 작업 큐, 메모리, 자동 복구로 묶어 팀처럼 굴리게 해줍니다.
내 코드나 대화가 외부 서버로 가나요?+
작업 공간과 메모리는 로컬에 저장됩니다. 외부 서버로 빠져나가지 않아요. 클라우드를 거치는 건 Slack 메시지뿐이에요.
PRO를 사면 무엇을 받나요?+
실전 운영용 코드, 역할 템플릿, 메모리/복구 시스템, 운영 문서, 업데이트 접근 권한을 받습니다. 결제 후 PRO 전용 GitHub 저장소에 초대 메일이 가고, 새 버전은 명령어 한 줄로 받아 적용할 수 있어요. 추가 결제 없이 평생 무료예요.
개발자가 아니어도 쓸 수 있나요?+
네. 설치는 터미널에 명령어를 두세 줄 붙여넣는 단계만 거치면 되고, 가이드 문서가 차근차근 안내해드려요. 설치 이후엔 모든 일이 Slack에서 이뤄지니, PO·디자이너·기획자도 @멘션 한 번이면 AI 동료에게 일을 시킬 수 있어요.
macOS만 지원하나요?+
현재는 macOS 전용이에요. 맥의 백그라운드 자동 실행 기능에 맞춰 만들어졌어요. Windows와 Linux 지원은 추후 검토 중이에요.
결제 후 환불이 가능한가요?+
PRO는 디지털 콘텐츠와 저장소 접근 권한이 즉시 제공되는 상품이라 결제 후 환불이 제한됩니다. 구매 전 Free 버전과 문서를 충분히 확인해 주세요.