@su-record/vibe 2.9.24 → 2.9.32

package/vibe/rules/writing/document-style.md

@@ -1,74 +1,74 @@
-# 📝 문서 작성 스타일 규칙
-
-> 문서(.md) 작성 시 자동 적용되는 품질 기준
-
-## 일반 가이드라인
-
-| 항목 | 기준 |
-|------|------|
-| 언어 | 한국어 |
-| 톤 | 명확, 간결, 전문적이면서 이해하기 쉽게 |
-| 이모지 | 제목/부제목/목록에 문맥 관련 이모지 적절 사용. 과도한 사용 지양 |
-| 형식 | 마크다운(`.md`) |
-| 일관성 | 용어, 스타일, 문서 구조 통일 |
-
-## 내용 작성 규칙
-
-### 정확성
-- 제공된 정보/기획 문서 기반으로 **정확한 내용** 작성
-- 추측이나 확인되지 않은 정보 금지
-- 추상적 설명보다 **구체적 예시, 코드 스니펫, 단계별 지침** 포함
-
-### 인용
-- 첨부 파일 내용 참조 시 해당 내용 뒤에 출처 표기
-
-### 링크
-- 다른 문서 링크는 정확한 **상대 경로** 사용
-- 헤딩 ID 기반 앵커 링크 정확히 작동하도록 작성
-
-### 참조 금지 원칙
-- 아직 생성되지 않은 파일 참조 금지
-- 모든 필요한 코드는 **문서 내에 완전히 포함**
-- "나머지는 X 파일 참조" 같은 표현 금지
-- 각 문서는 **독립적으로 완전**해야 함
-
-### 자리 표시자
-- 다이어그램, 미확정 사항, 추후 추가 내용은 `[TODO]` 또는 `[PLACEHOLDER]`로 명확 표기
-
-## 분량 가이드라인
-
-| 항목 | 기준 |
-|------|------|
-| 적정 분량 | 5-7분 읽기 (1,500-2,000 단어) |
-| 코드 포함 시 | 최대 3,000줄 이내 |
-| 목차 | 스크롤 없이 한 화면에 보이도록 |
-
-## 간결성 원칙
-
-- **핵심 코드 + 간단한 설명**만 포함
-- 예제는 대표적인 것 **1-2개**만
-- 중복 설명 제거, 한 번만 명확히
-
-## 실행 중심 구성
-
-- "이렇게 하세요" 방식의 **명확한 지시문**
-- 복사해서 바로 사용 가능한 **실행 가능한 코드**
-- 체크리스트 중심의 검증 가능한 내용
-
-## 구분 명확화
-
-- **[필수]** vs **[선택]** 항목 명확 표시
-- 코드 블록에 **파일 경로** 항상 명시
-- 환경별 차이는 **조건문**으로 한 번에 표현
-
-## AI 최적화
-
-- 긴 설명보다 **주석이 포함된 코드** 선호
-- 복잡한 개념은 **다이어그램**이나 **표**로 요약
-- 각 섹션은 **독립적으로 이해 가능**하게 작성
-
-## 상호작용
-
-- 초안 작성 완료 후 사용자 확인 요청
-- 사용자 피드백 반영하여 수정
-- 답변은 간략하게, 다음 스텝 진행 여부를 물어보는 수준
+# 📝 문서 작성 스타일 규칙
+
+> 문서(.md) 작성 시 자동 적용되는 품질 기준
+
+## 일반 가이드라인
+
+| 항목 | 기준 |
+|------|------|
+| 언어 | 한국어 |
+| 톤 | 명확, 간결, 전문적이면서 이해하기 쉽게 |
+| 이모지 | 제목/부제목/목록에 문맥 관련 이모지 적절 사용. 과도한 사용 지양 |
+| 형식 | 마크다운(`.md`) |
+| 일관성 | 용어, 스타일, 문서 구조 통일 |
+
+## 내용 작성 규칙
+
+### 정확성
+- 제공된 정보/기획 문서 기반으로 **정확한 내용** 작성
+- 추측이나 확인되지 않은 정보 금지
+- 추상적 설명보다 **구체적 예시, 코드 스니펫, 단계별 지침** 포함
+
+### 인용
+- 첨부 파일 내용 참조 시 해당 내용 뒤에 출처 표기
+
+### 링크
+- 다른 문서 링크는 정확한 **상대 경로** 사용
+- 헤딩 ID 기반 앵커 링크 정확히 작동하도록 작성
+
+### 참조 금지 원칙
+- 아직 생성되지 않은 파일 참조 금지
+- 모든 필요한 코드는 **문서 내에 완전히 포함**
+- "나머지는 X 파일 참조" 같은 표현 금지
+- 각 문서는 **독립적으로 완전**해야 함
+
+### 자리 표시자
+- 다이어그램, 미확정 사항, 추후 추가 내용은 `[TODO]` 또는 `[PLACEHOLDER]`로 명확 표기
+
+## 분량 가이드라인
+
+| 항목 | 기준 |
+|------|------|
+| 적정 분량 | 5-7분 읽기 (1,500-2,000 단어) |
+| 코드 포함 시 | 최대 3,000줄 이내 |
+| 목차 | 스크롤 없이 한 화면에 보이도록 |
+
+## 간결성 원칙
+
+- **핵심 코드 + 간단한 설명**만 포함
+- 예제는 대표적인 것 **1-2개**만
+- 중복 설명 제거, 한 번만 명확히
+
+## 실행 중심 구성
+
+- "이렇게 하세요" 방식의 **명확한 지시문**
+- 복사해서 바로 사용 가능한 **실행 가능한 코드**
+- 체크리스트 중심의 검증 가능한 내용
+
+## 구분 명확화
+
+- **[필수]** vs **[선택]** 항목 명확 표시
+- 코드 블록에 **파일 경로** 항상 명시
+- 환경별 차이는 **조건문**으로 한 번에 표현
+
+## AI 최적화
+
+- 긴 설명보다 **주석이 포함된 코드** 선호
+- 복잡한 개념은 **다이어그램**이나 **표**로 요약
+- 각 섹션은 **독립적으로 이해 가능**하게 작성
+
+## 상호작용
+
+- 초안 작성 완료 후 사용자 확인 요청
+- 사용자 피드백 반영하여 수정
+- 답변은 간략하게, 다음 스텝 진행 여부를 물어보는 수준

