pr-business-docslisted
Install: claude install-skill seok-jun/agent-sdd-kit
# PR business 문서 갱신
변경된 코드를 시작점으로 실제 동작을 읽고, 오래된 business 문서를 찾아 안전하게 갱신한다.
문서 작성 기준은 [references/business-doc-rules.md](references/business-doc-rules.md), 저장소별 적응 절차는 [references/project-adaptation.md](references/project-adaptation.md)를 따른다.
## 절대 규칙
1. 코드를 읽지 않고 business 문서, 백로그, 커밋 메시지만으로 동작을 쓰지 않는다.
2. 비교 기준과 대상 문서를 먼저 출력하고 사용자 확인을 받은 뒤 초안을 작성한다.
3. 확인 전에는 business 문서를 만들거나 수정하지 않는다. 임시 파일도 만들지 않는다.
4. 사용자와 합의한 문서 밖의 파일은 만들거나 수정하지 않는다.
5. 코드 문제를 발견해도 이 Skill에서는 고치지 않고 보고만 한다.
6. SDD 문서는 이력으로 취급하며 수정하지 않는다.
7. 백로그는 선택 입력이다. 없다는 이유로 중단하지 않는다.
8. 기존 문서는 기본적으로 변경된 동작과 직접 닿은 부분만 갱신한다.
9. 전체 재작성은 이유와 범위를 설명하고 사용자 확인을 별도로 받은 경우에만 수행한다.
## Stage 0 - 대상 판정
### 0-1. 프로젝트 규칙 확인
`AGENTS.md`, `CLAUDE.md`와 저장소 문서에서 다음을 찾는다.
- 기본 브랜치와 PR 비교 방식
- business 문서 경로와 이름 규칙
- HTTP, 메시지, 배치 등 진입점 유형
- 호출 계층과 외부 호출·데이터 접근의 종료 지점
- SDD 백로그 경로와 변경 파일 섹션
명시되지 않은 값은 추측하지 말고 사용자에게 묻는다.
### 0-2. 비교 범위 확정
다음 우선순위로 비교 기준을 찾는다.
1. 사용자가 지정한 base와 작업 범위
2. 현재 PR의 base 정보
3. 원격 저장소의 기본 브랜치와 HEAD의 공통 기준점
staged, unstaged, untracked 작업이 있으면 PR diff와 별도로 표시한다. 어떤 변경을 이번 문서 갱신에 포함할지 사용자에게 확인받는다.
`master`, `main` 또는 특정 브랜치를 근거 없이 기본값으로 사용하지 않는다.
### 0-3. 동작 변경 필터
파일명이 아니라 diff의 실제 행위로 판정한다.
다음은 보통 동작 변경이다.
- 요청·응답 계약, URL, 파라미터, 고정값 변경
- 분기 조건, 호출 순서, 예외 처리 변경
- 메시지 발행·수신·재시도 변경
- 데이터 조회·저장 조건 변경
주석, 설명, 공백, 포맷만 바뀌고 실행 동작이 같으면 제외한다. 판단이 애매하면 제외하지 말고 확인 대상으로 남긴다.
### 0-4. 진입점 역추적
변경 파일에서 외부 요청을 받는 진입점까지 역참조를 따라간다.
- 진입점이 직접 바뀌었으면 해당 메서드나 핸들러를 기록한다.
- 내부 계층만 바뀌었으면 그 심볼을 호출하는 상위 계층을 찾아 진입점까지 거