8.0 KiB
엔지니어링 스킬 로컬 설정 구현 계획
| 문서 항목 | 내용 |
|---|---|
| 상태 | 구현 완료 |
| 작성일 | 2026-10-19 |
| 요구사항 기준 | 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 계약을 제공한다.
- 샘플과 기존 지침을 확인하고 PRD·계획을 먼저 작성한다.
- 이슈·도메인 설정 문서를 승인된 초안대로 작성한다.
AGENTS.md에 중복 없는Agent skills블록을 추가한다.- 작업 가이드에 기존 PRD·계획 규칙을 보존하는 교차 참조를 추가한다.
- 설정 문서의 요구사항별 문구·경로를 검색하여 확인한다.
검증 기록:
- 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 검증, 관련 없는 환경 수정.
-
rg -n 'Agent skills|docs/agents/(issue-tracker|domain)\.md' AGENTS.md docs/agent-guides/work-plan-docs.md로 참조를 확인한다. -
설정 두 문서의 실제 내용을 재읽고 경로·상태·도메인 규칙을 확인한다.
-
git diff --check,git status --short로 공백 오류와 여섯 파일 범위를 확인한다. -
./gradlew tasks --all을 실행하고 결과를 기록한다. 환경 실패는 문서 검증과 구분한다. -
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·기기 검증은 실행하지 않았다. 이슈 생성, 스킬 설치, 원격 설정 변경, 커밋·푸시는 하지 않았다.