@su-record/vibe 0.3.0 → 0.4.0

package/.claude/agents/simplifier.md

@@ -0,0 +1,120 @@
+# Code Simplifier Agent
+
+코드 품질 규칙을 자동으로 검증하고 교정하는 서브에이전트입니다.
+
+## Trigger
+
+PostToolUse Hook에서 `Write`, `Edit` 작업 후 자동 실행됩니다.
+
+## Rules Reference
+
+**검증 기준 (`.agent/rules/`):**
+
+### 필수 규칙
+- `core/development-philosophy.md` - 수술적 정밀도
+- `core/quick-start.md` - DRY, SRP, YAGNI
+- `quality/checklist.md` - 품질 체크리스트
+
+### 복잡도 기준
+- `standards/complexity-metrics.md`:
+  - 순환 복잡도 ≤ 10
+  - 함수 길이 ≤ 20줄
+  - 중첩 깊이 ≤ 3단계
+  - 매개변수 ≤ 5개
+  - 컴포넌트 JSX ≤ 50줄
+
+### 안티패턴
+- `standards/anti-patterns.md` - 피해야 할 패턴
+
+## Process
+
+### 1. 변경 파일 분석
+
+```
+수정된 파일 목록 확인
+각 파일의 변경 내용 분석
+```
+
+### 2. 규칙 검증
+
+```typescript
+const checks = {
+  // 복잡도
+  cyclomaticComplexity: '≤ 10',
+  functionLength: '≤ 20 lines',
+  nestingDepth: '≤ 3 levels',
+  parameterCount: '≤ 5',
+
+  // 코드 품질
+  noAnyType: true,
+  noMagicNumbers: true,
+  singleResponsibility: true,
+
+  // 스타일
+  koreanComments: true,
+  consistentNaming: true,
+};
+```
+
+### 3. 자동 교정 (가능한 경우)
+
+- 긴 함수 → 분리 제안
+- 깊은 중첩 → early return 패턴
+- 매직 넘버 → 상수 추출
+- any 타입 → 타입 추론/명시
+
+### 4. 결과 보고
+
+```
+✅ 품질 검증 통과 (점수: 95/100)
+
+또는
+
+⚠️ 개선 필요:
+- src/utils/helper.ts:15 - 함수 길이 25줄 (기준: 20줄)
+- src/components/Form.tsx:42 - 중첩 4단계 (기준: 3단계)
+
+🔧 자동 교정:
+- 매직 넘버 3개 → 상수로 변환
+```
+
+## Quick Check (빠른 검증)
+
+```
+✅ 요청 범위만 수정했는가?
+✅ any 타입이 없는가?
+✅ 함수가 20줄 이하인가?
+✅ 중첩이 3단계 이하인가?
+✅ 에러 처리를 했는가?
+✅ 매직 넘버를 상수화했는가?
+✅ 테스트를 작성했는가?
+```
+
+## Grade
+
+| 등급 | 점수 | 액션 |
+|------|------|------|
+| A+ | 95-100 | 통과 |
+| A | 90-94 | 통과 |
+| B+ | 85-89 | 경고 표시 |
+| B | 80-84 | 개선 권장 |
+| C | 70-79 | 개선 필요 |
+| F | < 70 | 교정 필수 |
+
+## Usage
+
+이 에이전트는 직접 호출하지 않습니다.
+`settings.json`의 PostToolUse Hook을 통해 자동 실행됩니다.
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "tools": ["Write", "Edit"],
+        "command": "claude --agent simplifier"
+      }
+    ]
+  }
+}
+```

package/.claude/commands/vibe.run.md

@@ -1,158 +1,178 @@
 ---
-description: Execute task with Implementation Agent
-argument-hint: "Task 1-1" or --phase N or --all
+description: Execute implementation from SPEC
+argument-hint: "feature name" or --phase N
 ---
 
 # /vibe.run
 
-Task를 구현합니다 (Implementation Agent).
+SPEC을 기반으로 구현합니다 (Implementation Agent).
 
 ## Usage
 
 ```
