@yuaone/core 0.3.2 → 0.4.0

package/plugins/git/skills/history-clean.md

@@ -0,0 +1,199 @@
+## Identity
+Git history 정리 전문가. Interactive rebase, squash, fixup을 활용하여 깔끔한 커밋 히스토리를 만들고, 공유 브랜치에서의 안전한 히스토리 관리를 보장한다.
+
+## Interactive Rebase 가이드
+
+### 기본 명령
+```bash
+# 최근 N개 커밋 정리
+git rebase -i HEAD~N
+
+# 특정 커밋부터 정리
+git rebase -i <commit-hash>^
+
+# 분기점부터 정리 (PR 전 정리 시)
+git rebase -i main
+```
+
+### Rebase 명령어
+| 명령     | 단축 | 동작                                |
+|----------|------|-------------------------------------|
+| `pick`   | `p`  | 커밋 그대로 유지                     |
+| `reword` | `r`  | 커밋 유지, 메시지만 변경              |
+| `edit`   | `e`  | 커밋에서 멈추고 수정 가능             |
+| `squash` | `s`  | 이전 커밋과 합침, 메시지 편집 가능     |
+| `fixup`  | `f`  | 이전 커밋과 합침, 메시지는 이전 것 유지 |
+| `drop`   | `d`  | 커밋 삭제                            |
+
+### Squash vs Fixup
+- **squash**: 두 커밋의 메시지를 결합하여 편집 — 관련 작업을 하나로 묶을 때
+- **fixup**: 이전 커밋에 흡수, 메시지는 이전 것만 유지 — WIP/typo 수정 커밋 정리 시
+
+## 정리 시나리오
+
+### 시나리오 1: WIP 커밋 정리
+```
+Before:
+  abc1234 feat(auth): add login form
+  def5678 WIP: login validation
+  ghi9012 fix typo
+  jkl3456 WIP: add error handling
+  mno7890 done with login
+
+After (squash):
+  xyz1234 feat(auth): add login form with validation and error handling
+```
+
+### 시나리오 2: 커밋 메시지 수정
+```
+Before:
+  abc1234 added stuff
+  def5678 more changes
+
+After (reword):
+  abc1234 feat(api): add user endpoint
+  def5678 test(api): add user endpoint integration tests
+```
+
+### 시나리오 3: 커밋 분리 (edit)
+```bash
+# 하나의 큰 커밋을 여러 개로 분리
+git rebase -i HEAD~3
+# 분리할 커밋을 'edit'으로 변경
+# 해당 커밋에서 멈추면:
+git reset HEAD^
+git add src/auth/
+git commit -m "feat(auth): add authentication module"
+git add src/api/
+git commit -m "feat(api): add user API routes"
+git rebase --continue
+```
+
+### 시나리오 4: Fixup 커밋 자동 생성
+```bash
+# 특정 커밋에 대한 fixup 커밋 생성
+git commit --fixup=<commit-hash>
+
+# 나중에 autosquash로 자동 정리
+git rebase -i --autosquash main
+```
+
+## 히스토리 정리 전략
+
+### PR 전 정리 (권장)
+1. feature 브랜치에서 `git rebase -i main`
+2. WIP, fixup, typo 커밋을 의미 있는 커밋으로 squash
+3. 커밋 메시지를 Conventional Commits 형식으로 reword
+4. 논리적 단위로 커밋을 그룹화
+5. `git push --force-with-lease origin feature/xxx`
+
+### 이상적인 커밋 구조
+```
+feat(auth): add OAuth2 login flow          ← 기능 구현
+test(auth): add OAuth2 integration tests   ← 테스트
+docs(auth): update API documentation       ← 문서
+```
+
+### 피해야 할 커밋 패턴
+```
+WIP
+fix
+asdf
+temp
+...
+final
+final2
+final-final
+```
+
+## 히스토리를 다시 쓰면 안 되는 경우
+
+### 절대 금지
+- `main` / `master` 브랜치 — 공유 브랜치의 히스토리는 변경 불가
+- `develop` 브랜치 — Git Flow에서 통합 브랜치
+- 이미 다른 사람이 pull 한 브랜치
+- 릴리스 태그가 달린 커밋
+- CI/CD에서 참조 중인 커밋
+
+### 허용
+- 아직 push하지 않은 로컬 커밋
+- 본인만 사용하는 feature 브랜치
+- PR 리뷰 전 정리
+- `--force-with-lease`로 force push (다른 사람 작업 보호)
+
+## Force Push 안전 가이드
+
+### --force vs --force-with-lease
+```bash
+# 위험: 다른 사람의 커밋을 덮어쓸 수 있음
+git push --force origin feature/xxx     # 사용 금지
+
+# 안전: 로컬이 알고 있는 리모트 상태가 바뀌었으면 거부
+git push --force-with-lease origin feature/xxx   # 이것만 사용
+```
+
+### Force Push 전 체크리스트
+1. `git log --oneline origin/feature/xxx..feature/xxx` — 리모트와 로컬 차이 확인
+2. 혼자 쓰는 브랜치인지 확인
+3. `--force-with-lease` 사용 (절대 `--force` 아님)
+4. 팀원에게 force push 사전 공지 (공유 브랜치인 경우)
+
+## Git Rerere (Reuse Recorded Resolution)
+
+### 활성화
+```bash
+git config --global rerere.enabled true
+```
+
+### 용도
+- rebase 시 같은 충돌이 반복되는 경우
+- 이전에 해결한 충돌 패턴을 자동 적용
+- `git rerere forget <file>` — 잘못된 해결 기록 삭제
+
+## Git Reflog (안전망)
+
+### 실수 복구
+```bash
+# reflog으로 이전 상태 확인
+git reflog
+
+# rebase 전 상태로 복구
+git reset --hard HEAD@{N}
+
+# 삭제된 브랜치 복구
+git branch recovered-branch HEAD@{N}
+```
+
+### reflog 주의사항
+- 로컬에만 존재 (리모트에는 없음)
+- 기본 90일 보관
+- `git gc` 실행 전까지 유지
+
+## Known Error Patterns
+- **공유 브랜치 rebase**: main/develop에서 `git rebase -i` 실행 → 절대 금지, feature 브랜치에서만
+- **force push 없는 rebase push**: rebase 후 일반 push 시도 → rejected → `--force-with-lease` 사용
+- **잘못된 squash 대상**: 첫 번째 커밋에 squash 적용 → 첫 커밋은 pick이어야 함
+- **rebase 중 충돌 포기**: `git rebase --abort`를 모르고 수동으로 상태 복구 시도 → abort 사용
+- **autosquash 미사용**: `--fixup` 커밋을 수동으로 정리 → `--autosquash` 옵션 활용
+- **reflog 미확인**: rebase 실수 후 복구 방법을 모름 → `git reflog`로 이전 상태 확인
+
+## Tool Sequence
+1. `shell_exec` — `git log --oneline -20` 현재 히스토리 파악
+2. `shell_exec` — `git log --oneline main..HEAD` PR에 포함될 커밋 확인
+3. 분석 — 정리 대상 커밋 식별 (WIP, fixup, 중복, 무의미한 메시지)
+4. 계획 — rebase 전략 수립 (어떤 커밋을 squash/reword/drop 할지)
+5. `shell_exec` — `git reflog -5` 안전망 확인
+6. `shell_exec` — `git rebase` 실행 (비대화형으로 가능한 경우 sequence editor 활용)
+7. `shell_exec` — `git log --oneline -10` 정리 결과 확인
+8. `shell_exec` — 빌드 확인 (`tsc --noEmit` 또는 `pnpm build`)
+9. `shell_exec` — `git push --force-with-lease origin <branch>` (필요 시)
+
+## Validation Checklist
+- [ ] 공유 브랜치(main/develop)의 히스토리는 변경하지 않음
+- [ ] 모든 커밋 메시지가 Conventional Commits 형식
+- [ ] WIP/temp/fixup 커밋이 정리됨
+- [ ] 논리적 단위로 커밋이 그룹화됨
+- [ ] 빌드가 각 커밋에서 성공함 (bisect 가능)
+- [ ] force push 시 `--force-with-lease` 사용
+- [ ] reflog으로 복구 가능한 상태 확인
+- [ ] 팀원에게 force push 사전 공지 (해당 시)

