Dddjango

dddjango — Claude Code · Codex

**Django 프로젝트에 DDD(도메인 주도 설계)를 제대로 입히는 Claude Code·Codex 플러그인.**

Claude Code의 `/dddjango <기능>` 또는 Codex의 `dddjango를 사용해 <기능>` 요청으로 시작하면, 한 기능을 **요구 정리 → 설계 → 구현(TDD)** 까지 전문 에이전트들이 협업해 깔끔한 4계층 DDD 구조로 완성한다. 매 단계 당신의 승인을 받고 진행한다.

---

왜 dddjango인가

기본 Django는 빠르게 시작하기 좋지만, 기능이 커질수록 비즈니스 규칙이 흩어진다.

• 도메인 규칙이 models.py(fat model)와 views.py에 뒤섞이고,
• ORM 모델이 곧 도메인 모델이라 DB 스키마와 비즈니스 로직이 한 덩어리가 되며,
• 결국 "한 줄 고치면 어디가 깨지는지 모르는" 코드가 된다.

**dddjango는 한 기능을 추가할 때마다 이걸 4계층 DDD로 정돈한다:**

계층	책임	예
domain	순수 비즈니스 규칙·불변식 (프레임워크 무관)	Order 엔티티, Quantity 값 객체
application	유스케이스 흐름 (무엇을 언제)	PlaceOrder 커맨드
infra	ORM·외부 연동 등 세부 구현	OrderModel(Django ORM), DjangoOrderRepository
presentation	바깥 계약 (API 등)	django-ninja 엔드포인트

도메인 모델(`Order`)과 ORM 모델(`OrderModel`)을 **분리**하고, 다른 바운디드 컨텍스트는 **ACL/OHS로 번역**해 연결한다. 즉, Django 위에서 교과서적인 DDD 구조를 강제로 지켜 준다 — 이게 핵심이다.

이건 프로젝트를 새로 만드는 도구가 아니라, **이미 있는 Django 프로젝트에 한 기능을 DDD로 더하는** 도구다.

---

설치

**Claude Code** — 슬래시 커맨드로:

/plugin marketplace add changja88/dddjango
/plugin install dddjango@changja88-dddjango

**Codex** — CLI로:

codex plugin marketplace add changja88/dddjango --ref main
codex plugin add dddjango@changja88-dddjango

두 마켓 모두 같은 GitHub 레포(`changja88/dddjango`)에서 받습니다. 설치 후 세션을 재시작하세요.

화면(웹 표현계층)까지 만들려면 자매 플러그인 **dddjango-web**을 함께 설치한다:

/plugin install dddjango-web@changja88-dddjango          # Claude Code
codex plugin add dddjango-web@changja88-dddjango         # Codex

---

작업 요청 가이드

설치한 각 플러그인 루트의 `REQUEST_GUIDE.md`가 해당 runtime의 권위 있는 가이드 사본이다. 아래 링크는 저장소에서 최신 가이드를 찾는 진입점이다.

`dddjango`는 한 기능과 원하는 업무 변화로 시작할 수 있다. `dddjango-web` 화면 발주에는 Claude Design 공유 URL과 그 안에서 구현할 화면이 필수다. 그 밖의 정보는 이미 알고 있거나 정한 부분만 보태면 된다.

플러그인	요청 정보	작업 경계	가이드
dddjango	원하는 업무 변화·대표 성공 결과·이미 정한 핵심 규칙과 실패 뒤 상태·보존/변경/제외 범위	시안 재현 중심의 화면 작업은 dddjango-web으로 이어간다. Django admin