diff --git a/docs/agents/domain.md b/docs/agents/domain.md new file mode 100644 index 00000000..a14fcb16 --- /dev/null +++ b/docs/agents/domain.md @@ -0,0 +1,13 @@ +# 도메인 문서 + +## 구성 및 읽기 순서 +- 기본 구성은 single-context다. +- 코드 탐색 전 루트 `GLOSSARY.md`와 작업 영역에 관련된 `docs/adr/` 문서를 읽는다. +- 루트 `GLOSSARY-MAP.md`가 있으면 관련 문맥의 용어집도 읽는다. +- 해당 문서가 없으면 별도 경고나 선행 생성 제안 없이 작업을 진행한다. +- 용어·결정이 실제로 확정될 때 `domain-modeling` 스킬로 문서를 작성한다. + +## 사용 규칙 +- 이슈·설명·테스트 이름에는 용어집에 정의된 용어를 사용한다. +- 필요한 용어가 없으면 실제 프로젝트 용어인지 확인하고 정리 필요성을 기록한다. +- 기존 ADR과 충돌하는 제안은 대상 ADR과 재검토 이유를 명시한다. diff --git a/docs/agents/issue-tracker.md b/docs/agents/issue-tracker.md new file mode 100644 index 00000000..5d9cec97 --- /dev/null +++ b/docs/agents/issue-tracker.md @@ -0,0 +1,26 @@ +# 이슈 트래커: 로컬 Markdown + +원격 저장소 변경에 의존하지 않도록 이슈를 `.scratch/`에서 관리한다. +이슈 생성·조회·갱신에 원격 이슈 트래커를 사용하지 않는다. + +## 파일 규칙 +- 기능별 디렉터리: `.scratch//` +- 구현 이슈: `issues/-.md`. 번호는 기능별로 `01`부터 부여한다. +- 이슈마다 파일 하나를 사용하며 여러 이슈를 한 파일로 합치지 않는다. +- 대화와 후속 기록은 파일 하단 `## Comments`에 누적한다. +- 이슈 식별자는 전체 경로로 전달한다. 번호만 받으면 기능을 확인한다. + +## 기존 요구사항·계획 문서와의 관계 +- PRD·구현 계획은 기존 `docs/[날짜]_구현할내용한글/` 규칙을 따른다. +- 스킬이 `spec.md`를 요구하면 `.scratch//spec.md`에 + 원본 PRD·구현 계획 링크를 기록하고 내용을 중복 관리하지 않는다. +- 이슈는 관련 PRD·Task/Goal을 참조하며 기존 구현 전 절차를 대체하지 않는다. + +## 스킬 요청 처리 +- "이슈 트래커에 게시": 위 규칙에 따라 이슈 파일을 생성한다. +- "관련 티켓 조회": 전달받은 이슈 파일을 읽는다. +- triage 스킬이 없으므로 triage 라벨 설정은 만들지 않는다. + +## 원격 저장소 이전 +이슈 이력을 함께 이전하려면 `.scratch/` 문서도 Git으로 관리한다. +인증 정보와 개인정보는 기록하지 않는다.