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

This commit is contained in:
2026-10-19 13:45:26 +09:00
parent 66e066cac7
commit 6eb0afb587
2 changed files with 42 additions and 0 deletions
+30
View File
@@ -0,0 +1,30 @@
# 이슈 트래커: 로컬 Markdown
이 저장소의 이슈는 `.scratch/` 아래에서 관리한다.
## 파일 규칙
- 기능별 디렉터리: `.scratch/<feature-slug>/`
- 이슈: `issues/<NN>-<slug>.md`. 번호는 `01`부터 시작한다.
- 이슈마다 파일 하나를 사용하며 여러 이슈를 한 파일에 합치지 않는다.
- 상태는 각 이슈 상단의 `Status:`에 기록한다.
- 대화와 후속 기록은 하단의 `## Comments`에 누적한다.
## 기존 작업 문서와의 관계
- PRD와 계획/TASK는 기존 `docs/YYYYMMDD_작업명/` 규칙을 따른다.
- 이슈에는 해당 `prd.md`, `plan-task.md`의 링크를 남긴다.
- 스킬이 `spec.md`를 요구하면 `.scratch/<feature-slug>/spec.md`에서
기존 PRD를 참조한다. PRD 내용을 별도 사본으로 중복 관리하지 않는다.
## 스킬의 읽기·쓰기
- 이슈 게시: 해당 기능의 `issues/` 아래에 개별 파일을 만든다.
- 이슈 조회: 사용자가 지정한 경로나 번호에 해당하는 파일을 읽는다.
- 필요한 디렉터리는 실제 이슈를 생성할 때 만든다.
## Wayfinder 사용 시
- 지도는 `.scratch/<effort>/map.md`, 티켓은 `issues/NN-<slug>.md`다.
- 티켓 종류는 `Type: research/prototype/grilling/task` 중 하나다.
- 의존성은 `Blocked by: NN, NN`으로 기록한다.
- 선행 티켓이 모두 `resolved`인 미해결·미점유 티켓을 번호순으로 선택한다.
- 작업 전 `Status: claimed`로 저장한다.
- 해결 시 `## Answer`에 답을 누적하고 `Status: resolved`로 변경한 뒤
지도에 결론 요약과 티켓 링크를 기록한다.