Files
sodalive-android/docs/agents/issue-tracker.md
T

1.6 KiB

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