From 7187485ab1850d2ce7d524036f198ce0b2ffcef2 Mon Sep 17 00:00:00 2001 From: Klaus Date: Mon, 19 Oct 2026 13:45:25 +0900 Subject: [PATCH] =?UTF-8?q?docs(agents):=20=EB=A1=9C=EC=BB=AC=20=EC=9D=B4?= =?UTF-8?q?=EC=8A=88=EC=99=80=20=EB=8F=84=EB=A9=94=EC=9D=B8=20=EB=AC=B8?= =?UTF-8?q?=EC=84=9C=20=EA=B4=80=EB=A6=AC=20=EA=B7=9C=EC=B9=99=EC=9D=84=20?= =?UTF-8?q?=EC=B6=94=EA=B0=80=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/agents/domain.md | 13 +++++++++++++ docs/agents/issue-tracker.md | 26 ++++++++++++++++++++++++++ 2 files changed, 39 insertions(+) create mode 100644 docs/agents/domain.md create mode 100644 docs/agents/issue-tracker.md 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으로 관리한다. +인증 정보와 개인정보는 기록하지 않는다.