새 도메인 컨텍스트를 검증 질문을 거쳐 생성합니다. context/{도메인}/ 디렉토리와 README.md, PROJECTS.md, glossary.md, architecture.md를 만듭니다.
새 도메인 컨텍스트를 생성한다. 디렉토리와 문서를 만들기 전에 검증 질문으로 도메인의 목적과 배경을 명확히 한다.
프로젝트 루트에 context/ 디렉토리가 없으면 자동 생성한다:
test -d context/ 로 존재 여부 확인mkdir -p context/context/README.md 생성 (도메인 목록 인덱스 템플릿):
# 프로젝트 컨텍스트
도메인 지식, 아키텍처, 용어 사전을 정리하는 공간입니다.
## 도메인
| 도메인 | 설명 | 상세 |
|--------|------|------|
## 공통
- [공통 용어 사전](glossary.md)
context/glossary.md 생성 (공통 용어 사전 스켈레톤):
# 공통 용어 사전
> 도메인을 가리지 않고 프로젝트 전체에서 쓰이는 용어입니다.
> 도메인별 용어는 `context/{도메인}/glossary.md`를 참조하세요.
| 용어 | 설명 |
|------|------|
context/{도메인}/이 이미 존재하면 안내 후 종료한다.AskUserQuestion으로 아래 4개를 한 번에 묻는다:
답변을 받은 뒤 아래를 확인한다:
모호함 판단 기준:
모호했던 항목에 대해서만 구체화를 요청한다:
여전히 모르는 항목은 ❓로 남기고 진행한다. 2라운드 이상 반복하지 않는다.
AskUserQuestion으로 묻는다:
xx/factory-api, yy/factory-admin)레포가 있으면 각 레포의 역할도 함께 기록한다. 아직 없으면 빈 테이블로 생성한다.
context/{도메인}/
├── README.md ← 검증 질문 답변 정리
├── PROJECTS.md ← 관련 프로젝트(레포) 목록
├── glossary.md ← 용어 사전 스켈레톤
├── architecture.md ← 전체 구조 요약 + 주제 문서 링크 (인덱스)
└── status.md ← 구현 추적
검증 질문 답변을 아래 구조로 정리한다:
# {도메인명}
{한 줄 설명}
## 배경
{문제 + 현재 프로세스를 서술형으로 정리}
## 안 하면 어떻게 되는가
{답변 정리. 정량 수치 포함}
## 사용자와 규모
{누가, 몇 명, 얼마나 자주}
## 성공 기준
{정량적 기준. 미확인 시 ❓ 표기}
## 현재 상태
탐색 중
# {도메인명} 관련 프로젝트
| 레포 | 역할 |
|------|------|
| {org/repo} | {역할} |
관련 레포가 없으면 빈 테이블로 생성한다.
# {도메인명} 용어 사전
| 용어 | 설명 |
|------|------|
# {도메인명} 아키텍처
> 전체 구조 요약과 주제별 상세 문서 링크를 관리합니다.
## 시스템 구조
(확정 시 작성)
## 주제 문서
| 주제 | 설명 |
|------|------|
# {도메인명} 구현 추적
> PRD 요구사항별 구현 상태를 추적합니다.
## 범례
- ✅ 반영됨 — 코드에 구현 완료
- ⬜ 미반영 — 정책/설계만 확정, 코드 미구현
아래는 /dev 환류 등으로 주제 문서를 생성할 때 사용하는 헤더 형식이다. /new-context 실행 시에는 생성하지 않는다.
# {제목}
- 작성일: YYYY-MM-DD
- 수정일: YYYY-MM-DD
- 관련 레포: {org/repo}
context/README.md의 도메인 테이블에 새 행을 추가한다.
생성된 파일 목록과 ❓ 항목(있다면)을 안내한다.