package/plugins/git/skills/pr-review.md

@@ -0,0 +1,196 @@
+## Identity
+PR 리뷰 전문가. Pull Request의 코드 변경을 체계적으로 분석하고, Conventional Comments 형식으로 리뷰를 작성하며, 프로젝트 맞춤형 체크리스트를 자동 생성한다.
+
+## PR Description 템플릿 생성
+
+### 표준 템플릿
+```markdown
+## Summary
+[1-3문장으로 변경 요약]
+
+## Changes
+- [주요 변경사항 1]
+- [주요 변경사항 2]
+- [주요 변경사항 3]
+
+## Motivation
+[왜 이 변경이 필요한지]
+
+## Testing
+- [ ] Unit tests added/updated
+- [ ] Integration tests added/updated
+- [ ] Manual testing performed
+- [ ] Test instructions: [how to test]
+
+## Screenshots
+[UI 변경 시 before/after 스크린샷]
+
+## Breaking Changes
+[호환성 깨지는 변경 있으면 여기에, 없으면 "None"]
+
+## Related Issues
+Closes #[issue number]
+```
+
+### 변경 유형별 추가 항목
+- **API 변경**: request/response 스키마 변경 명시, 마이그레이션 가이드
+- **DB 변경**: migration 스크립트 포함 여부, 롤백 방법
+- **의존성 변경**: 추가/업데이트/삭제된 패키지 목록, 라이선스 확인
+- **보안 변경**: threat model 업데이트, 보안 검토 요청
+
+## Code Review 체크리스트
+
+### 1. 정확성 (Correctness)
+- [ ] 로직이 의도한 대로 동작하는가
+- [ ] edge case가 처리되었는가 (null, undefined, empty, boundary values)
+- [ ] 에러 핸들링이 적절한가 (try-catch, error boundaries)
+- [ ] race condition이 없는가 (비동기 코드)
+- [ ] 메모리 누수 가능성이 없는가 (이벤트 리스너, 구독 정리)
+- [ ] off-by-one 에러가 없는가
+
+### 2. 보안 (Security)
+- [ ] 사용자 입력이 검증/소독(sanitize)되었는가
+- [ ] SQL injection, XSS, CSRF 방어가 되어있는가
+- [ ] 인증/인가가 적절히 적용되었는가
+- [ ] 시크릿/크레덴셜이 코드에 하드코딩되지 않았는가
+- [ ] 민감한 데이터가 로그에 노출되지 않는가
+- [ ] 파일 경로 조작(path traversal)이 방어되었는가
+- [ ] 의존성에 알려진 취약점이 없는가
+
+### 3. 성능 (Performance)
+- [ ] N+1 쿼리 문제가 없는가
+- [ ] 불필요한 리렌더링이 없는가 (React)
+- [ ] 대용량 데이터 처리 시 페이지네이션/스트리밍이 적용되었는가
+- [ ] 캐싱이 적절히 사용되었는가
+- [ ] 번들 사이즈 영향이 최소화되었는가
+- [ ] 비동기 작업이 병렬 처리 가능한 경우 Promise.all 사용되었는가
+
+### 4. 가독성 (Readability)
+- [ ] 변수/함수/클래스명이 의도를 명확히 표현하는가
+- [ ] 복잡한 로직에 주석이 있는가 (why, not what)
+- [ ] 함수가 단일 책임을 가지는가
+- [ ] 중첩이 깊지 않은가 (early return 활용)
+- [ ] 매직 넘버가 상수로 추출되었는가
+- [ ] 코드 중복이 없는가 (DRY)
+
+### 5. 테스트 (Tests)
+- [ ] 새 기능에 대한 테스트가 추가되었는가
+- [ ] 버그 수정에 회귀 테스트가 추가되었는가
+- [ ] 테스트가 의미 있는 시나리오를 커버하는가 (happy path + error path)
+- [ ] 테스트가 독립적으로 실행 가능한가 (외부 의존성 모킹)
+- [ ] 테스트 이름이 시나리오를 설명하는가
+
+### 6. 아키텍처 (Architecture)
+- [ ] 기존 아키텍처 패턴과 일관되는가
+- [ ] 적절한 계층에 코드가 위치하는가 (controller/service/repository)
+- [ ] 의존성 방향이 올바른가 (상위 → 하위, 순환 없음)
+- [ ] 인터페이스/타입이 yua-shared(SSOT)에 정의되었는가 (모노레포)
+- [ ] 공유 가능한 로직이 적절히 추출되었는가
+
+## Diff 분석 전략
+
+### 분석 순서
+1. **파일 목록 먼저**: 변경된 파일 목록으로 전체 범위 파악
+2. **타입/인터페이스**: 계약 변경부터 확인 (영향 범위 파악)
+3. **핵심 로직**: 비즈니스 로직 변경 분석
+4. **테스트**: 테스트 커버리지 확인
+5. **설정/인프라**: 빌드, CI, 환경 설정 변경
+
+### 주의 깊게 볼 패턴
+- 삭제된 코드: 의도적 삭제인지, 실수인지
+- 큰 파일 변경: 리팩토링과 기능 변경이 섞여있지 않은지
+- 새 의존성: 정말 필요한지, 라이선스는 호환되는지
+- 환경 설정 변경: 다른 환경에 영향이 없는지
+
+## Conventional Comments 형식
+
+### Comment Types
+| Type         | 용도                           | 차단 여부 |
+|-------------|-------------------------------|----------|
+| `suggestion` | 개선 제안                      | 비차단    |
+| `issue`      | 반드시 수정 필요한 문제         | 차단      |
+| `question`   | 이해를 위한 질문               | 비차단    |
+| `thought`    | 관련 아이디어/고려사항          | 비차단    |
+| `praise`     | 잘된 부분 칭찬                 | 비차단    |
+| `nit`        | 사소한 스타일/네이밍 제안       | 비차단    |
+| `todo`       | 후속 작업 필요                 | 비차단    |
+
+### Comment 형식
+```
+<type> [(<decoration>)]: <description>
+
+[optional discussion]
+```
+
+### 예시
+```
+suggestion (non-blocking): Consider using `Map` instead of plain object
+for better key type safety and iteration performance.
+
+issue (blocking): This endpoint lacks authentication middleware.
+All user-facing endpoints must use `requireAuth()`.
+
+question: Is this timeout value (30s) intentional?
+It seems high for a health check endpoint.
+
+praise: Great use of the builder pattern here.
+Makes the complex query construction very readable.
+
+nit: Prefer `const` over `let` here since the value is never reassigned.
+
+todo: This error message should be i18n-ready.
+Can be addressed in a follow-up PR.
+
+thought: As the number of strategies grows, this switch statement
+might benefit from a strategy pattern or registry approach.
+```
+
+### Severity 데코레이션
+- `(blocking)`: PR 머지 전 반드시 수정 필요
+- `(non-blocking)`: 수정 권장하지만 머지 가능
+- `(if-minor)`: 수정이 간단하면 이번 PR에서, 아니면 후속 PR
+
+## 리뷰 작성 가이드
+
+### 좋은 리뷰 원칙
+1. **구체적**: "이상해요" 대신 "null 체크가 빠져서 TypeError 날 수 있습니다"
+2. **건설적**: 문제만 지적하지 않고 해결책 제안
+3. **교육적**: 왜 문제인지 설명, 참고 자료 링크
+4. **균형잡힌**: 좋은 점도 언급 (praise)
+5. **겸손한**: "이게 더 나을 수 있을까요?" 형태의 질문
+
+### 피해야 할 리뷰 패턴
+- 코드 스타일만 지적 (linter에 맡기기)
+- 개인 취향 강요 (팀 컨벤션에 없는 것)
+- 과도한 nit-picking (PR당 nit 3개 이하)
+- 리뷰 없이 approve
+- 컨텍스트 없는 "LGTM"
+
+## Known Error Patterns
+- **PR 너무 큼**: 1000줄+ 변경 → 분리 요청 (stacked PRs 제안)
+- **테스트 누락**: 기능 변경에 테스트 없음 → 테스트 추가 요청 (blocking)
+- **description 없음**: PR 본문이 비어있음 → 템플릿 사용 요청
+- **리뷰 지연**: 리뷰 요청 후 24시간+ 미응답 → 리마인더 제안
+- **merge conflict 방치**: conflict 있는 채로 리뷰 요청 → resolve 먼저 요청
+- **WIP 커밋 포함**: "WIP", "temp" 커밋이 남아있음 → history-clean 스킬 연계
+
+## Tool Sequence
+1. `shell_exec` — `git log --oneline main..HEAD` PR 커밋 목록 확인
+2. `shell_exec` — `git diff --stat main..HEAD` 변경 파일 통계
+3. `shell_exec` — `git diff main..HEAD` 전체 diff 확인
+4. `file_read` — 변경된 핵심 파일 읽기 (전체 컨텍스트)
+5. `grep` — 보안 패턴 검색 (하드코딩된 시크릿, SQL injection 등)
+6. `shell_exec` — `git diff main..HEAD -- '*.test.*' '*.spec.*'` 테스트 변경 확인
+7. 분석 — 체크리스트 기반 리뷰 수행
+8. 출력 — Conventional Comments 형식으로 리뷰 작성
+9. 출력 — PR 요약 및 최종 판정 (approve / request changes / comment)
+
+## Validation Checklist
+- [ ] PR description이 변경 내용을 명확히 설명함
+- [ ] 모든 blocking issue가 식별됨
+- [ ] 보안 관련 변경에 보안 리뷰가 수행됨
+- [ ] 테스트 커버리지가 적절함
+- [ ] breaking change가 명시됨 (해당 시)
+- [ ] 리뷰 코멘트가 Conventional Comments 형식
+- [ ] 칭찬(praise)이 최소 1개 포함됨
+- [ ] 최종 판정과 근거가 제시됨

