@su-record/vibe 2.6.28 → 2.6.30

package/CLAUDE.md

@@ -1,202 +1,235 @@
-# VIBE
-
-SPEC-driven AI Coding Framework (Claude Code Exclusive)
-
-## Response Language
-
-**IMPORTANT: Always respond in Korean (한국어) unless the user explicitly requests otherwise.**
-
-## Code Quality Standards (Mandatory)
-
-Follow these standards when writing code. See `~/.claude/vibe/rules/` (global) for detailed rules.
-
-### Core Principles
-
-- **Modify only requested scope** - Don't touch unrelated code
-- **Preserve existing style** - Follow project conventions
-- **Keep working code** - No unnecessary refactoring
-- **Respect user interrupts** - If user interrupts (Ctrl+C/Escape) and sends a new message, the previous task is CANCELLED. Do NOT resume or continue interrupted work. Respond ONLY to the new message.
-
-### Code Complexity Limits
-
-| Metric               | Limit                                        |
-|----------------------|----------------------------------------------|
-| Function length      | ≤30 lines (recommended), ≤50 lines (allowed) |
-| Nesting depth        | ≤3 levels                                    |
-| Parameters           | ≤5                                           |
-| Cyclomatic complexity | ≤10                                         |
-
-### TypeScript Rules
-
-- No `any` → `unknown` + type guards
-- No `as any` → proper interfaces
-- No `@ts-ignore`
-- Explicit return types
-
-### Error Handling Required
-
-- try-catch or error state required
-- Loading state handling
-- User-friendly error messages
-
-### Forbidden Patterns
-
-- No console.log in commits
-- No hardcoded strings/numbers
-- No commented-out code
-- No incomplete code without TODO
-
-## Workflow
-
-```text
-/vibe.spec → /new → /vibe.spec.review → /vibe.run → /vibe.trace → (auto) code review → ✅ Done
-```
-
-1. `/vibe.spec` - Write SPEC (requirements + research + draft)
-2. `/new` - Start new session (clean context)
-3. `/vibe.spec.review` - GPT/Gemini review (3-round mandatory)
-4. `/vibe.run` - Implementation + Gemini review
-5. **(auto)** 13+ agent parallel review + P1/P2 auto-fix
-
-## Plan Mode vs VIBE
-
-| Task Size                    | Recommended  |
-|------------------------------|--------------|
-| Simple changes (1-2 files)   | Plan Mode    |
-| Complex features (3+ files)  | `/vibe.spec` |
-
-After `/vibe.analyze` or `/vibe.review` with dev request → **Ask user for workflow choice**
-
-## ULTRAWORK Mode
-
-Include `ultrawork` or `ulw` keyword for maximum performance:
-
-- Parallel sub-agent exploration (3+ concurrent)
-- Background agents + Phase pipelining
-- Boulder Loop (auto-continue until all Phases complete)
-- Auto-retry on error (max 3), Auto-save at 70%+ context
-
-## Commands
-
-| Command                      | Description                       |
-|------------------------------|-----------------------------------|
-| `/vibe.spec "name"`          | Write SPEC (PTCF) + parallel research |
-| `/vibe.spec.review "name"`   | GPT/Gemini review (new session)   |
-| `/vibe.run "name"`           | Execute implementation            |
-| `/vibe.run "name" ultrawork` | Maximum performance mode          |
-| `/vibe.verify "name"`        | Verification against SPEC         |
-| `/vibe.review`               | 13+ agent parallel code review    |
-| `/vibe.trace "name"`         | Requirements traceability matrix  |
-| `/vibe.reason "problem"`     | Systematic reasoning              |
-| `/vibe.analyze`              | Project analysis                  |
-| `/vibe.utils --e2e`          | E2E testing (Playwright)          |
-| `/vibe.utils --diagram`      | Generate diagrams                 |
-| `/vibe.utils --ui "desc"`    | UI preview                        |
-| `/vibe.utils --continue`     | Session restore                   |
-
-## Magic Keywords
-
-| Keyword              | Effect                                        |
-|----------------------|-----------------------------------------------|
-| `ultrawork` / `ulw`  | Parallel + auto-continue + Ralph Loop         |
-| `ralph`              | Iterate until 100% complete (no scope reduction) |
-| `ralplan`            | Iterative planning + persistence              |
-| `verify`             | Strict verification mode                      |
-| `quick`              | Fast mode, minimal verification               |
-
-## PTCF Structure
-
-SPEC documents use: `<role>` `<context>` `<task>` `<constraints>` `<output_format>` `<acceptance>`
-
-## Built-in Tools
-
-### Semantic & Quality
-
-| Tool                          | Purpose                          |
-|-------------------------------|----------------------------------|
-| `vibe_find_symbol`            | Find symbol definitions          |
-| `vibe_find_references`        | Find references                  |
-| `vibe_analyze_complexity`     | Analyze complexity               |
-| `vibe_validate_code_quality`  | Validate quality                 |
-
-### Memory & Session
-
-| Tool                          | Purpose                          |
-|-------------------------------|----------------------------------|
-| `vibe_start_session`          | Restore previous session context |
-| `vibe_auto_save_context`      | Save current state               |
-| `vibe_save_memory`            | Save important decisions         |
-
-### Session RAG (v2.6.27)
-
-구조화된 세션 컨텍스트를 저장/검색하는 시스템. SQLite + FTS5 BM25 하이브리드 검색.
-
-| Tool                          | Purpose                          |
-|-------------------------------|----------------------------------|
-| `save_session_item`           | Decision/Constraint/Goal/Evidence 저장 |
-| `retrieve_session_context`    | 하이브리드 검색 (BM25 + recency + priority) |
-| `manage_goals`                | Goal 생명주기 관리 (list/update/complete) |
-
-**4가지 엔티티:**
-
-| Entity | Description | Key Fields |
-|--------|-------------|------------|
-| Decision | 사용자 확인 결정사항 | title, rationale, alternatives, impact, priority |
-| Constraint | 명시적 제약조건 | title, type (technical/business/resource/quality), severity |
-| Goal | 현재 목표 스택 (계층 지원) | title, status, priority, progressPercent, successCriteria |
-| Evidence | 검증/테스트 결과 | title, type (test/build/lint/coverage), status, metrics |
-
-**자동 주입:** `start_session` 호출 시 활성 Goals, 중요 Constraints, 최근 Decisions가 자동으로 세션 컨텍스트에 포함됨.
-
-```typescript
-import { saveSessionItem, retrieveSessionContext, manageGoals } from '@su-record/vibe/tools';
-
-// 결정 저장
-await saveSessionItem({ itemType: 'decision', title: 'Use Vitest', rationale: 'Fast and modern' });
-
-// 제약 저장
-await saveSessionItem({ itemType: 'constraint', title: 'No vector DB', type: 'technical', severity: 'high' });
-
-// 목표 저장
-await saveSessionItem({ itemType: 'goal', title: 'Implement Session RAG', priority: 2 });
-
-// 컨텍스트 검색
-await retrieveSessionContext({ query: 'testing' });
-
-// 목표 관리
-await manageGoals({ action: 'list' });
-await manageGoals({ action: 'update', goalId: 1, progressPercent: 80 });
-await manageGoals({ action: 'complete', goalId: 1 });
-```
-
-## Agents
-
-- **Review (12)**: security, performance, architecture, complexity, simplicity, data-integrity, test-coverage, git-history, python, typescript, rails, react reviewers → `.claude/agents/review/`
-- **Research (4)**: best-practices, framework-docs, codebase-patterns, security-advisory → `.claude/agents/research/`
-
-## Context Management
-
-### Model Selection
-
-- **Exploration/Search**: Haiku
-- **Implementation**: Sonnet
-- **Architecture**: Opus
-
-### At 70%+ Context
-
-- Do NOT use `/compact` (information loss risk)
-- Use `save_memory` → `/new` for new session
-- Restore with `/vibe.utils --continue`
-
-## Documentation Guidelines
-
-- Avoid ASCII boxes → Use Mermaid diagrams, Markdown tables, or indented lists
-- Flowcharts → Mermaid | Structure → Indented lists | Comparisons → Tables
-
-## Git Commit Rules
-
-**Must include:** `.claude/vibe/specs/`, `.claude/vibe/features/`, `.claude/vibe/todos/`, `.claude/vibe/config.json`, `CLAUDE.md`
-
-**Exclude:** `~/.claude/vibe/rules/`, `~/.claude/commands/`, `~/.claude/agents/`, `~/.claude/skills/`, `.claude/settings.local.json`
-
-<!-- VIBE:END -->
+# VIBE
+
+SPEC-driven AI Coding Framework (Claude Code Exclusive)
+
+## Philosophy
+
+> **vibe = 바이브코딩을 쉽게 + 최소 품질 보장**
+
+| Principle | Description |
+|-----------|-------------|
+| **Easy Vibe Coding** | 빠른 흐름, 직관적 개발, AI와 협업하며 생각하기 |
+| **Minimum Quality Guaranteed** | 타입 안전성, 코드 품질, 보안 - 자동으로 하한선 확보 |
+| **Iterative Reasoning (6번 유형)** | AI에게 답을 맡기지 말고, 문제를 쪼개고 질문하며 함께 추론 |
+
+### How vibe Guarantees Quality
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  VIBE QUALITY GUARDRAILS (자동 품질 보장)                    │
+├─────────────────────────────────────────────────────────────┤
+│  1. Type Safety      → Quality Gate (any/Any 차단)          │
+│  2. Code Review      → Race Review (GPT + Gemini 병렬)      │
+│  3. Completion Check → Ralph Loop (100%까지 반복)           │
+│  4. Multi-LLM        → 3개 관점 검증 (Claude+GPT+Gemini)    │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### User's Role (6번 Iterative-Reasoning Type)
+
+연구에 따르면, AI에게 답을 맡기는 것(1번 유형)보다 **문제를 쪼개고 추론하며 협업하는 것(6번 유형)**이 훨씬 좋은 성과를 냅니다.
+
+| ❌ Avoid | ✅ Do Instead |
+|----------|---------------|
+| "로그인 기능 만들어줘" | "로그인 기능의 요구사항을 분석해보자" |
+| AI 결과 그대로 사용 | "이 접근이 맞나?" 검증 질문 |
+| 완성 코드만 요청 | 단계별로 검토하며 진행 |
+
+## Response Language
+
+**IMPORTANT: Always respond in Korean (한국어) unless the user explicitly requests otherwise.**
+
+## Code Quality Standards (Mandatory)
+
+Follow these standards when writing code. See `~/.claude/vibe/rules/` (global) for detailed rules.
+
+### Core Principles
+
+- **Modify only requested scope** - Don't touch unrelated code
+- **Preserve existing style** - Follow project conventions
+- **Keep working code** - No unnecessary refactoring
+- **Respect user interrupts** - If user interrupts (Ctrl+C/Escape) and sends a new message, the previous task is CANCELLED. Do NOT resume or continue interrupted work. Respond ONLY to the new message.
+
+### Code Complexity Limits
+
+| Metric               | Limit                                        |
+|----------------------|----------------------------------------------|
+| Function length      | ≤30 lines (recommended), ≤50 lines (allowed) |
+| Nesting depth        | ≤3 levels                                    |
+| Parameters           | ≤5                                           |
+| Cyclomatic complexity | ≤10                                         |
+
+### TypeScript Rules
+
+- No `any` → `unknown` + type guards
+- No `as any` → proper interfaces
+- No `@ts-ignore`
+- Explicit return types
+
+### Error Handling Required
+
+- try-catch or error state required
+- Loading state handling
+- User-friendly error messages
+
+### Forbidden Patterns
+
+- No console.log in commits
+- No hardcoded strings/numbers
+- No commented-out code
+- No incomplete code without TODO
+
+## Workflow
+
+```text
+/vibe.spec → /new → /vibe.spec.review → /vibe.run → /vibe.trace → (auto) code review → ✅ Done
+```
+
+1. `/vibe.spec` - Write SPEC (requirements + research + draft)
+2. `/new` - Start new session (clean context)
+3. `/vibe.spec.review` - GPT/Gemini review (3-round mandatory)
+4. `/vibe.run` - Implementation + Gemini review
+5. **(auto)** 13+ agent parallel review + P1/P2 auto-fix
+
+## Plan Mode vs VIBE
+
+| Task Size                    | Recommended  |
+|------------------------------|--------------|
+| Simple changes (1-2 files)   | Plan Mode    |
+| Complex features (3+ files)  | `/vibe.spec` |
+
+After `/vibe.analyze` or `/vibe.review` with dev request → **Ask user for workflow choice**
+
+## ULTRAWORK Mode
+
+Include `ultrawork` or `ulw` keyword for maximum performance:
+
+- Parallel sub-agent exploration (3+ concurrent)
+- Background agents + Phase pipelining
+- Boulder Loop (auto-continue until all Phases complete)
+- Auto-retry on error (max 3), Auto-save at 70%+ context
+
+## Commands
+
+| Command                      | Description                       |
+|------------------------------|-----------------------------------|
+| `/vibe.spec "name"`          | Write SPEC (PTCF) + parallel research |
+| `/vibe.spec.review "name"`   | GPT/Gemini review (new session)   |
+| `/vibe.run "name"`           | Execute implementation            |
+| `/vibe.run "name" ultrawork` | Maximum performance mode          |
+| `/vibe.verify "name"`        | Verification against SPEC         |
+| `/vibe.review`               | 13+ agent parallel code review    |
+| `/vibe.trace "name"`         | Requirements traceability matrix  |
+| `/vibe.reason "problem"`     | Systematic reasoning              |
+| `/vibe.analyze`              | Project analysis                  |
+| `/vibe.utils --e2e`          | E2E testing (Playwright)          |
+| `/vibe.utils --diagram`      | Generate diagrams                 |
+| `/vibe.utils --ui "desc"`    | UI preview                        |
+| `/vibe.utils --continue`     | Session restore                   |
+
+## Magic Keywords
+
+| Keyword              | Effect                                        |
+|----------------------|-----------------------------------------------|
+| `ultrawork` / `ulw`  | Parallel + auto-continue + Ralph Loop         |
+| `ralph`              | Iterate until 100% complete (no scope reduction) |
+| `ralplan`            | Iterative planning + persistence              |
+| `verify`             | Strict verification mode                      |
+| `quick`              | Fast mode, minimal verification               |
+
+## PTCF Structure
+
+SPEC documents use: `<role>` `<context>` `<task>` `<constraints>` `<output_format>` `<acceptance>`
+
+## Built-in Tools
+
+### Semantic & Quality
+
+| Tool                          | Purpose                          |
+|-------------------------------|----------------------------------|
+| `vibe_find_symbol`            | Find symbol definitions          |
+| `vibe_find_references`        | Find references                  |
+| `vibe_analyze_complexity`     | Analyze complexity               |
+| `vibe_validate_code_quality`  | Validate quality                 |
+
+### Memory & Session
+
+| Tool                          | Purpose                          |
+|-------------------------------|----------------------------------|
+| `vibe_start_session`          | Restore previous session context |
+| `vibe_auto_save_context`      | Save current state               |
+| `vibe_save_memory`            | Save important decisions         |
+
+### Session RAG (v2.6.27)
+
+구조화된 세션 컨텍스트를 저장/검색하는 시스템. SQLite + FTS5 BM25 하이브리드 검색.
+
+| Tool                          | Purpose                          |
+|-------------------------------|----------------------------------|
+| `save_session_item`           | Decision/Constraint/Goal/Evidence 저장 |
+| `retrieve_session_context`    | 하이브리드 검색 (BM25 + recency + priority) |
+| `manage_goals`                | Goal 생명주기 관리 (list/update/complete) |
+
+**4가지 엔티티:**
+
+| Entity | Description | Key Fields |
+|--------|-------------|------------|
+| Decision | 사용자 확인 결정사항 | title, rationale, alternatives, impact, priority |
+| Constraint | 명시적 제약조건 | title, type (technical/business/resource/quality), severity |
+| Goal | 현재 목표 스택 (계층 지원) | title, status, priority, progressPercent, successCriteria |
+| Evidence | 검증/테스트 결과 | title, type (test/build/lint/coverage), status, metrics |
+
+**자동 주입:** `start_session` 호출 시 활성 Goals, 중요 Constraints, 최근 Decisions가 자동으로 세션 컨텍스트에 포함됨.
+
+```typescript
+import { saveSessionItem, retrieveSessionContext, manageGoals } from '@su-record/vibe/tools';
+
+// 결정 저장
+await saveSessionItem({ itemType: 'decision', title: 'Use Vitest', rationale: 'Fast and modern' });
+
+// 제약 저장
+await saveSessionItem({ itemType: 'constraint', title: 'No vector DB', type: 'technical', severity: 'high' });
+
+// 목표 저장
+await saveSessionItem({ itemType: 'goal', title: 'Implement Session RAG', priority: 2 });
+
+// 컨텍스트 검색
+await retrieveSessionContext({ query: 'testing' });
+
+// 목표 관리
+await manageGoals({ action: 'list' });
+await manageGoals({ action: 'update', goalId: 1, progressPercent: 80 });
+await manageGoals({ action: 'complete', goalId: 1 });
+```
+
+## Agents
+
+- **Review (12)**: security, performance, architecture, complexity, simplicity, data-integrity, test-coverage, git-history, python, typescript, rails, react reviewers → `.claude/agents/review/`
+- **Research (4)**: best-practices, framework-docs, codebase-patterns, security-advisory → `.claude/agents/research/`
+
+## Context Management
+
+### Model Selection
+
+- **Exploration/Search**: Haiku
+- **Implementation**: Sonnet
+- **Architecture**: Opus
+
+### At 70%+ Context
+
+- Do NOT use `/compact` (information loss risk)
+- Use `save_memory` → `/new` for new session
+- Restore with `/vibe.utils --continue`
+
+## Documentation Guidelines
+
+- Avoid ASCII boxes → Use Mermaid diagrams, Markdown tables, or indented lists
+- Flowcharts → Mermaid | Structure → Indented lists | Comparisons → Tables
+
+## Git Commit Rules
+
+**Must include:** `.claude/vibe/specs/`, `.claude/vibe/features/`, `.claude/vibe/todos/`, `.claude/vibe/config.json`, `CLAUDE.md`
+
+**Exclude:** `~/.claude/vibe/rules/`, `~/.claude/commands/`, `~/.claude/agents/`, `~/.claude/skills/`, `.claude/settings.local.json`
+
+<!-- VIBE:END -->

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Su
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Su
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.