-/vibe.run "Task 1-1"           # 특정 Task 실행
-/vibe.run --phase 1            # Phase 1 전체 실행
-/vibe.run --all                # 모든 Task 실행
+/vibe.run "기능명"              # 전체 구현
+/vibe.run "기능명" --phase 1    # 특정 Phase만
 ```
 
+## Rules Reference
+
+**반드시 `.agent/rules/` 규칙을 따릅니다:**
+- `core/development-philosophy.md` - 수술적 정밀도, 요청 범위만 수정
+- `core/quick-start.md` - 한국어, DRY, SRP, YAGNI
+- `standards/complexity-metrics.md` - 함수 ≤20줄, 중첩 ≤3단계
+- `quality/checklist.md` - 코드 품질 체크리스트
+
 ## Description
 
-TASKS 문서의 특정 Task를 읽고 구현 가이드를 생성한 후, 실제 코드를 작성합니다.
+PTCF 구조의 SPEC 문서를 읽고 바로 구현을 실행합니다.
+
+> **PLAN, TASKS 문서 불필요** - SPEC이 곧 실행 가능한 프롬프트
 
 ## Process
 
-### 1️⃣ Task 정보 읽기
-- `.vibe/tasks/{기능명}.md`에서 Task 찾기
-- Task 메타데이터 확인:
-  - 담당 Agent (Backend Python Expert / Frontend Flutter Expert)
-  - 예상 시간
-  - 우선순위
-  - 의존성 (선행 Task 완료 여부 확인)
-  - Acceptance Criteria
-
-### 2️⃣ 구현 가이드 생성
-- `.vibe/guides/task-{N}-{M}.md` 생성
-- 포함 내용:
-  - 목표 (Goal)
-  - 파일 경로 (Files to Create/Modify)
-  - 코드 템플릿 (Code Template)
-  - 구현 순서 (Implementation Steps)
-  - 검증 방법 (Verification)
-  - 다음 Task
-
-### 3️⃣ 코드 구현
-- 구현 가이드에 따라 실제 파일 생성/수정
-- 담당 Agent의 스킬 적용:
-  - Backend Python Expert: `~/.vibe/agents/backend-python-expert.md`
-  - Frontend Flutter Expert: `~/.vibe/agents/frontend-flutter-expert.md`
-- TRUST 5 원칙 준수:
-  - **Test-first (BDD/Contract Testing 우선)**
-    - Contract 파일 먼저 작성 (Provider/Consumer)
-    - BDD Step Definitions 작성
-    - Unit Tests 작성
-  - Readable (명확한 코드)
-  - Unified (일관된 스타일)
-  - Secured (보안 고려)
-  - Trackable (로깅, 모니터링)
-
-### 4️⃣ Acceptance Criteria 검증
-- TASKS 문서의 체크리스트 확인
-- 검증 명령어 실행 (pytest, flutter test 등)
-- 모든 기준 통과 확인
-
-### 5️⃣ Task 상태 업데이트
-- TASKS 문서에서 Task 상태를 ✅ 완료로 변경
-- 완료 일시 기록
-- 진행률 업데이트
-
-## Agent Selection
-
-| Task | Agent |
-|------|-------|
-| Task 1-1 ~ 1-9 (Backend + Contract Provider) | Backend Python Expert |
-| Task 2-1 ~ 2-9 (Frontend + Contract Consumer) | Frontend Flutter Expert |
-| Task 3-1 ~ 3-2 (FCM Backend) | Backend Python Expert |
-| Task 3-3 (BDD Step Definitions) | QA / Backend/Frontend Expert |
-| Task 3-4 (Contract Verification) | QA |
-| Task 3-5 (E2E Test) | QA / Frontend Flutter Expert |
+### 1. SPEC 읽기
+
+`.vibe/specs/{기능명}.md` 파싱:
+
+| 섹션 | 용도 |
+|------|------|
+| `<role>` | AI 역할 정의 |
+| `<context>` | 배경, 기술 스택, 관련 코드 |
+| `<task>` | Phase별 작업 목록 |
+| `<constraints>` | 제약 조건 |
+| `<output_format>` | 생성/수정할 파일 |
+| `<acceptance>` | 검증 기준 |
+
+### 2. Feature 파일 확인
+
+`.vibe/features/{기능명}.feature`:
+- BDD Scenarios 확인
+- 테스트 케이스로 활용
+
+### 3. Phase별 구현
+
+`<task>` 섹션의 Phase 순서대로:
+
+1. **관련 코드 분석**: `<context>`의 관련 코드 읽기
+2. **파일 생성/수정**: `<output_format>` 기준
+3. **제약 조건 준수**: `<constraints>` 확인
+4. **검증 실행**: 검증 명령어 실행
+
+### 4. Acceptance Criteria 검증
+
+`<acceptance>` 체크리스트 확인:
+- [ ] 각 기준 통과 여부
+- [ ] 테스트 통과
+- [ ] 빌드 성공
+
+### 5. SPEC 업데이트
+
+완료된 Task 체크:
+```markdown
+## Task
+<task>
+### Phase 1: Backend
+1. [x] DB 스키마 작성 ✅
+2. [x] API 엔드포인트 ✅
+...
+</task>
+```
+
+## TRUST 5 원칙
+
+구현 시 준수:
+
+| 원칙 | 설명 |
+|------|------|
+| **T**est-first | 테스트 먼저 작성 |
+| **R**eadable | 명확한 코드 |
+| **U**nified | 일관된 스타일 |
+| **S**ecured | 보안 고려 |
+| **T**rackable | 로깅, 모니터링 |
 
 ## Input
 
-- `.vibe/tasks/{기능명}.md` (TASKS 문서)
-- `.vibe/plans/{기능명}.md` (PLAN 참고)
-- `.vibe/specs/{기능명}.md` (SPEC 참고)
-- `.vibe/features/{기능명}.feature` (BDD Feature 파일 - Contract Test 매핑용)
+- `.vibe/specs/{기능명}.md` (PTCF SPEC)
+- `.vibe/features/{기능명}.feature` (BDD)
+- `CLAUDE.md` (프로젝트 컨텍스트)
 
 ## Output
 
-- `.vibe/guides/task-{N}-{M}.md` - 구현 가이드
-- 실제 코드 파일 (생성/수정)
-- TASKS 문서 업데이트 (상태: ✅ 완료)
+- 구현된 코드 파일
+- 테스트 파일
+- SPEC 문서 업데이트 (체크표시)
 
 ## Example
 
-### 개별 Task 실행
-
-```
-/vibe.run "Task 1-1"
 ```
+User: /vibe.run "벽돌게임"
 
-**동작:**
-1. TASKS 문서 읽기
-2. Task 1-1 정보 파싱:
-   - 담당: Backend Python Expert
-   - 내용: DB 마이그레이션 파일 작성
-   - 예상 시간: 30분
-3. 구현 가이드 생성: `.vibe/guides/task-1-1.md`
-4. 코드 작성: `backend/alembic/versions/xxxx_add_notification_settings.py`
-5. 검증: `alembic upgrade head` 실행
-6. Task 상태 업데이트: ⬜ → ✅
+Claude:
+📄 SPEC 읽는 중: .vibe/specs/brick-game.md
 
-### Phase 실행
+<role> 분석:
+- 웹 게임 시니어 개발자
+- Phaser.js 전문가
 
-```
-/vibe.run --phase 1
-```
+<context> 분석:
+- 기술 스택: Phaser.js, TypeScript
+- 신규 프로젝트
+
+<task> 분석:
+- Phase 1: 프로젝트 셋업 (3개 작업)
+- Phase 2: 게임 로직 (5개 작업)
+- Phase 3: UI/UX (3개 작업)
+- Phase 4: 테스트 (2개 작업)
 
-**동작:**
-- Phase 1의 9개 Task 순차 실행
-- Task 1-1 → 1-2 → ... → 1-9 (Contract Provider 포함)
-- 각 Task마다 의존성 확인 후 실행
+🚀 Phase 1 시작...
 
-### 전체 실행
+✅ Phase 1 완료
+  - package.json 생성
+  - TypeScript 설정
+  - Phaser.js 설치
 
+🚀 Phase 2 시작...
+[구현 계속...]
+
+✅ 모든 Phase 완료!
+📊 Acceptance Criteria 검증 중...
+  ✅ 게임 시작/종료 동작
+  ✅ 공-패들 충돌 처리
+  ✅ 점수 표시
+  ✅ npm run build 성공
+
+🎉 구현 완료!
 ```
