# 이슈 트래커: 로컬 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`로 변경한 뒤 지도에 결론 요약과 티켓 링크를 기록한다.