From 22c07191d576328f2d317a00063ff29fd744169a Mon Sep 17 00:00:00 2001 From: Klaus Date: Mon, 19 Oct 2026 13:45:19 +0900 Subject: [PATCH] =?UTF-8?q?docs(agents):=20=EC=97=94=EC=A7=80=EB=8B=88?= =?UTF-8?q?=EC=96=B4=EB=A7=81=20=EC=8A=A4=ED=82=AC=20=EC=84=A4=EC=A0=95=20?= =?UTF-8?q?=EC=9A=94=EA=B5=AC=EC=82=AC=ED=95=AD=EA=B3=BC=20=EA=B3=84?= =?UTF-8?q?=ED=9A=8D=EC=9D=84=20=EA=B8=B0=EB=A1=9D=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/20261019_엔지니어링스킬설정/plan-task.md | 107 ++++++++++++++++++ docs/20261019_엔지니어링스킬설정/prd.md | 43 +++++++ 2 files changed, 150 insertions(+) create mode 100644 docs/20261019_엔지니어링스킬설정/plan-task.md create mode 100644 docs/20261019_엔지니어링스킬설정/prd.md diff --git a/docs/20261019_엔지니어링스킬설정/plan-task.md b/docs/20261019_엔지니어링스킬설정/plan-task.md new file mode 100644 index 00000000..5a28d0c2 --- /dev/null +++ b/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·공백 검사는 위 실행 결과를 기준으로 했다. diff --git a/docs/20261019_엔지니어링스킬설정/prd.md b/docs/20261019_엔지니어링스킬설정/prd.md new file mode 100644 index 00000000..efdf4bba --- /dev/null +++ b/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//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로 안내 | 단일 루트 프로젝트이며 승인된 구성임 |