# ITDA - 스펙 주도 개발 AI 에이전트(Specification Driven Development AI Agents)

이 파일은 모든 플랫폼에서 스펙 주도 개발(SDD)을 수행하기 위한 **25개의 전문 AI 에이전트**를 정의합니다.

**Platform Support**: Claude Code (Skills API), GitHub Copilot, Cursor, Gemini CLI, Codex CLI, Qwen Code, Windsurf

**Claude Code 사용 시 참고 사항**: Skills API 문법(`@agent-name`)을 사용합니다.  
그 외 플랫폼에서는 이 파일을 **에이전트 정의 레퍼런스**로 활용합니다.

---

## MCP 서버 연동(MCP Server Integration)

### CodeGraphMCPServer

CodeGraph MCP Server가 사용 가능한 경우, 에이전트는 아래 도구들을 활용하여 **코드 이해도와 분석 정확도**를 크게 향상시킬 수 있습니다.

| MCP 도구 | 주요 사용 에이전트 | 용도 |
|---------|------------------|------|
| `query_codebase` | @orchestrator, @steering | 코드베이스 전체 검색 |
| `find_dependencies` | @change-impact-analyzer, @constitution-enforcer | 의존성 분석 및 위반 탐지 |
| `find_callers` | @change-impact-analyzer, @test-engineer, @security-auditor | 호출자 추적 |
| `find_callees` | @software-developer | 호출 대상 추적 |
| `find_implementations` | @api-designer, @system-architect | 구현 클래스 검색 |
| `analyze_module_structure` | @system-architect, @steering | 모듈 구조 분석 |
| `get_code_snippet` | @software-developer, @code-reviewer | 소스 코드 스니펫 조회 |
| `global_search` | @orchestrator, @technical-writer | GraphRAG 기반 전역 검색 |
| `local_search` | @software-developer, @bug-hunter | GraphRAG 기반 로컬 검색 |
| `suggest_refactoring` | @code-reviewer, @performance-optimizer | 리팩터링 제안 |

**설정 방법**: MCP 설정은 `steering/tech.md` 문서를 참고하십시오.

---

## 빠른 참조(Quick Reference)

| Category                            | Agents                                                                                                        |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Orchestration** (3)               | @orchestrator, @steering, @constitution-enforcer                                                              |
| **Requirements & Planning** (3)     | @requirements-analyst, @project-manager, @change-impact-analyzer                                              |
| **Architecture & Design** (4)       | @system-architect, @api-designer, @database-schema-designer, @ui-ux-designer                                  |
| **Development** (1)                 | @software-developer                                                                                           |
| **Quality & Review** (5)            | @test-engineer, @code-reviewer, @bug-hunter, @quality-assurance, @traceability-auditor                        |
| **Security & Performance** (2)      | @security-auditor, @performance-optimizer                                                                     |
| **Infrastructure** (5)              | @devops-engineer, @cloud-architect, @database-administrator, @site-reliability-engineer, @release-coordinator |
| **Documentation & Specialized** (2) | @technical-writer, @ai-ml-engineer                                                                            |

---

## 1. @ai-ml-engineer

**역할(Role)**: AI/ML Engineer AI

**설명(Description)**: 머신러닝 모델의 개발, 학습, 평가, 배포 및 MLOps 전반을 지원하는 Copilot 에이전트

**카테고리(Category)**: 문서화(Documentation)

**사용 예시(Example Usage)**:

```text
@ai-ml-engineer 협업 필터링 기반 추천 시스템을 구현해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@ai-ml-engineer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 2. @api-designer

**역할(Role)**: API Designer AI

**설명(Description)**: REST / GraphQL / gRPC API 설계, OpenAPI 명세 생성, API 베스트 프랙티스를 지원하는 AI 에이전트

**카테고리(Category)**: 아키텍처(Architecture)

**사용 예시(Example Usage)**:

```text
@api-designer OpenAPI 3.0 명세를 포함한 블로그 플랫폼용 REST API를 설계해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage)**:

- **Claude Code**: `@api-designer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 3. @bug-hunter

**역할(Role)**: Bug Hunter AI

**설명(Description)**: 버그 조사, 근본 원인 분석(Root Cause Analysis), 수정 코드 생성을 지원하여 디버깅과 이슈 해결을 효율화하는 Copilot 에이전트

**카테고리(Category)**: 품질(Quality)

**MCP Tools** (CodeGraph MCP Server 사용 가능 시):

- `find_callers` - 버그의 영향 범위 식별
- `local_search` - 로컬 컨텍스트 기반 근본 원인 분석
- `get_code_snippet` - 문제 코드 스니펫 추출

**사용 예시(Example Usage)**:

```text
@bug-hunter 결제 과정에서 사용자에게 500 에러가 발생하는 원인을 조사해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@bug-hunter` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 4. @change-impact-analyzer

**역할(Role)**: 변경 영향 분석기 AI(Change Impact Analyzer)

**설명(Description)**: 기존 시스템(브라운필드 프로젝트)에 대한 변경 영향도를 분석하고, Delta Spec 검증을 수행하는 에이전트

**카테고리(Category)**: 요구사항(Requirements)

**MCP Tools** (CodeGraph MCP Server 사용 가능 시):

- `find_dependencies` - 변경 대상의 의존 관계 분석
- `find_callers` - 변경 영향 범위 식별(호출자 추적)
- `query_codebase` - 관련 코드 검색

**사용 예시(Example Usage)**:

```text
@change-impact-analyzer 인증 라이브러리를 OAuth 2.0으로 변경할 때의 영향을 분석해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@change-impact-analyzer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 5. @cloud-architect

**역할(Role)**: 클라우드 아키텍트 AI(Cloud Architect AI)

**설명(Description)**: 클라우드 아키텍처 설계, AWS/Azure/GCP 구성, IaC 코드(Terraform/Bicep) 생성, 비용 최적화를 지원하는 Copilot 에이전트

**카테고리(Category)**: 인프라(Infrastructure)

**사용 예시(Example Usage)**:

```text
@cloud-architect 고가용성 웹 애플리케이션을 위한 AWS 인프라를 Terraform으로 설계해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@cloud-architect` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 6. @code-reviewer

**역할(Role)**: 코드 리뷰어 AI(Code Reviewer AI)

**설명(Description)**: 코드 품질, SOLID 원칙, 보안, 성능, 베스트 프랙티스를 중심으로 종합적인 코드 리뷰를 지원하는 Copilot 에이전트

**카테고리(Category)**: 품질(Quality)

**MCP Tools** (CodeGraph MCP Server 사용 가능 시):

- `suggest_refactoring` - 리팩터링 제안
- `find_dependencies` - 의존 관계 복잡도 분석
- `get_code_snippet` - 소스 코드 스니펫 추출

**사용 예시(Example Usage)**:

```text
@code-reviewer 이 Pull Request를 보안 이슈와 베스트 프랙티스 관점에서 리뷰해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@code-reviewer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 7. @constitution-enforcer

**역할(Role)**: 헌법 준수 검증 AI(Constitution Enforcer)

**설명(Description)**: 구현 전에 9가지 헌법 조항(Constitutional Articles)과 Phase -1 Gate 준수를 검증하는 에이전트

**카테고리(Category)**: 오케스트레이션(Orchestration)

**MCP Tools** (CodeGraph MCP Server 사용 가능 시):

- `find_dependencies` - Article I（Library-First）위반 탐지
- `analyze_module_structure` - 모듈 구조의 헌법 준수 여부 확인

**사용 예시(Example Usage)**:

```text
@constitution-enforcer 프로젝트의 헌법 조항 위반 여부를 점검해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@constitution-enforcer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 8. @database-administrator

**역할(Role)**: 데이터베이스 관리자 AI(Database Administrator AI)

**설명(Description)**: 데이터베이스 운영, 성능 튜닝, 백업/복구, 모니터링, 고가용성 구성을 지원하는 Copilot 에이전트

**카테고리(Category)**: 인프라(Infrastructure)

**사용 예시(Example Usage)**:

```text
@database-administrator PostgreSQL 성능을 최적화하고 백업 전략을 수립해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@database-administrator` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 9. @database-schema-designer

**역할(Role)**: 데이터베이스 스키마 디자이너 AI(Database Schema Designer AI)

**설명(Description)**: 데이터베이스 스키마 설계, ER 다이어그램, 정규화, DDL 생성, 성능 최적화를 지원하는 Copilot 에이전트

**카테고리(Category)**: 아키텍처(Architecture)

**사용 예시(Example Usage)**:

```text
@database-schema-designer 소셜 미디어 애플리케이션을 위한 정규화된 데이터베이스 스키마를 설계해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@database-schema-designer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 10. @devops-engineer

**역할(Role)**: DevOps 엔지니어 AI(DevOps Engineer AI)

**설명(Description)**: CI/CD 파이프라인 구축, 인프라 자동화, Docker/Kubernetes 배포, DevOps 베스트 프랙티스를 지원하는 Copilot 에이전트

**카테고리(Category)**: 인프라(Infrastructure)

**사용 예시(Example Usage)**:

```text
@devops-engineer GitHub Actions와 Docker를 사용한 CI/CD 파이프라인을 구축해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@devops-engineer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 11. @orchestrator

**역할(Role)**: 오케스트레이터 AI(Orchestrator AI)

**설명(Description)**: 스펙 주도 개발(SDD)을 위해 18개의 전문 AI 에이전트를 관리·조정하는 통합 오케스트레이터 에이전트

**카테고리(Category)**: 오케스트레이션(Orchestration)

**MCP Tools** (CodeGraph MCP Server 사용 가능 시):

- `global_search` - 코드베이스 전체 조망 및 커뮤니티 탐지
- `query_codebase` - 작업과 관련된 코드 검색

**사용 예시(Example Usage)**:

```text
@orchestrator 요구사항부터 배포까지 사용자 인증 기능을 구현해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@orchestrator` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 12. @performance-optimizer

**역할(Role)**: 성능 최적화 AI(Performance Optimizer AI)

**설명(Description)**: 성능 분석, 병목 지점 탐지, 최적화 전략 수립, 벤치마킹을 지원하는 Copilot 에이전트

**카테고리(Category)**: 보안 & 성능(Security & Performance)

**사용 예시(Example Usage)**:

```text
@performance-optimizer 페이지 로딩 지연을 유발하는 데이터베이스 쿼리를 최적화해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@performance-optimizer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 13. @project-manager

**역할(Role)**: 프로젝트 매니저 AI(Project Manager AI)

**설명(Description)**: 소프트웨어 개발 프로젝트를 대상으로 프로젝트 계획 수립, 일정 관리, 리스크 관리, 진행 상황 추적을 지원하는 Copilot 에이전트

**카테고리(Category)**: 요구사항(Requirements)

**사용 예시(Example Usage)**:

```text
@project-manager 3개월 개발 기간의 프로젝트에 대해 WBS와 간트 차트를 포함한 프로젝트 계획을 수립해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@project-manager` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 14. @quality-assurance

**역할(Role)**: 품질 보증(QA) AI(Quality Assurance AI)

**설명(Description)**: 체계적인 테스트와 품질 메트릭을 통해 제품 품질을 보장하기 위한 종합 QA 전략 및 테스트 계획 수립을 지원하는 Copilot 에이전트

**카테고리(Category)**: 품질(Quality)

**사용 예시(Example Usage)**:

```text
@quality-assurance 신규 기능 릴리스를 위한 QA 전략과 테스트 계획을 수립해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@quality-assurance` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 15. @release-coordinator

**역할(Role)**: 릴리스 코디네이터 AI(Release Coordinator)

**설명(Description)**: 다중 컴포넌트 릴리스, 기능 플래그(feature flag), 버전 관리, 롤백 전략을 조율하는 에이전트

**카테고리(Category)**: 인프라(Infrastructure)

**사용 예시(Example Usage)**:

```text
@release-coordinator 롤백 절차와 배포 윈도우를 포함한 릴리스 전략을 수립해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@release-coordinator` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 16. @requirements-analyst

**역할(Role)**: 요구사항 분석가 AI(Requirements Analyst AI)

**설명(Description)**: 요구사항 분석, 사용자 스토리 작성, 사양 정의, 수용 기준(Acceptance Criteria) 정의를 지원하는 Copilot 에이전트

**카테고리(Category)**: 요구사항(Requirements)

**사용 예시(Example Usage)**:

```text
@requirements-analyst 이메일 인증을 포함한 사용자 회원가입 기능에 대한 EARS 요구사항을 작성해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@requirements-analyst` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 17. @security-auditor

**역할(Role)**: 보안 감사 AI(Security Auditor AI)

**설명(Description)**: 보안 감사(security-auditor) 전용 스킬을 수행하는 에이전트

**카테고리(Category)**: Security

**MCP Tools** (CodeGraph MCP Server 사용 가능 시):

- `find_callers` - 위험한 함수 호출 위치 추적
- `query_codebase` - 취약점 패턴 검색
- `find_dependencies` - 보안 관련 의존성 분석

**사용 예시(Example Usage)**:

```text
@security-auditor 인증 시스템을 OWASP Top 10 기준으로 보안 감사해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@security-auditor` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 18. @site-reliability-engineer

**역할(Role)**: 사이트 신뢰성 엔지니어(SRE, Site Reliability Engineer)

**설명(Description)**: 프로덕션 모니터링, 옵저버빌리티, SLO/SLI 관리, 장애 대응을 담당하는 에이전트

**카테고리(Category)**: 인프라(Infrastructure)

**사용 예시(Example Usage)**:

```text
@site-reliability-engineer 프로덕션 환경에 대한 모니터링, 알림, SLO 추적을 설정해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@site-reliability-engineer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 19. @software-developer

**역할(Role)**: 소프트웨어 개발자 AI(Software Developer)

**설명(Description)**: software-developer 전용 스킬을 수행하는 에이전트

**카테고리(Category)**: 개발(Development)

**MCP Tools** (CodeGraph MCP Server 사용 가능 시):

- `get_code_snippet` - 기존 코드 참조
- `find_callees` - 호출 대상 확인
- `local_search` - 유사 구현 패턴 탐색
- `query_codebase` - 관련 코드 검색

**사용 예시(Example Usage)**:

```text
@software-developer JWT 인증과 단위 테스트를 포함한 사용자 로그인 API를 구현해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@software-developer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 20. @steering

**역할(Role)**: 스티어링(Steering)

**설명(Description)**: 프로젝트 스티어링(steering) 전용 스킬을 수행하는 에이전트

**카테고리(Category)**: 오케스트레이션(Orchestration)

**MCP Tools** (CodeGraph MCP Server 사용 가능 시):

- `global_search` - 코드베이스 구조 파악
- `analyze_module_structure` - 모듈 구조 분석
- `query_codebase` - 기술 스택 탐지

**사용 예시(Example Usage)**:

```text
@steering 이 코드베이스를 분석하고 프로젝트 스티어링 컨텍스트를 생성해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@steering` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 21. @system-architect

**역할(Role)**: 시스템 아키텍트 AI(System Architect AI)

**설명(Description)**: 아키텍처 설계, C4 모델 다이어그램, ADR 작성, 트레이드오프 분석을 지원하는 Copilot 에이전트

**카테고리(Category)**: 아키텍처(Architecture)

**MCP Tools** (CodeGraph MCP Server 사용 가능 시):

- `global_search` - 커뮤니티 탐지를 통한 모듈 경계 식별
- `analyze_module_structure` - 모듈 구조 분석
- `find_dependencies` - 컴포넌트 간 의존성 가시화

**사용 예시(Example Usage)**:

```text
@system-architect C4 다이어그램을 포함한 이커머스 플랫폼용 마이크로서비스 아키텍처를 설계해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@system-architect` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 22. @technical-writer

**역할(Role)**: 테크니컬 라이터 AI(Technical Writer)

**설명(Description)**: technical-writer 전용 스킬을 수행하는 에이전트

**카테고리(Category)**: 문서화(Documentation)

**사용 예시(Example Usage)**:

```text
@technical-writer REST API에 대한 API 문서와 사용자 가이드를 작성해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@technical-writer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 23. @test-engineer

**역할(Role)**: 테스트 엔지니어 AI(Test Engineer)

**설명(Description)**: test-engineer skill

**카테고리(Category)**: 품질(Quality)

**MCP Tools** (CodeGraph MCP Server 사용 가능 시):

- `find_callers` - 테스트 커버리지 자동 판별
- `find_dependencies` - 미테스트 코드 경로 탐색
- `query_codebase` - 테스트 대상 검색

**사용 예시(Example Usage)**:

```text
@test-engineer 결제 처리 모듈에 대한 종합 테스트 스위트를 작성해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@test-engineer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 24. @traceability-auditor

**역할(Role)**: 트레이서빌리티 감사 AI(Traceability Auditor)

**설명(Description)**: EARS 요구사항 → 설계 → 태스크 → 코드 → 테스트 전반에 걸친 완전한 트레이서빌리티를 검증하는 에이전트

**카테고리(Category)**: 품질(Quality)

**MCP Tools** (CodeGraph MCP Server 사용 가능 시):

- `query_codebase` - 요구사항 ID 기반 코드 검색
- `find_callers` - 요구사항 → 코드 → 테스트 매핑 검증
- `find_dependencies` - 트레이서빌리티 체인 확인

**사용 예시(Example Usage)**:

```text
@traceability-auditor 사양 문서부터 테스트까지의 요구사항 트레이서빌리티를 검증해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@traceability-auditor` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 25. @ui-ux-designer

**역할(Role)**: UI/UX 디자이너 AI(UI/UX Designer AI)

**설명(Description)**: UI/UX 설계, 와이어프레임, 프로토타입, 디자인 시스템, 사용성 테스트를 지원하는 Copilot 에이전트

**카테고리(Category)**: 아키텍처(Architecture)

**사용 예시(Example Usage)**:

```text
@ui-ux-designer 모바일 쇼핑 앱을 위한 와이어프레임과 프로토타입을 제작해 줘
```

**플랫폼별 사용 방법(Platform-Specific Usage):**

- **Claude Code**: `@ui-ux-designer` (Skills API)
- **기타 Platforms**: 이 `AGENTS.md` 파일을 참조하고, 요청 시 에이전트의 역할을 설명

---

## 헌법 기반 거버넌스 (Constitutional Governance)

모든 에이전트는 `steering/rules/constitution.md`에 정의된 9가지 헌법 조항을 반드시 준수해야 합니다:

1. **Article I**: Library-First Principle - 커스텀 코드 작성 전 기존 라이브러리 우선 사용
2. **Article II**: CLI Interface Mandate - 모든 도구는 CLI 인터페이스 제공
3. **Article III**: Test-First Imperative - 구현 전 테스트 작성(커버리지 80% 이상)
4. **Article IV**: EARS Requirements Format - 모든 요구사항은 EARS 패턴 사용
5. **Article V**: Traceability Obligation - 요구사항 ↔ 설계 ↔ 코드 ↔ 테스트 매핑 유지
6. **Article VI**: Project Memory - 작업 시작 전 steering 파일 필수 참조
7. **Article VII**: Bilingual Documentation - 영어 우선 작성 후 한국어 번역
8. **Article VIII**: Single Source of Truth - 문서당 하나의 정본 유지
9. **Article IX**: Real Services in Tests - 테스트 시 실제 서비스/API 사용

헌법 준수 여부 검증에는 `@constitution-enforcer`를 사용하십시오.

---

## 워크플로우 통합 (Workflow Integration)

### 그린필드 프로젝트(Greenfield Projects) (New Development)

```text
1. @steering                  → 프로젝트 메모리 생성 (structure.md, tech.md, product.md)
2. @requirements-analyst      → EARS 요구사항 작성
3. @system-architect          → C4 다이어그램 기반 아키텍처 설계
4. @api-designer              → API 설계 (필요 시)
5. @database-schema-designer  → 데이터베이스 설계 (필요 시)
6. @software-developer        → 테스트 포함 구현
7. @test-engineer             → 종합 테스트 스위트 작성
8. @code-reviewer             → 코드 품질 리뷰
9. @security-auditor          → 보안 감사
10. @devops-engineer          → CI/CD 구축
11. @release-coordinator      → 배포 계획 수립
```

### 브라운필드 프로젝트(Brownfield Projects) (Existing Codebase)

```text
1. @change-impact-analyzer    → 변경 영향 분석
2. @requirements-analyst      → 변경 요구사항 문서화
3. @system-architect          → 필요 시 아키텍처 수정
4. @software-developer        → 변경 사항 구현
5. @test-engineer             → 테스트 업데이트/추가
6. @code-reviewer             → 변경 코드 리뷰
7. @traceability-auditor      → 트레이서빌리티 검증
```

### 빠른 작업(Quick Tasks)

- **버그 수정(Bug Fixing)**: @bug-hunter → @software-developer → @test-engineer
- **성능 개선(Performance)**: @performance-optimizer → @software-developer → @test-engineer
- **문서화(Documentation)**: @technical-writer
- **보안 감사(Security Audit)**: @security-auditor
- **프로젝트 계획(Project Planning)**: @project-manager

---

## 멀티 에이전트 오케스트레이션 (Multi-Agent Orchestration)

러 도메인에 걸친 복잡한 작업의 경우 다음을 사용하십시오:

```text
@orchestrator [복잡한 요청 내용]
```

오케스트레이터는 다음을 수행합니다:

1. 요청 분석
2. 하위 작업 분해
3. 적절한 에이전트 선택
4. 실행 조율
5. 결과 통합
6. 헌법 조항 준수 보장

**예시**:

```text
@orchestrator API, 데이터베이스, 테스트, 배포 파이프라인을 포함한 안전한 결제 처리 기능을 구현해 줘
```

---

**Generated by ITDA v0.1.3** | [문서](https://github.com/gaebalai/itda-sdd)