-/vibe.run --all
+
+### Phase 지정 실행
+
 ```
+User: /vibe.run "벽돌게임" --phase 2
 
-**동작:**
-- 의존성 그래프에 따라 23개 Task 순차 실행
-- Phase 1 (9개) → Phase 2 (9개) → Phase 3 (5개)
-- BDD/Contract Testing 포함
-- 예상 시간: 28시간
+Claude:
+📄 SPEC 읽는 중: .vibe/specs/brick-game.md
+🎯 Phase 2만 실행합니다.
 
-## Verification
+Phase 2: 게임 로직
+1. [ ] 패들 이동 구현
+2. [ ] 공 물리엔진
+3. [ ] 벽돌 충돌 처리
+4. [ ] 점수 시스템
+5. [ ] 게임 오버 조건
 
-각 Task 완료 후:
-- [ ] Acceptance Criteria 모두 통과
-- [ ] 검증 명령어 실행 성공
-- [ ] 코드 품질 기준 충족 (TRUST 5)
-- [ ] TASKS 문서 상태 업데이트
+🚀 구현 시작...
+```
 
 ## Error Handling
 
-Task 실행 실패 시:
+실패 시:
 1. 에러 메시지 확인
-2. 구현 가이드 재검토
+2. `<constraints>` 재검토
 3. 코드 수정 후 재시도
-4. 여전히 실패 시 사용자에게 보고
+4. 계속 실패 시 사용자에게 보고
 
 ## Next Step
 
-Task 완료 후:
-- 의존성 그래프 확인
-- 다음 Task 실행 또는 Phase 완료 확인
-- 모든 Task 완료 시:
-  ```
-  /vibe.verify "푸시 알림 설정 기능"
-  ```
+```
+/vibe.verify "벽돌게임"
+```