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

엔지니어링 스킬 문서 설정 계획

항목	내용
상태	구현 완료
작성일	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 예외 사유: 요구사항·계획 문서 작성은 실행 동작을 변경하지 않는다.

• 대체 검증 방법: 문서 파일과 경로를 읽어 내용 및 계획 형식을 확인한다.

• 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와 대조한다.

• 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 실행 결과를 확인한다.

• 회귀 범위: 전체 회귀는 문서 전용 변경에 필요하지 않다.

• 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·공백 검사는 위 실행 결과를 기준으로 했다.