docs(agents): 스킬 설정 요구사항과 검증 결과를 기록한다

This commit is contained in:
2026-10-19 13:45:43 +09:00
parent d4a468027d
commit 705ee72b5d
2 changed files with 194 additions and 0 deletions
@@ -0,0 +1,57 @@
# 엔지니어링 스킬 로컬 설정 PRD
## 문서 정보
| 항목 | 내용 |
|---|---|
| 문서 상태 | 구현 완료 |
| 작성일 | 2026-10-19 |
| 대상 | SodaLive 엔지니어링 스킬 저장소 설정 |
| 결정권자 | 저장소 사용자 |
| 관련 구현 계획 | [plan-task.md](plan-task.md) |
| 관련 API Contract·review | 해당 없음: 문서 설정만 변경 |
## 1. Overview
엔지니어링 스킬이 이슈 관리 위치와 도메인 문서 읽기 규칙을 일관되게 찾도록 저장소 설정 문서를 추가한다. 사용자는 로컬 Markdown을 선택하고 설정 초안을 승인했다.
## 2. Goals
- 루트 `AGENTS.md`에서 이슈·도메인 설정 문서로 연결한다.
- 기존 PRD·계획 작성 절차를 유지하며 로컬 이슈 관리 규칙을 추가한다.
- single-context 도메인 문서를 필요한 시점에만 생성하도록 안내한다.
## 3. Non-Goals
- 앱 코드, Gradle 설정, 의존성, 비밀 파일 변경.
- 원격 이슈 생성, 스킬 설치, triage 라벨 설정, 커밋·푸시.
- 예시 이슈와 빈 `.scratch/`, `GLOSSARY.md`, `docs/adr/` 생성.
- UI·기기 검증과 앱 전체 회귀 테스트.
## 4. 기능 요구사항
| ID | 상태 | 요구사항 | 수용 기준 | 연결 |
|---|---|---|---|---|
| SETUP-001 | 확정 | `AGENTS.md`에 `Agent skills` 안내 추가 | 이슈·도메인 설정 두 문서로 연결하고 기존 지침 보존 | P1-T1 |
| SETUP-002 | 확정 | 로컬 Markdown 이슈 규칙 설정 | 기능별 `.scratch/` 아래 개별 번호 티켓, 상태·댓글·Wayfinder 규칙 명시 | P1-T1 |
| SETUP-003 | 확정 | 기존 PRD·계획 경로 유지 | 정식 문서는 `docs/YYYYMMDD_작업명/`, 필요한 `spec.md`는 PRD 참조만 제공 | P1-T1 |
| SETUP-004 | 확정 | single-context 소비 규칙 설정 | 용어집·관련 ADR 읽기, 부재 시 조용히 진행, 필요 시 생성, 용어 준수·ADR 충돌 명시 | P1-T1 |
| SETUP-005 | 확정 | 관련 가이드 동기화와 검증 기록 | 작업 가이드 교차 참조, 문서 검사 및 Gradle 명령 결과를 계획에 기록 | P1-GATE |
## 5. 성공 기준
- 설정 문서가 승인된 초안과 일치하고 `triage-labels.md`를 참조하지 않는다.
- 기존 PRD·계획 작성 규칙과 충돌하거나 내용을 중복 관리하지 않는다.
- 여섯 Markdown 파일만 변경하며 검증의 실제 결과·제한을 남긴다.
## 6. Open Questions
미결 사항 없음.
## 7. Decision Log
| 날짜 | ID | 상태 | 결정 | 근거 |
|---|---|---|---|---|
| 2026-10-19 | DEC-001 | 확정 | 로컬 Markdown 이슈 관리 | 사용자의 명시적 선택 |
| 2026-10-19 | DEC-002 | 확정 | 기존 PRD·계획 보존 및 single-context 적용 | 사용자가 초안 승인 후 진행 요청 |
| 2026-10-19 | DEC-003 | 확정 | 문서 전용 TDD 예외, 정합성 검사로 대체 | 실행 로직 변경 없음, 저장소 문서 Task 예외 규칙 |