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

엔지니어링 스킬 문서 설정 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로 안내	단일 루트 프로젝트이며 승인된 구성임