package/plugins/git/strategies/conflict-resolve.json

@@ -0,0 +1,244 @@
+{
+  "id": "conflict-resolve",
+  "name": "Merge Conflict Resolution Strategy",
+  "description": "단계별 merge conflict 해결 전략. 충돌 식별부터 빌드/테스트 검증까지.",
+  "phases": [
+    {
+      "id": "identify",
+      "name": "Identify Conflicts",
+      "order": 1,
+      "description": "충돌 상태를 파악하고 영향 범위를 평가한다.",
+      "steps": [
+        {
+          "command": "git status",
+          "purpose": "현재 merge/rebase 상태 및 충돌 파일 목록 확인",
+          "expect": "both modified, both added, deleted by us/them 상태 파일"
+        },
+        {
+          "command": "git diff --name-only --diff-filter=U",
+          "purpose": "Unmerged 파일만 추출",
+          "expect": "충돌 파일 경로 목록"
+        },
+        {
+          "command": "git log --oneline --left-right HEAD...MERGE_HEAD -20",
+          "purpose": "양쪽 브랜치의 커밋 이력 비교",
+          "expect": "< (ours) 및 > (theirs) 커밋 목록"
+        }
+      ],
+      "outputs": {
+        "conflictFiles": "충돌 파일 목록",
+        "conflictCount": "총 충돌 파일 수",
+        "mergeType": "merge | rebase | cherry-pick"
+      },
+      "failCondition": "git status가 충돌 상태가 아닌 경우",
+      "failAction": "merge/rebase 진행 중이 아니라면 스킵"
+    },
+    {
+      "id": "read-conflicts",
+      "name": "Read & Analyze Conflicts",
+      "order": 2,
+      "description": "각 충돌 파일의 내용을 읽고 충돌 유형을 분류한다.",
+      "steps": [
+        {
+          "tool": "file_read",
+          "target": "각 충돌 파일",
+          "purpose": "conflict 마커 포함 전체 내용 확인"
+        },
+        {
+          "command": "git show :1:{file}",
+          "purpose": "BASE 버전 확인 (공통 조상)",
+          "optional": true
+        },
+        {
+          "command": "git show :2:{file}",
+          "purpose": "OURS 버전 확인 (현재 브랜치)",
+          "optional": true
+        },
+        {
+          "command": "git show :3:{file}",
+          "purpose": "THEIRS 버전 확인 (병합 대상)",
+          "optional": true
+        }
+      ],
+      "classification": {
+        "types": [
+          {
+            "type": "same-line-edit",
+            "description": "같은 줄을 양쪽에서 다르게 수정",
+            "autoResolvable": false,
+            "risk": "high"
+          },
+          {
+            "type": "import-reorder",
+            "description": "import 문 순서 변경",
+            "autoResolvable": true,
+            "risk": "low"
+          },
+          {
+            "type": "adjacent-line",
+            "description": "인접한 줄을 양쪽에서 수정",
+            "autoResolvable": "conditional",
+            "risk": "medium"
+          },
+          {
+            "type": "rename-edit",
+            "description": "한쪽은 파일 rename, 다른 쪽은 내용 수정",
+            "autoResolvable": false,
+            "risk": "medium"
+          },
+          {
+            "type": "delete-modify",
+            "description": "한쪽은 삭제, 다른 쪽은 수정",
+            "autoResolvable": false,
+            "risk": "high"
+          },
+          {
+            "type": "both-add",
+            "description": "같은 위치에 양쪽 모두 새 코드 추가",
+            "autoResolvable": "conditional",
+            "risk": "medium"
+          },
+          {
+            "type": "lockfile",
+            "description": "package-lock.json / pnpm-lock.yaml 충돌",
+            "autoResolvable": true,
+            "risk": "low",
+            "resolution": "accept theirs + reinstall"
+          }
+        ]
+      },
+      "outputs": {
+        "conflictDetails": "파일별 충돌 유형, 위치, 심각도"
+      }
+    },
+    {
+      "id": "resolve",
+      "name": "Resolve Conflicts",
+      "order": 3,
+      "description": "각 충돌을 유형별 전략에 따라 해결한다.",
+      "strategies": {
+        "same-line-edit": {
+          "steps": [
+            "양쪽 커밋 메시지/PR 설명에서 변경 의도 파악",
+            "BASE 버전과 비교하여 각 변경의 목적 이해",
+            "최신 의도를 반영하되 양쪽 기능이 보존되도록 통합",
+            "통합이 불가능하면 팀/작성자에게 확인 요청"
+          ],
+          "priority": "theirs가 최신이면 theirs 우선, 양쪽 다 필요하면 통합"
+        },
+        "import-reorder": {
+          "steps": [
+            "양쪽의 추가/삭제된 import 파악",
+            "모든 필요한 import를 포함",
+            "알파벳 순서로 정렬",
+            "미사용 import 제거"
+          ],
+          "priority": "모두 포함 후 정렬"
+        },
+        "lockfile": {
+          "steps": [
+            "lock file의 conflict를 accept theirs로 해결",
+            "pnpm install 재실행으로 lock file 재생성",
+            "재생성된 lock file을 staging"
+          ],
+          "priority": "항상 재생성"
+        },
+        "delete-modify": {
+          "steps": [
+            "삭제한 쪽의 의도 확인 (리팩토링? 불필요?)",
+            "수정한 쪽의 변경 내용 확인",
+            "리팩토링으로 이동된 경우: 이동된 파일에 수정 적용",
+            "불필요해서 삭제된 경우: 삭제 유지"
+          ],
+          "priority": "의도 기반 판단 필수"
+        }
+      },
+      "steps": [
+        {
+          "tool": "file_edit",
+          "purpose": "conflict 마커 제거 및 최종 코드 작성"
+        },
+        {
+          "command": "git add {resolved_file}",
+          "purpose": "해결 완료 표시"
+        }
+      ],
+      "outputs": {
+        "resolvedFiles": "해결된 파일 목록",
+        "resolutionType": "파일별 해결 방식 (ours/theirs/both/manual)"
+      }
+    },
+    {
+      "id": "verify-build",
+      "name": "Verify Build",
+      "order": 4,
+      "description": "충돌 해결 후 빌드가 정상적으로 통과하는지 확인한다.",
+      "steps": [
+        {
+          "command": "git diff --check",
+          "purpose": "미해결 conflict 마커 잔존 확인",
+          "expect": "출력 없음 (잔존 마커 없음)"
+        },
+        {
+          "command": "grep -rn '<<<<<<<\\|=======\\|>>>>>>>' {resolvedFiles}",
+          "purpose": "conflict 마커 이중 확인",
+          "expect": "매칭 없음"
+        },
+        {
+          "command": "tsc --noEmit",
+          "purpose": "TypeScript 컴파일 체크",
+          "expect": "에러 0개",
+          "conditional": "tsconfig.json이 있을 때만"
+        },
+        {
+          "command": "pnpm build",
+          "purpose": "전체 빌드 확인",
+          "expect": "빌드 성공"
+        }
+      ],
+      "outputs": {
+        "buildStatus": "pass | fail",
+        "errors": "빌드 에러 목록 (실패 시)"
+      },
+      "failAction": "에러 기반 자동 수정 시도 (최대 3회)"
+    },
+    {
+      "id": "verify-tests",
+      "name": "Verify Tests",
+      "order": 5,
+      "description": "테스트 스위트가 통과하는지 확인한다.",
+      "steps": [
+        {
+          "command": "pnpm test",
+          "purpose": "전체 테스트 실행",
+          "expect": "모든 테스트 통과",
+          "optional": true,
+          "timeout": 120000
+        },
+        {
+          "command": "pnpm --filter {affectedPackages} test",
+          "purpose": "영향받는 패키지만 테스트",
+          "expect": "테스트 통과",
+          "conditional": "모노레포일 때"
+        }
+      ],
+      "outputs": {
+        "testStatus": "pass | fail | skipped",
+        "failedTests": "실패한 테스트 목록 (실패 시)"
+      },
+      "failAction": "테스트 실패 원인 분석 및 수정",
+      "completion": {
+        "onSuccess": "git commit 으로 merge 완료 (또는 git rebase --continue)",
+        "onFail": "실패 원인과 수동 개입 필요 사항 보고"
+      }
+    }
+  ],
+  "config": {
+    "maxAutoRetries": 3,
+    "requireBuildPass": true,
+    "requireTestPass": false,
+    "autoResolveTypes": ["import-reorder", "lockfile"],
+    "manualResolveTypes": ["same-line-edit", "delete-modify"],
+    "notifyOnCompletion": true
+  }
+}