# 엔지니어링 스킬 로컬 설정 구현 계획 | 문서 항목 | 내용 | |---|---| | 상태 | 구현 완료 | | 작성일 | 2026-10-19 | | 요구사항 기준 | [prd.md](prd.md) | | API 기준 | 해당 없음 | | 현재 Phase | 1: 저장소 문서 설정 | | 현재 활성 작업 | 없음 | ## 목표 엔지니어링 스킬이 로컬 이슈 위치와 도메인 문서 규칙을 찾고 기존 작업 절차를 유지할 수 있다. ## 현재 상태 | Phase | 상태 | 완료 Task | 활성/다음 작업 | 차단 조건 | |---|---|---|---|---| | 1 | 완료 | 1/1 | 없음 | 없음 | ## 범위와 기술적 제약 - 포함: 승인된 설정 문서, 작업 문서 두 개, 관련 가이드 교차 참조. - 제외: 앱·빌드 설정 변경, 원격 작업, 라벨 설정, 빈 도메인 문서·이슈 생성, 커밋. - 기존 문서의 내용·경로·완료 기록을 보존한다. - 기술 스택: Markdown, 검증용 `rg`·비파괴 Git 명령·Gradle task 목록 조회. - 문서 외 실행 로직을 추가하지 않으며 기기·UI 검증은 하지 않는다. ## Phase 1 **Phase 결과:** 승인된 로컬 이슈·single-context 설정을 저장소 지침에서 읽을 수 있다. **선행조건:** 사용자의 로컬 Markdown 선택과 초안 승인. ### 구현 항목 #### Task 1.1 로컬 설정 문서 반영 **작업 ID `P1-T1`:** 기존 작업 절차를 유지하면서 승인된 설정 문서를 연결한다. - **시작 조건:** 이 PRD와 계획 준비 완료. - **완료 증거:** 아래 체크리스트 및 요구사항별 문서 검색 결과. - **범위 밖:** 앱 코드·설정과 실제 이슈 생성. - **TDD 예외 사유:** 실행 로직을 변경하지 않는 문서 전용 Task다. - **대체 검증 방법:** 파일 재읽기, `rg` 경로·문구 검사, `git diff --check`와 변경 파일 확인. **Files:** - Create: `docs/20261019_엔지니어링_스킬_로컬_설정/prd.md`, `plan-task.md`. - Create: `docs/agents/issue-tracker.md`, `docs/agents/domain.md`. - Modify: `AGENTS.md`, `docs/agent-guides/work-plan-docs.md`. **Interfaces:** 승인된 초안과 기존 PRD 규칙을 입력으로 받아, `AGENTS.md`에서 두 설정 문서를 참조하는 Markdown 계약을 제공한다. - [x] 샘플과 기존 지침을 확인하고 PRD·계획을 먼저 작성한다. - [x] 이슈·도메인 설정 문서를 승인된 초안대로 작성한다. - [x] `AGENTS.md`에 중복 없는 `Agent skills` 블록을 추가한다. - [x] 작업 가이드에 기존 PRD·계획 규칙을 보존하는 교차 참조를 추가한다. - [x] 설정 문서의 요구사항별 문구·경로를 검색하여 확인한다. **검증 기록:** - 2026-10-19: `AGENTS.md`, 문서 샘플 두 개, 작업 가이드, `.gitignore`를 읽었다. 앞선 탐색에서 기존 설정 문서와 triage 스킬이 없는 것을 확인했고 사용자가 초안을 승인했다. - 2026-10-19: 설정 네 문서를 재읽고 `rg -n 'Agent skills|docs/agents/(issue-tracker|domain)\.md|docs/agents/' AGENTS.md docs/agent-guides/work-plan-docs.md`로 안내와 참조를 확인했다. `rg -n '\.scratch/|issues/|Status:|Comments|spec\.md|prd\.md|plan-task\.md|single-context|GLOSSARY\.md|docs/adr/|ADR|domain-modeling' docs/agents`로 요구사항 문구를 확인했다. 두 명령 모두 종료 코드 0이며 기존 지침 수정 없이 안내만 추가했다. ### Phase 1 Gate **작업 ID `P1-GATE`:** 문서 정합성과 변경 범위를 판정하고 실제 검증 결과를 남긴다. - **시작 조건:** P1-T1의 설정 문서 반영 완료. - **완료 증거:** 아래 검사 실행 결과와 최하단 Verification Log. - **범위 밖:** 앱 전체 회귀·빌드·UI 검증, 관련 없는 환경 수정. - [x] `rg -n 'Agent skills|docs/agents/(issue-tracker|domain)\.md' AGENTS.md docs/agent-guides/work-plan-docs.md`로 참조를 확인한다. - [x] 설정 두 문서의 실제 내용을 재읽고 경로·상태·도메인 규칙을 확인한다. - [x] `git diff --check`, `git status --short`로 공백 오류와 여섯 파일 범위를 확인한다. - [x] `./gradlew tasks --all`을 실행하고 결과를 기록한다. 환경 실패는 문서 검증과 구분한다. - [x] Markdown 진단 도구 제공 여부와 생략한 검증을 기록한다. ## 실행 순서 PRD·계획 준비 → P1-T1 → P1-GATE. 단일 작업 흐름으로 진행한다. ## Progress ### P1-T1 1차 실행: 2026-10-19 - 상태: 진행 중. - 무엇을: 승인된 요구사항과 여섯 파일 범위를 PRD·계획에 기록했다. - 왜: 설정 변경 전에 작업 문서를 준비하는 저장소 규칙을 준수한다. - 어떻게: 사용자 승인 초안과 기존 지침·문서 샘플을 대조했다. - 남은 항목: 설정 네 문서 반영과 검증. - 다음 행동: 승인된 설정 문서를 작성한다. ### P1-T1 2차 실행: 2026-10-19 - 상태: 완료. - 무엇을: 승인된 설정 네 문서를 반영하고 PRD 중복 방지와 도메인 지연 생성 규칙을 확인했다. - 왜: SETUP-001~004 및 관련 가이드 동기화를 충족한다. - 어떻게: 설정 문서 재읽기, 요구사항별 `rg` 검색, 기존 두 파일의 Git diff 대조. - 남은 항목: 없음. - 다음 행동: P1-GATE 통합 검증 기록. ### P1-GATE 1차 실행: 2026-10-19 - 상태: 완료. - 무엇을: 설정·경로·공백·변경 범위와 Gradle 명령을 검증했다. - 왜: SETUP-005의 실제 완료 증거를 남긴다. - 어떻게: 아래 Verification Log의 명령과 결과를 기록했다. - 남은 항목: 없음. Markdown LSP 검증 제한은 아래에 명시한다. - 다음 행동: 결과 보고. 커밋하지 않는다. ## Decision Log | 날짜 | ID | 상태 | 결정 | 근거 | |---|---|---|---|---| | 2026-10-19 | DEC-001 | 확정 | 사용자 승인 초안을 변경 없이 반영하고 관련 가이드만 동기화 | PRD SETUP-001~005 | | 2026-10-19 | DEC-002 | 확정 | 자동 테스트 추가 대신 문서 검색·차이·Gradle task 조회 | 문서 전용 TDD 예외 | ## Verification Log 아직 최종 검증을 실행하지 않았다. ### 최종 검증: 2026-10-19 - 위 문장은 초기 상태 기록이다. 아래 검증을 실행하여 문서 설정 작업을 완료했다. - `rg` 참조·요구사항 검색: 종료 코드 0. Agent skills 블록 한 개와 설정 문서 두 개, 관련 가이드 교차 참조를 확인했다. - 셸 `test` 검사: 설정·작업 문서 존재, Agent skills 블록 한 개, 불필요한 라벨 문서·빈 이슈·도메인 파일 부재를 확인했다. 초기 검색은 PRD의 라벨 참조 금지 문구까지 포함해 일치했으므로 설정 문서만 대상으로 좁혀 재실행했고 종료 코드 0이다. - `rg` 부정 검색: 설정 문서의 존재하지 않는 라벨 문서 참조가 없고, 여섯 Markdown 파일에 줄 끝 공백과 도구 내부 표식이 없는 것을 확인했다. 부정 검색을 포함한 셸 검증 종료 코드 0. - `git diff --check`: 종료 코드 0, 공백 오류 없음. 미추적 파일은 별도 파일 재읽기와 `rg` 공백 검사로 확인했다. - `git -c core.quotePath=false status --short --untracked-files=all`: 기존 문서 수정 2개, 신규 문서 4개, 계획한 여섯 Markdown 파일만 변경했다. - `git diff -- AGENTS.md docs/agent-guides/work-plan-docs.md`: 기존 지침 제거·변경 없이 Agent skills 블록과 가이드 안내만 추가했다. - `./gradlew tasks --all`: 종료 코드 0, `BUILD SUCCESSFUL in 17s`, `1 actionable task: 1 executed`. 이 명령은 task 목록 조회이며 앱 컴파일이나 테스트 통과를 뜻하지 않는다. - 관찰: Gradle 9.0과 호환되지 않는 deprecated feature 경고가 출력됐다. 이번 Markdown 변경과 무관한 빌드 환경 경고이며 수정하지 않았다. - Markdown LSP: 현재 도구에 `lsp_diagnostics`가 없어 실행하지 못했다. 문서 검색·파일 검사 결과와 별도로 이 제한을 남긴다. - 생략: 문서 전용 변경으로 앱 전체 회귀·빌드·UI·기기 검증은 실행하지 않았다. 이슈 생성, 스킬 설치, 원격 설정 변경, 커밋·푸시는 하지 않았다.