AI Dev Team(Claude Code 기반 개발 워크플로우 자동화)

Claude Code로 혼자 개발할 때 AI가 PM·설계·구현·검증 역할을 동시에 수행하며 생기는 역할 혼재, 설계 없는 구현 반복, 컨텍스트 손실 문제를 해결하려는 프레임워크다. PM/TechLead/Dev/QA/DevOps 5개 페르소나를 CLAUDE.md에 강제로 정의하고, .aidev.json 파일 하나로 다른 프로젝트에도 이식할 수 있게 만들었다.

웹 대시보드를 모노레포의 web/ 서브디렉토리에서 Vercel에 배포하는 과정에서 루트 디렉토리 설정 오류를 겪었고, vercel.json 추가 → 잘못된 rootDirectory 제거 → 재배포 트리거 순으로 세 차례 수정했다. 설계 문서에는 "LLM 역할 강제는 100% 보장할 수 없고 설계 자체가 더 중요하다"는 학습 기록이 남아 있다.

• CLAUDE.md를 컨텍스트 주입 지점으로 활용(별도 런타임 없이 팀 규칙을 AI에 강제)
• .aidev.json (팀 규칙을 캡슐화해 다른 프로젝트로 이식 가능하게 설계)
• Next.js 15 (Turbopack) + React 19 (대시보드 직접 조회)
• bkend.ai (Server Actions로 API 키를 서버사이드에 보호하며 자체 BaaS 연동)

PDCA Gap Analysis 기준 Match Rate 95.4%, 46개 파일과 CC 커맨드 4종을 구현했다. 역할 이탈 시나리오 테스트와 다른 프로젝트 실연동 검증은 아직 미검증 상태로 남음