package/vibe/setup.sh

@@ -1,31 +1,31 @@
-#!/bin/bash
-# Core 협업자 자동 설치 스크립트
-# 사용법: ./.claude/vibe/setup.sh
-
-set -e
-
-echo "🔧 Core 설치 확인 중..."
-
-# npm/npx 확인
-if ! command -v npx &> /dev/null; then
-    echo "❌ Node.js/npm이 설치되어 있지 않습니다."
-    echo "   https://nodejs.org 에서 설치해주세요."
-    exit 1
-fi
-
-# core 설치 확인 및 업데이트
-if command -v vibe &> /dev/null; then
-    echo "✅ Vibe가 이미 설치되어 있습니다."
-    vibe update --silent
-    echo "✅ Core 업데이트 완료!"
-else
-    echo "📦 Core 설치 중..."
-    npm install -g @su-record/vibe
-    vibe update --silent
-    echo "✅ Core 설치 및 설정 완료!"
-fi
-
-echo ""
-echo "다음 명령어로 시작하세요:"
-echo "  /vibe.spec \"기능명\"    SPEC 작성"
-echo "  /vibe.run \"기능명\"     구현 실행"
+#!/bin/bash
+# Core 협업자 자동 설치 스크립트
+# 사용법: ./.claude/vibe/setup.sh
+
+set -e
+
+echo "🔧 Core 설치 확인 중..."
+
+# npm/npx 확인
+if ! command -v npx &> /dev/null; then
+    echo "❌ Node.js/npm이 설치되어 있지 않습니다."
+    echo "   https://nodejs.org 에서 설치해주세요."
+    exit 1
+fi
+
+# core 설치 확인 및 업데이트
+if command -v vibe &> /dev/null; then
+    echo "✅ Vibe가 이미 설치되어 있습니다."
+    vibe update --silent
+    echo "✅ Core 업데이트 완료!"
+else
+    echo "📦 Core 설치 중..."
+    npm install -g @su-record/vibe
+    vibe update --silent
+    echo "✅ Core 설치 및 설정 완료!"
+fi
+
+echo ""
+echo "다음 명령어로 시작하세요:"
+echo "  /vibe.spec \"기능명\"    SPEC 작성"
+echo "  /vibe.run \"기능명\"     구현 실행"

package/vibe/templates/claudemd-template.md

