From 6eb0afb587a9ab1c119e2a0cbc4f5d625cae8ede Mon Sep 17 00:00:00 2001 From: klaus Date: Mon, 19 Oct 2026 13:45:26 +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=B7=9C=EC=B9=99=EC=9D=84=20=EC=B6=94=EA=B0=80?= =?UTF-8?q?=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 | 12 ++++++++++++ docs/agents/issue-tracker.md | 30 ++++++++++++++++++++++++++++++ 2 files changed, 42 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..d2747e2c --- /dev/null +++ b/docs/agents/domain.md @@ -0,0 +1,12 @@ +# 도메인 문서 + +## 구조와 읽기 규칙 +- single-context: 루트 `GLOSSARY.md`와 `docs/adr/`를 사용한다. +- 코드 탐색 전에 용어집과 작업 영역에 관련된 ADR을 읽는다. +- 문서가 없으면 별도 경고나 생성 제안 없이 진행한다. +- 용어와 결정이 실제로 정리될 때 `domain-modeling` 스킬로 생성한다. + +## 용어와 결정 +- 이슈·설계·테스트의 도메인 용어는 용어집의 정의를 따른다. +- 필요한 용어가 없으면 기존 표현을 확인하고 실제 공백은 기록한다. +- 기존 ADR과 충돌하는 제안은 해당 ADR과 재검토 이유를 명시한다. diff --git a/docs/agents/issue-tracker.md b/docs/agents/issue-tracker.md new file mode 100644 index 00000000..cb26ac51 --- /dev/null +++ b/docs/agents/issue-tracker.md @@ -0,0 +1,30 @@ +# 이슈 트래커: 로컬 Markdown + +이 저장소의 이슈는 `.scratch/` 아래에서 관리한다. + +## 파일 규칙 +- 기능별 디렉터리: `.scratch//` +- 이슈: `issues/-.md`. 번호는 `01`부터 시작한다. +- 이슈마다 파일 하나를 사용하며 여러 이슈를 한 파일에 합치지 않는다. +- 상태는 각 이슈 상단의 `Status:`에 기록한다. +- 대화와 후속 기록은 하단의 `## Comments`에 누적한다. + +## 기존 작업 문서와의 관계 +- PRD와 계획/TASK는 기존 `docs/YYYYMMDD_작업명/` 규칙을 따른다. +- 이슈에는 해당 `prd.md`, `plan-task.md`의 링크를 남긴다. +- 스킬이 `spec.md`를 요구하면 `.scratch//spec.md`에서 + 기존 PRD를 참조한다. PRD 내용을 별도 사본으로 중복 관리하지 않는다. + +## 스킬의 읽기·쓰기 +- 이슈 게시: 해당 기능의 `issues/` 아래에 개별 파일을 만든다. +- 이슈 조회: 사용자가 지정한 경로나 번호에 해당하는 파일을 읽는다. +- 필요한 디렉터리는 실제 이슈를 생성할 때 만든다. + +## Wayfinder 사용 시 +- 지도는 `.scratch//map.md`, 티켓은 `issues/NN-.md`다. +- 티켓 종류는 `Type: research/prototype/grilling/task` 중 하나다. +- 의존성은 `Blocked by: NN, NN`으로 기록한다. +- 선행 티켓이 모두 `resolved`인 미해결·미점유 티켓을 번호순으로 선택한다. +- 작업 전 `Status: claimed`로 저장한다. +- 해결 시 `## Answer`에 답을 누적하고 `Status: resolved`로 변경한 뒤 + 지도에 결론 요약과 티켓 링크를 기록한다.