BMAD Agent System

🤖 재사용 가능한 AI 에이전트 시스템 - 다른 프로젝트에서도 활용할 수 있는 전문 에이전트 모음

📋 개요

이 폴더는 BMAD(Business Model Architecture Design) 기반의 AI 에이전트 시스템을 포함하고 있습니다. 각 에이전트는 특정 역할을 담당하며, 체계적인 개발 프로세스를 지원합니다.

🏗️ 시스템 구조

bmad-agent-system/
├── agents/              # 에이전트 정의 파일
│   ├── orchestrator.md  # 전체 워크플로우 조율
│   ├── analyst.md      # 요구사항 분석 및 PRD 작성
│   ├── architect.md    # 아키텍처 설계
│   ├── pm.md           # 제품 관리 및 우선순위 결정
│   ├── scrum-master.md # Story 파일 관리 및 개발 사이클 운영
│   ├── dev.md          # TDD 기반 개발
│   └── qa.md           # 품질 보증 및 검증
└── templates/          # 산출물 템플릿
    ├── analyst-prd.md
    ├── architect-design.md
    ├── dev-implementation.md
    ├── orchestrator-prd-summary.md
    ├── orchestrator-architecture-summary.md
    ├── pm-roadmap.md
    ├── qa-verification.md
    └── scrum-master-story.md

🚀 사용 방법

1. 프로젝트에 통합하기

1. 이 bmad-agent-system 폴더를 새 프로젝트의 루트에 복사합니다.
2. 프로젝트 루트에 .cursorrules 파일을 생성하고 다음 내용을 참조합니다:

## 🤖 전문 에이전트 시스템
- 작업 유형에 따라 적절한 전문 에이전트를 선택하여 작업하세요.
- 모든 에이전트는 자신의 작업이 완료된 후(각 에이전트 내부 체크리스트 완료) 사출물을 작성한다.
- 사출물 정보는 각 에이전트 폴더에 있는 템플릿을 참조한다.
- 사출물 양식은 bmad-agent-system/templates 폴더에 있는 템플릿을 참조한다.

3. mockdowns/artifacts/ 폴더 구조를 생성합니다:
   • analyst/
   • architect/
   • pm/
   • scrum-master/
   • dev/
   • qa/
   • orchestrator/

2. 에이전트 워크플로우

Planning Phase (기획 단계)

1. Orchestrator: 전체 프로세스 시작 및 조율
2. Analyst: feature_request.md 기반 PRD 작성
3. PM: 우선순위 및 로드맵 수립
4. Architect: 시스템 아키텍처 설계

Development Phase (개발 단계)

5. Scrum Master: Story 파일 생성 및 관리
6. Dev: TDD 기반 기능 구현
7. QA: 통합 검증 및 품질 보증

3. 에이전트별 역할

🎯 Orchestrator

• 전체 워크플로우의 관제탑
• 에이전트 간 핸드오프 조율
• 품질 검증 및 의사결정 로그 관리

📊 Analyst

• 요구사항 분석 및 구체화
• PRD(Product Requirements Document) 작성
• Given-When-Then 패턴 기반 수용 기준 정의

🏗️ Architect

• 시스템 아키텍처 설계
• 기술 스택 선정
• 가드레일 수립

📈 PM

• 기능 우선순위 결정
• 릴리스 계획 수립
• 초기 총점 산정

📝 Scrum Master

• Story 파일 생성 및 관리
• Story ID 관리 및 브랜치 전략 총괄
• 개발 사이클 운영

💻 Dev

• TDD(Test-Driven Development) 기반 구현
• Red → Green → Refactor 사이클
• 구조적/행동적 변경 분리

✅ QA

• 사용자 시나리오 기반 통합 검증
• 테스트 커버리지 측정
• 버그 분류 및 재현 스텝 작성

📄 산출물 관리

저장 위치

• 각 에이전트별 산출물은 mockdowns/artifacts/[에이전트명]/ 폴더에 저장됩니다.

파일명 형식

• YYYY-MM-DD_[주제][목적]_[버전].md
• 예시: 2024-01-15_사용자관리_PRD_v1.0.md

템플릿 사용

• 각 에이전트는 bmad-agent-system/templates/ 폴더의 해당 템플릿을 참조하여 산출물을 작성합니다.

🔄 점수 관리 시스템

총점 산정

• PM 에이전트가 프로젝트 시작 시 feature_request.md를 기반으로 총점을 산정합니다.
• 총점은 프로젝트 시작 시 고정되며 변경되지 않습니다.

점수 전달

• 각 에이전트는 산출물에 다음 정보를 포함합니다:
  • 획득 점수 (Acquired Score): 현재 에이전트가 획득한 점수
  • 누적 점수 (Cumulative Score): 이전 에이전트 누적 점수 + 현재 점수
  • 총점 (Total Score): 프로젝트 전체 총점

✅ 체크리스트 기반 품질 보증

각 에이전트는 자신의 체크리스트를 완료해야 다음 단계로 진행할 수 있습니다. 체크리스트 실패 시 재작업이 필요합니다.

📦 커밋 전략

각 에이전트는 작업 완료 시 다음 형식으로 커밋합니다:

• 브랜치: feature/STORY-[번호]
• 커밋 메시지: [에이전트명]: [작업 요약] (#STORY-[번호])

🔗 참고 자료

• BMAD 원칙: Agentic Planning, Context-Engineered Development
• TDD 원칙: Red → Green → Refactor
• Given-When-Then 패턴: 테스트 가능한 수용 기준 작성

📝 라이선스

이 에이전트 시스템은 프로젝트 내에서 자유롭게 사용 및 수정 가능합니다.