# 엔지니어링 스킬 로컬 설정 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 예외 규칙 |