@su-record/vibe 0.4.8 → 1.0.0

package/templates/feature-template.md

@@ -1,12 +1,8 @@
 # Feature: {기능명}
 
-**Generated from**: `specs/{기능명}.md`
-**Language**: {ko | en}
-**Priority**: {HIGH | MEDIUM | LOW}
+**SPEC**: `.vibe/specs/{기능명}.md`
 
----
-
-## Feature Description
+## User Story
 
 **As a** {사용자 역할}
 **I want** {원하는 기능}
@@ -14,246 +10,61 @@
 
 ---
 
-## Background (Optional)
-
-```gherkin
-Background:
-  Given {공통 전제 조건 1}
-  And {공통 전제 조건 2}
-```
-
----
-
 ## Scenarios
 
-### Scenario 1: {시나리오 제목}
-
-**Mapped to**: REQ-001 in SPEC
+### Scenario 1: {Happy Path - 정상 케이스}
 
 ```gherkin
 Scenario: {시나리오 제목}
   Given {전제 조건}
-  And {추가 전제 조건}
   When {사용자 행동}
-  And {추가 행동}
   Then {예상 결과}
-  And {추가 검증}
 ```
 
-**Acceptance Criteria**:
-- [ ] {SPEC의 Acceptance Criteria 1}
-- [ ] {SPEC의 Acceptance Criteria 2}
-
-**Test Data**:
-```json
-{
-  "input": {...},
-  "expected_output": {...}
-}
-```
+**검증 기준**: SPEC Acceptance Criteria #1
 
 ---
 
-### Scenario 2: {에러 케이스 제목}
+### Scenario 2: {Edge Case - 예외 케이스}
 
 ```gherkin
-Scenario: {에러 케이스 제목}
+Scenario: {에러 시나리오 제목}
   Given {전제 조건}
   When {잘못된 입력}
-  Then {에러 응답}
-  And {에러 메시지 검증}
+  Then {에러 처리}
 ```
 
+**검증 기준**: SPEC Acceptance Criteria #2
+
 ---
 
-### Scenario Outline: {파라미터화된 시나리오}
+### Scenario Outline: {파라미터화 테스트}
 
 ```gherkin
 Scenario Outline: {시나리오 제목}
   Given {전제 조건}
-  When I {행동} with "<parameter>"
-  Then I should see "<result>"
+  When I input "<input>"
+  Then I should see "<output>"
 
 Examples:
-  | parameter | result |
-  | value1    | result1 |
-  | value2    | result2 |
-  | value3    | result3 |
-```
-
----
-
-## Implementation Guide
-
-### Backend Tests (Python + Pytest-BDD)
-
-**File**: `tests/features/{기능명}.feature`
-
-```python
-# tests/step_defs/test_{기능명}.py
-import pytest
-from pytest_bdd import scenarios, given, when, then, parsers
-
-# Load scenarios
-scenarios('features/{기능명}.feature')
-
-@given(parsers.parse('사용자가 {role}로 로그인되어 있다'))
-def user_logged_in(context, role):
-    context.user = create_user(role)
-    context.token = authenticate(context.user)
-
-@when(parsers.parse('{action}을 실행한다'))
-def execute_action(context, action):
-    context.response = api_call(action, context.token)
-
-@then(parsers.parse('응답 코드는 {status_code:d}이어야 한다'))
-def check_status_code(context, status_code):
-    assert context.response.status_code == status_code
-```
-
-**Run**:
-```bash
-pytest tests/features/{기능명}.feature --verbose
-```
-
----
-
-### Frontend Tests (Flutter + Gherkin)
-
-**File**: `integration_test/features/{기능명}.feature`
-
-```dart
-// integration_test/step_definitions/{기능명}_test.dart
-import 'package:flutter_gherkin/flutter_gherkin.dart';
-
-class UserLoggedInStep extends Given1WithWorld<String, FlutterWorld> {
-  @override
-  Future<void> executeStep(String role) async {
-    await world.appDriver.waitForAppToSettle();
-    // Login logic
-  }
-
-  @override
-  RegExp get pattern => RegExp(r'사용자가 {string}로 로그인되어 있다');
-}
-```
-
-**Run**:
-```bash
-flutter test integration_test/{기능명}_test.dart
+  | input  | output  |
+  | value1 | result1 |
+  | value2 | result2 |
 ```
 
 ---
 
-### Frontend Tests (React + Cucumber)
-
-**File**: `tests/features/{기능명}.feature`
-
-```javascript
-// tests/step_definitions/{기능명}.steps.js
-const { Given, When, Then } = require('@cucumber/cucumber');
-const { render, screen, fireEvent } = require('@testing-library/react');
-
-Given('사용자가 {string}로 로그인되어 있다', async function (role) {
-  this.user = await createUser(role);
-  this.token = await authenticate(this.user);
-});
-
-When('{string}을 실행한다', async function (action) {
-  this.response = await apiCall(action, this.token);
-});
+## Coverage
 
-Then('응답 코드는 {int}이어야 한다', function (statusCode) {
-  expect(this.response.status).toBe(statusCode);
-});
-```
-
-**Run**:
-```bash
-npm test -- --features tests/features/{기능명}.feature
-```
+| Scenario | SPEC Acceptance | Status |
+|----------|-----------------|--------|
+| Scenario 1 | AC-1 | ⬜ |
+| Scenario 2 | AC-2 | ⬜ |
 
 ---
 
