• 루트 AGENTS.md

  전 서비스 공통 규칙 · 금지사항

• 서비스별 AGENTS.md

  도메인 · 계약 위치 · 실행 명령

• contracts/ 폴더

  OpenAPI · 이벤트 스키마 = 단일 진실

• docs/adr/

  결정 이유를 남겨 에이전트도 따름

shop/
├─ AGENTS.md            # common rules
├─ CLAUDE.md            # -> see AGENTS.md
├─ contracts/
│  ├─ user.openapi.yaml
│  ├─ order.openapi.yaml
│  └─ events.asyncapi.yaml
├─ docs/adr/0001-db-per-service.md
└─ services/
   ├─ user/   AGENTS.md  app/  tests/
   ├─ product/AGENTS.md  app/  tests/
   └─ order/  AGENTS.md  app/  tests/

• 역할과 산출물 형식 지정

  표 · 목록 등 검토하기 쉬운 형태로

• 결정은 요청하지 않기

  후보와 장단점만, 선택은 사람이

• 반대 의견도 요청

  '모놀리스로 충분한가?'를 꼭 묻기

• 결과는 ADR 초안으로

  합의한 내용만 저장소에 커밋

너는 DDD에 익숙한 아키텍트야.
docs/requirements.md 를 읽고 다음을 만들어 줘.

1. 도메인 이벤트 목록 (과거형, 발생 주체 포함)
2. 이벤트를 묶은 바운디드 컨텍스트 후보 2~3안
3. 각 안의 서비스별 소유 데이터와 동기/비동기 호출
4. 각 안의 장단점, 그리고
   '모듈러 모놀리스로 충분한 이유'가 있다면 그것도

코드는 아직 작성하지 마. 표로 정리해.

• FastAPI + Redis Streams

  실습 환경에서 가장 가벼운 조합

• 이벤트 이름은 과거형

  order.created, stock.reserved

• 멱등성 키 필수

  같은 이벤트가 두 번 와도 한 번만 처리

• 스키마는 contracts/

  에이전트는 계약을 읽고 구현

# services/order/app/main.py
import json, uuid, redis
from fastapi import FastAPI, Header

app = FastAPI()
r = redis.Redis(host="redis")

@app.post("/orders")
def create(body: dict,
           key: str = Header(alias="Idempotency-Key")):
    if not r.set(f"idem:{key}", 1, nx=True, ex=86400):
        return {"status": "duplicate"}
    oid = str(uuid.uuid4())
    # save PENDING order + outbox row
    evt = json.dumps({"id": oid, **body})
    r.xadd("order.created", {"data": evt})
    return {"id": oid, "status": "PENDING"}

• 서비스별 작업 폴더 분리

  에이전트끼리 파일 충돌 없음

• tmux 창 하나에 에이전트 하나

  1일차에 구축한 환경 그대로

• 각자 브랜치 → PR

  lazygit 으로 diff 리뷰 후 머지

• 계약은 main 에서만 변경

  worktree 에서 계약 수정 금지

# one worktree per service
$ git worktree add ../shop-user    -b feat/user
$ git worktree add ../shop-product -b feat/product
$ git worktree add ../shop-order   -b feat/order

# tmux: 3 panes, 3 agents
$ tmux new -s msa
  pane 1) cd ../shop-user    && claude
  pane 2) cd ../shop-product && codex
  pane 3) cd ../shop-order   && claude

# review & merge
$ lazygit

• 읽을 파일을 명시

  AGENTS.md · 계약 · 요구사항

• 테스트 먼저

  실패하는 테스트 → 구현 순서

• 범위 제한

  자기 서비스 폴더만 수정

• 완료 조건 명시

  pytest 통과 + 실행 방법 보고

services/order/AGENTS.md 와 contracts/order.openapi.yaml,
contracts/events.asyncapi.yaml 을 먼저 읽어.

1. 계약의 모든 엔드포인트에 대한 pytest 를 먼저 작성해.
   재고 부족 · 결제 실패 · 중복 요청 시나리오를 포함해.
2. 테스트가 실패하는 것을 확인한 뒤 구현해.
3. services/order/ 밖의 파일과 contracts/ 는 수정하지 마.
   계약이 이상하면 수정하지 말고 나에게 보고해.
4. 끝나면 pytest 결과와 실행 방법을 요약해 줘.