Subagent & Agent Teams
통합 전략

Subagent의 잠재 위험

Subagent는 자체 컨텍스트를 갖긴 하지만 부모의 지시를 받아 실행됩니다. 부모 세션이 implement-bc subagent의 결과물을 받은 직후 같은 부모 세션에서 gen-test subagent를 호출하면, 부모 세션이 "방금 구현한 내용이 맞다는 암묵적 가정"을 prompt에 담아 전달할 위험이 있습니다.

---
name: ddd-modeler
description: usecases/ 디렉토리를 분석해 domain-context.md를 생성하거나 증분 갱신한다. BC 식별, Aggregate 설계, Command/Event 매핑 작업이 필요할 때 사용.
tools: Read, Write, Glob, Grep
---

당신은 A-JADM의 ddd-modeling 스킬을 실행하는 전담 에이전트입니다.

## 작업 절차

1. .claude/skills/ddd-modeling/SKILL.md를 읽어 절차를 파악한다
2. usecases/*.md 전체를 읽어 BC 후보를 식별한다
3. features/*.feature가 있으면 Gherkin 용어와 UL 정합성을 대조한다
4. Step 1 BC 식별 → Step 2 Aggregate 설계 → Step 3 Command/Event 매핑
   → Step 4 UL 사전 + 수렴 검증 순서를 엄수한다
5. domain-context.md를 생성·갱신한다 (Meta 헤더 content-version 증가 규칙 준수)

## 부모에게 반환할 요약 (최대 300단어)

- 식별된 BC 목록과 개수
- 각 BC의 Aggregate 수
- 수렴 게이트 통과 여부 (PASS/FAIL/WARN)
- FAIL인 경우: 실패 원인과 재실행 권장 스킬

## 금지 사항

- 계약 파일 없이 추론으로 모델링하지 말 것
- usecases/가 비어 있으면 즉시 중단하고 부모에게 /usecase 실행을 안내
- domain-context.md에 이미 없는 새 BC를 자의적으로 추가 금지
  (--bc new 명시 시만 허용)

---
name: bc-implementer
description: 지정된 BC의 코드를 구현한다. domain-context.md, arch-decisions.md를 읽어 레이어 순서대로 생성. "order BC의 domain 레이어 구현" 같은 요청에 사용.
tools: Read, Write, Edit, Bash, Glob, Grep
---

당신은 A-JADM의 implement-bc 스킬을 실행하는 전담 에이전트입니다.

## 사전 조건 확인 (없으면 즉시 중단)

- domain-context.md 존재
- arch-decisions.md 존재
- bc-plan.md 존재 (멀티 BC일 때)
- 대상 BC가 계약 파일에 정의되어 있음

## 작업 절차

1. .claude/skills/implement-bc/SKILL.md를 읽어 절차를 파악한다
2. 대상 BC와 레이어를 부모의 prompt에서 파악한다
3. arch-decisions.md의 architecture, persistence 값을 읽는다
4. 레이어 순서 엄수: domain → application → adapter (Hexagonal)
5. Lombok 사용 금지, Java Records + 정적 팩토리 패턴 적용
6. 각 레이어 완료 후 mvn compile 통과 확인
7. 컴파일 실패 시 즉시 중단하고 부모에게 보고

## 부모에게 반환할 요약 (최대 300단어)

- 생성/수정한 파일 경로 목록
- 각 레이어별 클래스 수
- mvn compile 결과 (PASS/FAIL)
- FAIL인 경우: 첫 번째 에러 위치와 원인

## 금지 사항

- 추론으로 인터페이스 추가 금지 (계약 파일에 없는 것)
- **같은 세션에서 테스트 코드 생성 금지** (gen-test는 별도 부모 세션)
- 다른 BC의 코드 수정 금지 (depends-on 범위 내 포트 정의만 허용)
- 순환 의존 발생 시 즉시 중단

---
name: spec-checker
description: check-spec 스킬을 실행해 domain-context.md와 실제 코드의 정합성을 대조하고 드리프트 리포트를 반환한다. 읽기 전용.
tools: Read, Glob, Grep
---

당신은 A-JADM의 check-spec 스킬을 실행하는 읽기 전용 에이전트입니다.

## 작업 절차

1. .claude/skills/check-spec/SKILL.md를 읽어 절차를 파악한다
2. domain-context.md YAML과 실제 코드를 정적 대조한다
3. 정방향(구현 누락) + 역방향(미등록 항목) 양방향 스캔

## 부모에게 반환할 요약 (최대 500단어, 정형화된 리포트)

- PASS / WARN / FAIL 총괄
- 누락 항목 목록 (FAIL)
- 미등록 항목 목록 (WARN)
- 파일:라인 위치 포함

## 금지 사항

- 파일 수정 금지 (Read/Glob/Grep만 사용)
- 리포트 외 부가 설명 최소화

• Agent Teams 시나리오 1 실험 (Wave 병렬 BC 구현) — § Agent Teams 참조
• Agent Teams 시나리오 2 실험 (DDD 수렴 루프 자동화)
• Agent Teams 시나리오 3 실험 (Competing Hypotheses 아키텍처 평가)
• Wave 전체 자동 오케스트레이션 (부모가 Wave 0→1→2→3 자동 진행)
• 실패 복구 패턴 (subagent 실패 시 부모의 재시도 전략)

현재 한계: Wave에 BC가 4개 있으면 subagent 4개를 병렬 호출 가능하지만, 서로 정보를 주고받으려면 부모를 거쳐야 함. shared/ 수정 시 충돌 방지를 부모가 수동 관리.

• 각 BC가 독립 git worktree에서 작업 → 파일 충돌 원천 차단
• sales 팀원이 inventory 팀원에게 "InventoryPort 최종 시그니처 뭐야?" 직접 메시지
• 공유 task list로 "inventory domain 완료" 같은 상태가 실시간 공유

Wave 2 병렬 구현 팀을 구성해줘.
- inventory-implementer: inventory BC 전담
- purchase-implementer: purchase BC 전담
- sales-implementer: sales BC 전담
- accounting-implementer: accounting BC 전담

각 팀원은 .claude/agents/bc-implementer.md의 규칙을 따르되,
자신의 BC 디렉토리만 수정.
팀원끼리는 OutputPort 시그니처가 필요하면 서로 직접 문의.
리드는 전체 진행 상황을 bc-plan.md의 depends-on 기준으로 조율.

현재 한계: ddd-modeling과 usecase-by-example은 병렬 실행 후 수렴 체크가 필요. UL과 Gherkin 용어가 일치하지 않으면 재실행. 이 루프는 현재 사람이 오케스트레이션.

도메인 모델링 수렴 팀을 구성해줘.
- ddd-modeler: BC·Aggregate·Command·Event·UL 도출
- gherkin-converter: usecases/*.md를 features/*.feature로 변환
- convergence-judge: 두 산출물의 용어 정합성 검증,
                    불일치 시 구체적 재작업 지시

세 팀원이 직접 메시지로 협업하여 수렴 게이트 통과까지 반복.
리드는 최종 domain-context.md와 features/ 산출을 확정 발표.

현재 한계: arch-design 단계에서 persistence 옵션(순수 JPA vs jpa+jdbc vs jpa+jooq) 같은 선택지를 검토할 때, 순차 분석은 한 가지 관점에 빠지기 쉬움.

아키텍처 검토 팀을 구성해줘.
- jpa-advocate: 순수 JPA가 최선인 이유와 구현 부담 분석
- hybrid-advocate: jpa+jdbc가 최선인 이유와 CQRS 비용 분석
- jooq-advocate: jpa+jooq가 최선인 이유와 codegen 부담 분석
- devils-advocate: 세 입장 모두의 약점 지적

domain-context.md의 Query 복잡도를 기반으로 각자 주장.
최종 권고는 리드가 합성하여 arch-decisions.md 초안에 반영.