-## Tags
+## Verification
 
-```gherkin
-@priority-high
-@smoke
-@regression
-@backend
-@frontend
-```
-
-**Run by tag**:
 ```bash
-# Python
-pytest -m "priority-high"
-
-# JavaScript
-npm test -- --tags "@smoke"
+/vibe.verify "{기능명}"
 ```
-
----
-
-## Coverage Mapping
-
-| Scenario | SPEC REQ | Acceptance Criteria | Status |
-|----------|----------|---------------------|--------|
-| Scenario 1 | REQ-001 | AC-1, AC-2, AC-3 | ⬜ |
-| Scenario 2 | REQ-002 | AC-4, AC-5 | ⬜ |
-| Scenario 3 | REQ-003 | AC-6, AC-7 | ⬜ |
-
-**Coverage**: 0 / {총 시나리오 수} (0%)
-
----
-
-## Test Execution Report
-
-**Last Run**: {날짜 시간}
-**Environment**: {dev | staging | production}
-
-| Scenario | Status | Duration | Error |
-|----------|--------|----------|-------|
-| Scenario 1 | ⬜ PENDING | - | - |
-| Scenario 2 | ⬜ PENDING | - | - |
-
-**Total**: 0 passed, 0 failed, {총 수} pending
-
----
-
-## Next Steps
-
-1. **구현 전 테스트 작성** (Test-First):
-   ```bash
-   # Create feature file first
-   vibe feature "{기능명}"
-
-   # Then implement
-   vibe run "Task 1-1"
-   ```
-
-2. **구현 중 테스트 실행**:
-   ```bash
-   vibe test "{기능명}" --watch
-   ```
-
-3. **완료 후 검증**:
-   ```bash
-   vibe verify "{기능명}"
-   ```
-
----
-
-## Notes
-
-- ✅ **Given**: 테스트 전제 조건 (상태 설정)
-- ✅ **When**: 사용자 행동 (액션 실행)
-- ✅ **Then**: 예상 결과 (검증)
-- ✅ **And/But**: 추가 조건/검증
-
-**Best Practices**:
-- 시나리오는 비즈니스 언어로 작성
-- 구현 세부사항은 Step Definitions에
-- 각 시나리오는 독립적으로 실행 가능해야 함
-- Background는 중복 제거용으로만 사용

package/templates/hooks-template.json

@@ -1,12 +1,101 @@
 {
   "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "파일 읽기 전: 1) 전체 파일이 필요한가? offset/limit 파라미터로 필요한 부분만 읽기 2) 이미 읽은 파일인가? 중복 읽기 방지 3) Grep으로 특정 부분만 검색 가능한가?"
+          }
+        ]
+      },
+      {
+        "matcher": "Grep|Glob",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "검색 전: head_limit 파라미터를 활용하여 결과 수를 제한하세요. 너무 많은 결과는 컨텍스트를 낭비합니다."
+          }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
         "matcher": "Write|Edit",
         "hooks": [
           {
             "type": "prompt",
-            "prompt": ".vibe/rules/quality/checklist.md 기준으로 방금 수정한 코드를 검토해주세요. 문제가 있으면 간단히 알려주세요."
+            "prompt": ".vibe/rules/quality/checklist.md 기준으로 방금 수정한 코드를 검토하세요. 과도한 주석이 있으면 제거하세요. 문제가 있으면 간단히 알려주세요."
+          }
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "Task 완료 후: 핵심 결과만 요약하여 mcp__vibe__save_memory로 저장하세요. 전체 출력이 아닌 중요한 결정사항/발견 패턴/다음 단계만 기록하세요."
+          }
+        ]
+      },
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "파일 읽기 후: 전체 내용을 기억하지 마세요. 필요한 정보만 추출하고 나머지는 필요시 다시 읽으세요. 중복 읽기 감지: 같은 파일을 다시 읽었다면 이전 내용은 무시하세요."
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "context_window_70",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "📊 컨텍스트 70% 도달. 아직 충분한 여유가 있습니다. 작업을 서두르지 말고 품질에 집중하세요. 불필요한 파일 전체 읽기를 피하고 필요한 부분만 참조하세요."
+          }
+        ]
+      },
+      {
+        "matcher": "context_window_85",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "⚠️ 컨텍스트 85% 도달 (선제적 압축 권고). 1) mcp__vibe__auto_save_context로 현재 상태 저장 2) 오래된 도구 출력은 요약으로 대체 3) 중복 읽은 파일 내용 정리 4) 핵심 정보만 유지하면서 작업 계속"
+          }
+        ]
+      },
+      {
+        "matcher": "context_window_95",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "🚨 컨텍스트 95% 도달! 즉시: 1) mcp__vibe__auto_save_context 실행 2) TodoWrite로 현재 진행 상황과 다음 단계 기록 3) CLAUDE.md, .vibe/specs/ 등 핵심 컨텍스트만 유지 4) 세션 전환 준비"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "세션 종료 전 체크리스트: 1) TodoWrite로 미완료 작업 기록 (구체적인 다음 단계 포함) 2) mcp__vibe__auto_save_context로 현재 상태 저장 3) 다음 세션 시작 시 mcp__vibe__start_session으로 복원 안내"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "세션 시작 시: mcp__vibe__start_session을 호출하여 이전 세션 컨텍스트를 복원하세요. 저장된 메모리와 미완료 작업을 확인하세요."
           }
         ]
       }