docs(agents): 로컬 이슈와 도메인 문서 규칙을 추가한다
This commit is contained in:
@@ -0,0 +1,12 @@
|
||||
# 도메인 문서
|
||||
|
||||
## 구조와 읽기 규칙
|
||||
- single-context: 루트 `GLOSSARY.md`와 `docs/adr/`를 사용한다.
|
||||
- 코드 탐색 전에 용어집과 작업 영역에 관련된 ADR을 읽는다.
|
||||
- 문서가 없으면 별도 경고나 생성 제안 없이 진행한다.
|
||||
- 용어와 결정이 실제로 정리될 때 `domain-modeling` 스킬로 생성한다.
|
||||
|
||||
## 용어와 결정
|
||||
- 이슈·설계·테스트의 도메인 용어는 용어집의 정의를 따른다.
|
||||
- 필요한 용어가 없으면 기존 표현을 확인하고 실제 공백은 기록한다.
|
||||
- 기존 ADR과 충돌하는 제안은 해당 ADR과 재검토 이유를 명시한다.
|
||||
@@ -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`로 변경한 뒤
|
||||
지도에 결론 요약과 티켓 링크를 기록한다.
|
||||
Reference in New Issue
Block a user