sodalive-ios/docs/agents/issue-tracker.md

이슈 추적: 로컬 Markdown

이 저장소의 이슈는 외부 서비스 대신 .scratch/의 Markdown 파일로 관리한다.

기본 규칙

• 기능별 디렉터리: .scratch/<feature-slug>/
• 스킬이 작성하는 사양: .scratch/<feature-slug>/spec.md
• 구현 이슈: .scratch/<feature-slug>/issues/<NN>-<slug>.md
• 이슈 번호는 01부터 시작하고, 여러 이슈를 한 파일에 합치지 않는다.
• 상태는 각 이슈 상단의 Status: 줄에 실행 스킬의 상태 규칙대로 기록한다.
• 댓글과 대화는 파일 하단의 ## Comments에 누적한다.
• 구현용 PRD와 계획/TASK 문서는 기존 docs/agent-guides/documentation-policy.md를 따른다.
• 기존 PRD나 계획이 있으면 사양과 이슈에서 해당 문서를 참조하고 내용을 중복 관리하지 않는다.

스킬 요청 해석

• 이슈 추적기에 게시: 위 경로에 Markdown 파일을 생성한다.
• 관련 티켓 조회: 전달받은 경로나 기능 내 이슈 번호에 해당하는 파일을 읽는다.

Wayfinding 작업 규칙

• 지도: .scratch/<effort>/map.md에 Notes, Decisions-so-far, Fog를 기록한다.
• 하위 티켓: issues/NN-<slug>.md에 질문과 Type:을 기록한다.
• 유형: research, prototype, grilling, task.
• 차단 관계: 상단의 Blocked by: NN, NN에 기록한다. 모든 선행 티켓이 resolved이면 차단이 해제된다.
• 다음 작업: 미해결·차단 해제·미점유 티켓 중 번호가 가장 작은 것을 선택한다.
• 점유: 작업 시작 전에 Status: claimed를 기록한다.
• 해결: ## Answer에 답을 누적하고 Status: resolved로 변경한 뒤, 지도 Decisions-so-far에 요약과 링크를 추가한다.