docs(agents): 이슈 추적과 도메인 문서 규칙을 정한다

This commit is contained in:
Yu Sung
2026-10-19 13:44:54 +09:00
parent 81d6a495d7
commit ffa6ff0d22
3 changed files with 53 additions and 0 deletions
+29
View File
@@ -0,0 +1,29 @@
# 이슈 추적: 로컬 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에 요약과 링크를 추가한다.