ADHD PR 설명
이 리포지토리의 기본 PR 본문 형식입니다. 검토자는 설명을 한눈에 파악할 수 있어야 합니다. diff는 이미 GitHub에 올라와 있으므로 파일 이동을 다시 설명하지 마세요.
에이전트: Nakama PR 설명을 작성하거나 재작성할 때( ce-commit-push-pr를 통한 경우 포함) 이 스킬을 로드하세요. 본문의 형태는 여기서 가져오지만, 실제 주장(diff의 결과, 위험, 검증 사항)은 diff에서 수집하세요.
형식 (필수)
## Summary
<한 줄: 누가 무엇을 → 결과. 변경 사항이 전문 용어가 아니라면 모호한 표현은 피하세요.>
**Before:** <한 줄 — 이전 동작 또는 비용>
**After:** <한 줄 — 새 동작; 위험 평가에 도움이 된다면 주요 함수/경로를 명시하세요>
Why safe:
1. <이유>
2. <이유>
3. <이유> <!-- 최대 2~3개; 할 말이 없으면 #3은 생략 -->
Only re-add / follow up if <하나의 잔여 위험 또는 롤백 트리거>.
## Test plan
- [x] <이미 실행한 명령어> (<N> 통과)
- [ ] <사람이 2분 내로 할 수 있는 수동 확인 한 가지>
테스트 계획 뒤에 선택 사항 (워크플로에서 Compound Engineering 배지를 기대하는 경우 유지):
---
[](https://github.com/EveryInc/compound-engineering-plugin)
규칙
- 첫 줄 = 결과. Summary 첫 줄은 새로운 세상이어야 하며, "이 PR은 …을 제거합니다"가 아닙니다.
- Before/After = 두 줄. 굵은 레이블. 단락으로 감싸지 마세요.
- Why safe = 번호, ≤3개. 본문 전체에 최대 5개; 더 많으면 결정을 바꾸는 것만 남기세요.
- 하나의 잔여 위험. 이 변경을 되돌리게 할 경우를 명시하세요. 정말 없다면 생략.
- diff 관광 금지. 파일, 라인 수를 이야기로 나열하지 마세요. "내보내기도 정리함"도 위험이 아닌 한 쓰지 마세요.
- 테스트 계획 = 실행 가능. 통과 횟수가 있는 체크된 명령어를 선호; 하나의 체크되지 않은 수동 확인.
- 제목은 관행 유지.
type(scope): imperative— 짧게. 본문이 이 형태를 담고 제목에는 이모지나 에세이가 필요하지 않습니다. gh로 적용. 본문을 임시 파일에 쓰고;gh pr edit <n> --body-file …또는gh pr create --body-file …. 절대--body "$(cat …)"를 사용하지 마세요.
완벽한 예시
이 밀도를 따르세요:
## Summary
조직 기억 제안 승인 → bullet이 `MEMORY.md`에 추가됩니다. LLM 호출 없음.
**Before:** 결정적 병합 후 선택적으로 전체 파일을 모델로 재작성.
**After:** 결정적 병합만 (`applyApprovedOrgMemoryBullet`).
Why safe:
1. 중복 제거 + 대체가 이미 해당 함수에 있음
2. LLM 경로가 이미 결정적 결과로 실패 종료됨
3. −230줄, 동일한 승인 결과
Only re-add an LLM rewrite if contradictory bullets start surviving approve.
## Test plan
- [x] `bun test packages/agent/src` (80 통과)
- [x] `bun test apps/server/src/services/org-memory-service.test.ts` (15 통과)
- [ ] 보류 중인 제안 하나 승인 (고정 + 최근 로그) — bullet이 이전처럼 추가됨
안티패턴
| 하지 마세요 | 하세요 |
|---|---|
| 여러 단락의 Summary | 결과 한 줄 + Before/After + Why safe |
| "이 PR은 …을 목표로 합니다" / "…하기 위해" | 동사 또는 사용자 행동으로 시작 |
Summary 아래 중첩된 ### | ## Summary + ## Test plan만 평면적으로 |
| 삭제된 모든 파일 다시 나열 | 잔여 위험만 |
| 모호한 "테스트 통과" | 정확한 명령어 + 통과 횟수 |
워크플로
- PR diff / 커밋 읽기 (
gh pr view,git diff base...HEAD) - 이름: 결과, before, after, ≤3개의 why-safe, 하나의 잔여 위험
- 템플릿 채우기 — diff가 이미 증명하는 문장은 자르기
--body-file을 통해 적용- PR URL로 응답 (필요한 경우에만 "제목을 다듬길 원하면 말씀해 주세요" 추가)