메뉴
Architecture Decision Record 생성 및 관리. 새 ADR 작성, 기존 ADR 조회, ADR 인덱스 갱신. /adr, ADR, 아키텍처 결정, 기술 선택, 설계 결정 키워드에 트리거.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
주제를 분석하여 스포츠 도메인, 기술, 프로젝트 지식을 조사. /research, 리서치, 조사, 분석, 알아봐줘 키워드에 트리거.
기능 개발 파이프라인. Plan → Implement → Audit 3단계를 각각 전문 에이전트에 위임하여 오케스트레이션. 기능 구현, 기능 추가, 기능 개발, 도메인 기능 빌드 시 사용. 이전 빌드 결과 수정, 감사만 재실행, 구현 재시도에도 사용. /build-feature {도메인} {기능 설명}
DDD 전략적 설계 패턴 가이드. Bounded Context 정의, Context Mapping, Subdomain 분류, 도메인 간 이벤트 통신, Anti-Corruption Layer 패턴. 새 Bounded Context 추가, 도메인 간 관계 설계, 이벤트 기반 통합, 외부 시스템 연동 시 사용. bounded context, context map, subdomain, ubiquitous language, event storming, ACL, anti-corruption, domain event, 도메인 경계, 컨텍스트 매핑 키워드에 트리거.
DDD 전술적 설계 패턴 가이드. Spring Boot + jOOQ 기반의 도메인별 패키징, Simplified CQRS, AggregateRoot, Domain Event, UseCase 인터페이스 패턴. 새 도메인 추가, Aggregate 설계, Command/Query 분리, Repository 구현, 도메인 이벤트 발행, ACL 구현 시 사용. DDD, aggregate, entity, value object, domain event, repository, use case, CQRS, command, query, ACL, anti-corruption layer, 외부 시스템 연동, 이벤트 변환 키워드에 트리거.
| name | adr |
| description | Architecture Decision Record 생성 및 관리. 새 ADR 작성, 기존 ADR 조회, ADR 인덱스 갱신. /adr, ADR, 아키텍처 결정, 기술 선택, 설계 결정 키워드에 트리거. |
아키텍처 결정을 기록하고 추적하는 도구.
간단한 기능 추가나 버그 수정은 ADR 대상이 아니다.
사용자가 /adr {제목} 또는 "ADR 작성해줘"라고 하면:
docs/adr/ 디렉토리에서 가장 큰 번호를 찾는다docs/adr/{NNNN}-{kebab-case-title}.md 파일을 생성한다docs/adr/TEMPLATE.md의 형식을 따른다docs/adr/README.md 인덱스를 갱신한다# 다음 번호 산출
NEXT=$(ls docs/adr/ | grep -oE '^[0-9]+' | sort -n | tail -1)
NEXT=$((NEXT + 1))
# 4자리 패딩: 0001, 0002, ...
docs/adr/0001-cqrs-pattern-adoption.md
docs/adr/0002-jooq-over-jpa.md
docs/adr/0003-ulid-for-id-generation.md
상황을 객관적으로 기술한다. 문제가 무엇인지, 왜 결정이 필요한지.
## 컨텍스트
데이터 접근 계층에서 ORM을 선택해야 한다.
도메인 모델이 복잡하고 jOOQ의 타입 세이프 쿼리가 필요하며,
QueryApi에서 직접 SQL을 작성하는 CQRS 패턴을 사용할 예정이다.
최소 2개 이상. 각각 장단점을 명시한다. "검토했지만 버린 것"도 기록해야 나중에 같은 논의를 반복하지 않는다.
한 문장으로 명확하게. "X를 채택한다."
"왜"를 설명한다. 이것이 ADR의 핵심 가치 — 미래의 자신이 "왜 이렇게 했지?"라고 물을 때 답이 된다.
긍정적 결과와 부정적 결과 모두. 트레이드오프를 솔직하게 기록한다.
ADR 생성/수정 후 docs/adr/README.md를 갱신한다:
# Architecture Decision Records
| # | 제목 | 상태 | 날짜 | 도메인 |
|---|------|------|------|--------|
| [0001](0001-cqrs-pattern.md) | CQRS 패턴 채택 | 승인됨 | 2025-03-15 | 전체 |
| [0002](0002-jooq-over-jpa.md) | JPA 대신 jOOQ 선택 | 승인됨 | 2025-03-15 | 전체 |
기존 ADR을 수정하지 않는다. 대신: