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`로 변경한 뒤 + 지도에 결론 요약과 티켓 링크를 기록한다.