docs(agents): 엔지니어링 스킬 설정 요구사항과 계획을 기록한다

docs/20261019_엔지니어링스킬설정/plan-task.md

@@ -0,0 +1,107 @@
+# 엔지니어링 스킬 문서 설정 계획
+
+| 항목 | 내용 |
+|---|---|
+| 상태 | 구현 완료 |
+| 작성일 | 2026-10-19 |
+| 요구사항 기준 | `docs/20261019_엔지니어링스킬설정/prd.md` |
+| 현재 Phase | Phase 1: 승인 설정 반영 완료 |
+| 현재 활성 Goal | 없음 |
+
+## 목표
+
+승인된 이슈 트래커 및 도메인 문서 설정을 저장소 안내 문서에 반영한다.
+
+## 시작 조건
+
+- 사용자가 설정 초안을 승인했다.
+- 변경 대상과 제외 범위가 PRD에 확정되어 있다.
+- 이 변경은 문서 전용이며 PRD와 계획 문서를 먼저 작성한다.
+
+## 범위
+
+- 포함: 승인된 `AGENTS.md` 안내 블록과 이슈 트래커·도메인 안내 문서 작성
+- 제외: 런타임 파일, `.gitignore`, 스킬 설치·활성화, triage 설정, 추가 예시 문서 및 원격 작업
+
+### Phase 1: 승인 설정 반영
+
+**결과:** 승인된 로컬 이슈 트래커와 single-context 도메인 문서 지침을 정확한 위치에 기록한다.
+
+#### Task 1.1: 선행 PRD 및 계획 문서 작성
+
+**Goal ID:** `P1-T1`
+
+- **목표:** 작업 범위, 승인 결정, 수용 기준과 검증 계획을 기록한다.
+- **시작 조건:** 필수 작업 가이드와 샘플 문서를 읽는다.
+- **정확한 파일:** `docs/20261019_엔지니어링스킬설정/prd.md`, `docs/20261019_엔지니어링스킬설정/plan-task.md`
+- **완료 증거:** 두 문서가 존재하고 승인 범위와 검증 책임이 서로 일치한다.
+- **범위 밖:** 설정 블록 및 안내 파일 작성.
+- **TDD 예외 사유:** 요구사항·계획 문서 작성은 실행 동작을 변경하지 않는다.
+- **대체 검증 방법:** 문서 파일과 경로를 읽어 내용 및 계획 형식을 확인한다.
+
+- [x] **Task 1.1: 선행 PRD 및 계획 문서 작성**
+
+#### Task 1.2: 승인된 설정 반영
+
+**Goal ID:** `P1-T2`
+
+- **목표:** 승인된 로컬 이슈 트래커와 도메인 문서 읽기 규칙을 반영한다.
+- **시작 조건:** `P1-T1` 완료 및 사용자 초안 승인.
+- **정확한 파일:** `AGENTS.md`, `docs/agents/issue-tracker.md`, `docs/agents/domain.md`
+- **완료 증거:** 승인 초안과 파일 본문이 일치하고 기존 `AGENTS.md` 내용이 보존된다.
+- **범위 밖:** 예시 이슈, 실제 용어집·ADR 생성, triage 설정, 원격 저장소 변경.
+- **TDD 예외 사유:** 문서 전용 설정이며 애플리케이션 실행 동작을 변경하지 않는다.
+- **대체 검증 방법:** 세 파일을 직접 읽고 승인 초안 및 `git diff -- AGENTS.md`와 대조한다.
+
+- [x] **Task 1.2: 승인된 설정 반영**
+
+#### Phase 1 Gate
+
+**Goal ID:** `P1-GATE`
+
+- **목표:** 다섯 파일이 승인 초안과 PRD 범위에 맞게 작성됐는지 검증한다.
+- **시작 조건:** `P1-T1`, `P1-T2` 완료.
+- **정확한 파일:** `AGENTS.md`, `docs/agents/issue-tracker.md`, `docs/agents/domain.md`, `docs/20261019_엔지니어링스킬설정/prd.md`, `docs/20261019_엔지니어링스킬설정/plan-task.md`
+- **완료 증거:** 부모 실행자가 diff 공백 검사, 문서·참조 확인, Gradle task 목록 확인을 수행하고 결과를 기록한다.
+- **범위 밖:** 전체 회귀 테스트 및 문서 외 파일 변경.
+- **TDD 예외 사유:** 문서 전용 설정이라 자동화된 실패 테스트를 추가하지 않는다.
+- **대체 검증 방법:** `git diff --check`, 변경 파일·문서 참조 대조, `./gradlew tasks --all` 실행 결과를 확인한다.
+- **회귀 범위:** 전체 회귀는 문서 전용 변경에 필요하지 않다.
+
+- [x] **Phase 1 Gate: 설정 및 문서 검증**
+
+## 진행 기록
+
+- `P1-T1`: 필수 선행 문서 작성 완료. 이 기록은 파일 생성 확인에 한하며 설정 검증은 뜻하지 않는다.
+- `P1-GATE`: 부모 실행자 검증 대기. 미실행 검사는 완료로 기록하지 않는다.
+
+### P1-T1 / P1-T2 검토 및 보정 - 2026-10-19
+
+- 무엇을: 다섯 대상 파일을 읽고 승인 초안과 대조했다. 누락된 설정 반영 Task를 명시하고 초안 외 내부 주석을 제거했다.
+- 왜: 실제 설정 작업의 추적성을 확보하고 승인된 문서 내용만 유지하기 위해서다.
+- 어떻게: `git diff -- AGENTS.md`에서 기존 본문 변경 없이 안내 블록만 추가된 것을 확인했다.
+- 결과: PRD·계획 경로와 안내 문서 참조가 일치하며 `P1-GATE` 최종 검증은 별도로 수행한다.
+
+### P1-GATE 검증 - 2026-10-19
+
+- 무엇을: 승인된 다섯 문서의 내용·참조·변경 범위와 Gradle 명령 유효성을 검증했다.
+- 왜: 원격 저장소에 종속되지 않는 설정을 유지하고 기존 작업 절차에 영향을 주지 않는지 확인하기 위해서다.
+- `git diff --check`: 종료 코드 0, 추적 파일 공백 오류 없음.
+- 신규 네 파일에 각각 `git diff --no-index --check /dev/null "$file"`: 종료 코드 0, 공백 오류 없음.
+- 신규 파일 검사 첫 시도는 zsh 특수 변수 `path`를 반복 변수로 사용해 `git` 탐색에 실패했다.
+  반복 변수를 `file`로 수정한 뒤 같은 검사에 통과했으며, 파일 내용이나 Git 설정은 변경하지 않았다.
+- `test` 및 `rg` 검사: 종료 코드 0. 필수 파일 존재, `Agent skills` 블록 1개,
+  triage 설정·`CLAUDE.md`·빈 `.scratch/` 및 내부 주석 미생성을 확인했다.
+- `git status --short --untracked-files=all`: 승인된 다섯 Markdown 파일만 변경·생성됐다.
+- `git check-ignore -v --no-index .scratch/skill-setup/issues/01-example.md`: 종료 코드 1,
+  일치하는 ignore 규칙 없음. 실제 예시 파일은 만들지 않았다.
+- `./gradlew tasks --all`: 종료 코드 0, `BUILD SUCCESSFUL`. 기존 Gradle 9.0 비호환 deprecated 기능 경고는 유지된다.
+- Markdown 전용 변경으로 언어 서버 진단 대상 코드는 없으며, 별도 LSP 진단 도구는 제공되지 않았다.
+- 전체 테스트·빌드는 실행하지 않았다. 실행 코드·의존성·빌드 설정 변경이 없어 위 문서 검사와 Gradle task 목록 확인으로 검증했다.
+- 결과: `P1-T1`, `P1-T2`, `P1-GATE` 완료. 커밋·푸시 및 원격 설정 변경 없음.
+
+### 별도 문서 검토 - 2026-10-19
+
+- 최초 검토는 지원되지 않는 모델 오류로 실행되지 않아 사용 가능한 문서 검토 경로로 재시도했다.
+- 재검토 결과: 중대한 지적 사항 없음. 승인 범위, 기존 `AGENTS.md` 보존, PRD·계획 규칙과의 일치를 확인했다.
+- 검토자는 파일과 diff만 확인했으며 Gradle·공백 검사는 위 실행 결과를 기준으로 했다.