@@ -1,74 +1,74 @@
-# VIBE
-
-> **vibe = Easy vibe coding + Minimum quality guaranteed**
-
-## Constraints
-
-- **Modify only requested scope** — Don't touch unrelated code
-- **Preserve existing style** — Follow project conventions
-- **Edit existing files, never create new ones** — Fix problems at source
-
-### Complexity Limits
-
-| Metric | Limit |
-|--------|-------|
-| Function length | ≤50 lines |
-| Nesting depth | ≤3 levels |
-| Parameters | ≤5 |
-| Cyclomatic complexity | ≤10 |
-
-### Forbidden Patterns
-
-- No `console.log` in commits
-- No hardcoded strings/numbers (use constants)
-- No commented-out code
-- No `any` type — use `unknown` + type guards
-
-## Project Structure
-
-| Folder | Owner | Purpose |
-|--------|-------|---------|
-| `src/` | Human+AI | Business logic |
-| `docs/` | **Human** | Business rules, domain definitions, ADR — **read before starting work** |
-| `tests/` | Human+AI | Test infrastructure |
-| `.dev/` | **AI** | Learnings, troubleshooting logs, scratch files |
-| `.claude/` | AI | Configuration, rules, skills |
-
-## References
-
-- **Rules**: See `.claude/vibe/config.json` → `references.rules[]`
-- **Language standards**: See `.claude/vibe/languages/`
-- **Constitution**: See `.claude/vibe/constitution.md`
-
-## Workflow
-
-| Task Size | Approach |
-|-----------|----------|
-| 1-2 files | Plan Mode |
-| 3+ files | `/vibe.spec` — single entry point, orchestrates everything |
-| Analyze target | `/vibe.analyze` — code, documents, websites, Figma |
-| Check Harness | `/vibe.harness` — diagnose project maturity |
-| Project structure | `/vibe.scaffold` — generate optimized folder structure |
-
-## Magic Keywords
-
-| Keyword | Effect |
-|---------|--------|
-| `ultrawork` / `ulw` | Parallel agents + auto-continue |
-| `ralph` | Iterate until 100% complete |
-| `quick` | Fast mode, minimal verification |
-
-## Quality Gate
-
-Convergence Principle: loop until P1 = 0. Changed files only.
-
-## Context Management
-
-At 70%+ context: `save_memory` → `/new` → `/vibe.utils --continue`
-
-## Git Commit Rules
-
-**Include:** `.claude/vibe/plans/`, `.claude/vibe/specs/`, `.claude/vibe/features/`, `.claude/vibe/config.json`, `CLAUDE.md`
-**Exclude:** `~/.claude/vibe/rules/`, `~/.claude/commands/`, `~/.claude/agents/`, `~/.claude/skills/`, `.claude/settings.local.json`
-
-<!-- VIBE:END -->
+# VIBE
+
+> **vibe = Easy vibe coding + Minimum quality guaranteed**
+
+## Constraints
+
+- **Modify only requested scope** — Don't touch unrelated code
+- **Preserve existing style** — Follow project conventions
+- **Prefer editing existing files** — Fix problems at source. Create new files when the task explicitly requires them (user-requested feature, new module, scaffolding). An explicit user request overrides this default.
+
+### Complexity Limits
+
+| Metric | Limit |
+|--------|-------|
+| Function length | ≤50 lines |
+| Nesting depth | ≤3 levels |
+| Parameters | ≤5 |
+| Cyclomatic complexity | ≤10 |
+
+### Forbidden Patterns
+
+- No `console.log` in commits
+- No hardcoded strings/numbers (use constants)
+- No commented-out code
+- No `any` type — use `unknown` + type guards
+
+## Project Structure
+
+| Folder | Owner | Purpose |
+|--------|-------|---------|
+| `src/` | Human+AI | Business logic |
+| `docs/` | **Human** | Business rules, domain definitions, ADR — **read before starting work** |
+| `tests/` | Human+AI | Test infrastructure |
+| `.dev/` | **AI** | Learnings, troubleshooting logs, scratch files |
+| `.claude/` | AI | Configuration, rules, skills |
+
+## References
+
+- **Rules**: See `.claude/vibe/config.json` → `references.rules[]`
+- **Language standards**: See `.claude/vibe/languages/`
+- **Constitution**: See `.claude/vibe/constitution.md`
+
+## Workflow
+
+| Task Size | Approach |
+|-----------|----------|
+| 1-2 files | Plan Mode |
+| 3+ files | `/vibe.spec` — single entry point, orchestrates everything |
+| Analyze target | `/vibe.analyze` — code, documents, websites, Figma |
+| Check Harness | `/vibe.harness` — diagnose project maturity |
+| Project structure | `/vibe.scaffold` — generate optimized folder structure |
+
+## Magic Keywords
+
+| Keyword | Effect |
+|---------|--------|
+| `ultrawork` / `ulw` | Parallel agents + auto-continue |
+| `ralph` | Iterate until 100% complete |
+| `quick` | Fast mode, minimal verification |
+
+## Quality Gate
+
+Convergence Principle: loop until P1 = 0. Changed files only.
+
+## Context Management
+
+At 70%+ context: `save_memory` → `/new` → `/vibe.utils --continue`
+
+## Git Commit Rules
+
+**Include:** `.claude/vibe/plans/`, `.claude/vibe/specs/`, `.claude/vibe/features/`, `.claude/vibe/config.json`, `CLAUDE.md`
+**Exclude:** `~/.claude/vibe/rules/`, `~/.claude/commands/`, `~/.claude/agents/`, `~/.claude/skills/`, `.claude/settings.local.json`
+
+<!-- VIBE:END -->