https://github.com/gmoon92/alive-domain-docgen
Alive Domain Docgen은 개발 프로세스를 바꾸지 않는다. 단지, 개발이 남긴 흔적을 도메인 지식으로 변환할 뿐이다.
https://github.com/gmoon92/alive-domain-docgen
Last synced: 22 days ago
JSON representation
Alive Domain Docgen은 개발 프로세스를 바꾸지 않는다. 단지, 개발이 남긴 흔적을 도메인 지식으로 변환할 뿐이다.
- Host: GitHub
- URL: https://github.com/gmoon92/alive-domain-docgen
- Owner: gmoon92
- License: mit
- Created: 2026-01-29T07:40:03.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-09T03:52:29.000Z (4 months ago)
- Last Synced: 2026-02-09T09:44:46.501Z (4 months ago)
- Language: Python
- Size: 116 KB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Alive Domain Docgen
**"이 코드를 왜 이렇게 짰지?"**
6개월 전 내가 작성한 코드조차 기억나지 않습니다. 동료가 짠 코드는 더더욱. 도메인 문서는 있지만, 실제 코드와 맞지 않습니다. 수정할 때마다 불안합니다.
**Alive Domain Docgen**은 커밋 히스토리를 읽어 도메인 문서를 자동으로 생성합니다. 개발자는 평소처럼 커밋만 하면 됩니다.
---
## 이런 경험 없으신가요?
- 신입 개발자에게 "일단 코드 읽어봐"라고 말하는 것 외엔 방법이 없다
- 핵심 멤버가 퇴사하면 도메인 지식도 함께 증발한다
- 리팩토링을 시도하다가 "왜 이렇게 짰는지" 몰라서 되돌린다
- 도메인 문서를 쓰자고 하면 모두가 침묵한다
**문제는 명확합니다**: 문서를 쓸 시간이 없습니다. 쓴다 해도 금방 낡습니다.
---
## 작동 방식
```
1. 개발자가 평소처럼 커밋한다
↓
2. AI가 변경을 분석하고 도메인 관점으로 해석한다
↓
3. 도메인 문서가 자동으로 최신화된다
```
**핵심**: 개발 흐름을 바꾸지 않습니다. CI/CD처럼 백그라운드에서 작동합니다.
> 예: `OrderService`에 취소 로직을 추가하면, "주문 정책" 문서에 "취소 가능 조건"이 자동으로 기록됩니다.
---
## 얻을 수 있는 것
### 지식 증발 방지
특정 개발자에게 의존하지 않습니다. 커밋 히스토리가 있는 한, 도메인 지식은 보존됩니다.
### 온보딩 시간 단축
신규 개발자가 "왜 이 코드가 존재하는지" 맥락을 빠르게 파악합니다.
### 자신감 있는 리팩토링
도메인 규칙이 문서화되어 있어, 무엇을 지켜야 하는지 명확합니다.
### 살아있는 문서
코드와 함께 자동으로 업데이트됩니다. 낡은 문서 걱정이 사라집니다.
---
## 차별점
**문서를 강요하지 않습니다**
게이트도 없고, 규칙도 없습니다. 커밋만 하면 됩니다.
**운영 중인 코드만 문서화합니다**
실험하다 되돌린 코드, 머지되지 않은 브랜치는 무시합니다. 문서는 현재 프로덕션의 진실만 담습니다.
**레거시 프로젝트도 환영합니다**
완벽한 초기 분석은 포기합니다. 지금부터 바뀌는 코드를 기준으로 점진적으로 성장합니다.
---
## 더 알아보기
궁금하신 분을 위한 상세 문서입니다:
- [왜 만들었나요?](docs/01-background-and-problems.md) - 배경과 문제 인식
- [어떤 원칙으로 설계했나요?](docs/03-design-principles.md) - 핵심 설계 원칙
- [내부 구조가 궁금해요](docs/07-architecture.md) - 시스템 아키텍처
- [전체 문서 보기](docs/) - 8개 문서 전체 목차