docs/20261019_엔지니어링스킬설정/prd.md

@@ -0,0 +1,43 @@
+# 엔지니어링 스킬 문서 설정 PRD
+
+## 문서 정보
+
+| 항목 | 내용 |
+|---|---|
+| 상태 | 구현 완료 |
+| 작성일 | 2026-10-19 |
+| 최종 수정일 | 2026-10-19 |
+| 대상 | 엔지니어링 스킬용 저장소 문서 설정 |
+| 관련 계획 | `docs/20261019_엔지니어링스킬설정/plan-task.md` |
+
+## 목표와 배경
+
+원격 저장소 변경에 의존하지 않는 로컬 Markdown 이슈 관리 규칙과 single-context 도메인 문서 안내를 기록한다. 기존 `AGENTS.md`에 승인된 안내를 추가해 스킬이 저장소의 기준 문서를 찾을 수 있게 한다.
+
+## 확정 요구사항
+
+- 이슈 트래커는 `.scratch/<feature-slug>/issues/`의 로컬 Markdown으로 지정한다. 원격 저장소가 변경될 예정이므로 원격 이슈 트래커를 기준으로 삼지 않는다.
+- 도메인 문서 구성은 single-context로 안내하며 루트 `GLOSSARY.md`와 `docs/adr/`를 참조한다.
+- 루트 `AGENTS.md` 끝에 승인된 `Agent skills` 블록을 추가하고, `docs/agents/issue-tracker.md`와 `docs/agents/domain.md`에 규칙을 기록한다.
+- 이 설정을 위한 PRD 및 계획 문서를 기존 날짜 디렉터리 규칙에 따라 함께 둔다.
+
+## 수용 기준
+
+- 승인된 설정 내용과 다섯 개의 정확한 대상 파일만 변경된다.
+- 기존 `AGENTS.md` 내용은 바이트 단위로 보존되고 승인 블록만 추가된다.
+- 요구사항 문서와 계획 문서의 경로, 파일 지침, 검증 계획이 서로 일치한다.
+- 검증 미수행 항목을 성공으로 기록하지 않는다.
+
+## 제외 범위
+
+- 애플리케이션·런타임 코드, `.gitignore`, 의존성, 테스트 변경
+- triage 라벨 및 triage 스킬 설정
+- `GLOSSARY.md`, `GLOSSARY-MAP.md`, `docs/adr/`, `.scratch/`나 예시 이슈 생성
+- 스킬 설치·활성화, 원격 서비스 사용, Git 변경
+
+## 결정 기록
+
+| 날짜 | 결정 | 근거 |
+|---|---|---|
+| 2026-10-19 | 이슈 관리는 로컬 Markdown으로 설정 | 원격 저장소 변경에 의존하지 않으며 사용자가 전체 초안을 승인함 |
+| 2026-10-19 | 도메인 문서는 single-context로 안내 | 단일 루트 프로젝트이며 승인된 구성임 |