docs(agents): 로컬 이슈와 도메인 문서 관리 규칙을 추가한다

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