DDD 커널과 AI Agent 최적화 가이드를 통한 초기 설정 1~2주 단축

Context

TypeScript 기반 서비스 구축 시 ORM 설정과 DDD 베이스 클래스 구현에 반복적으로 1~2주의 시간이 소요됨. 특히 AI 코딩 도구가 프로젝트의 고유 아키텍처를 인지하지 못해 매 세션마다 반복적인 프롬프팅이 필요한 비효율이 발생함.

Technical Solution

• AsyncLocalStorage 기반의 자동 추적 메커니즘을 통한 Unit of Work 패턴 구현으로 Use Case 내 repository.save() 호출 제거
• Domain Event를 Aggregate 쓰기와 동일 트랜잭션 내에 저장하는 Same-transaction Event Store 설계를 통한 Dual-write 문제 해결
• AGENTS.md 및 .claude/skills/ 중심의 단일 진실 공급원(SSOT)을 구축하고 스크립트를 통해 Cursor, Copilot 등 다양한 AI 도구의 Rule 파일 자동 동기화
• LLM의 확률적 판단을 보완하기 위해 Node ESM 기반의 결정론적 Hook(hexagonal-validator, plainobject-checker 등)을 도입하여 아키텍처 위반을 강제 차단
• YAML 프론트매터와 마크다운 바디를 결합한 Ring 포맷의 Skill 정의를 통해 AI가 스스로 활성화 규칙을 판단하고 실행하는 구조 설계