solmate-skills 1.0.2 → 2.0.0

package/ext-k-skill/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: ext-k-skill
+description: External collection of Korean-specific specialized skills. Includes law search, delivery tracking, transportation booking (KTX/SRT), and more. Use this for tasks requiring localized Korean data or services.
+---
+
+# External K-Skill Library
+
+This is a comprehensive collection of **Korean localized tools and services**. It provides specialized logic for interacting with various Korean platforms and data sources.
+
+> **Source of Truth**: Refer to [README.md](./README.md) and the individual package directories for detailed documentation on each sub-skill.
+
+## 1. Included Sub-Skills
+- **Public Services**: Law search (`korean-law-search`), fine dust location (`fine-dust-location`).
+- **Logistics & Transport**: Delivery tracking (`delivery-tracking`), KTX/SRT booking.
+- **Ecommerce**: Coupang/Daiso product search.
+- **Leisure**: KBO/K-League results, Lotto, neighborhood bar search.
+
+## 2. Usage Instructions
+1. Navigate to the specific subdirectory for the task at hand.
+2. Read the local `README.md` or `SKILL.md` within that subdirectory (if available).
+3. Follow the specific API or script instructions provided in the external library.

package/hooks/install.sh

@@ -0,0 +1,131 @@
+#!/usr/bin/env bash
+# solmate-skills: install.sh
+# Purpose: Install Solmate hook scripts into the current project's .claude/ directory
+#          and merge hook configuration into .claude/settings.json.
+# Usage:   bash .agent/skills/hooks/install.sh
+#          (or run from any location: bash <path-to-hooks>/install.sh)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(pwd)"
+CLAUDE_DIR="$PROJECT_ROOT/.claude"
+HOOKS_DIR="$CLAUDE_DIR/hooks"
+SETTINGS_FILE="$CLAUDE_DIR/settings.json"
+
+echo "Solmate Skills — Hook Installer"
+echo "Project: $PROJECT_ROOT"
+echo ""
+
+# --- Step 1: Create .claude/hooks/ ---
+mkdir -p "$HOOKS_DIR"
+echo "[1/4] Created $HOOKS_DIR"
+
+# --- Step 2: Copy hook scripts ---
+cp "$SCRIPT_DIR/suggest-skills.sh" "$HOOKS_DIR/solmate-suggest.sh"
+cp "$SCRIPT_DIR/watch-files.sh"    "$HOOKS_DIR/solmate-watch.sh"
+chmod +x "$HOOKS_DIR/solmate-suggest.sh"
+chmod +x "$HOOKS_DIR/solmate-watch.sh"
+echo "[2/4] Copied hook scripts:"
+echo "      .claude/hooks/solmate-suggest.sh  (UserPromptSubmit)"
+echo "      .claude/hooks/solmate-watch.sh    (PreToolUse)"
+
+# --- Step 3: Merge hook config into settings.json ---
+echo "[3/4] Merging hook config into $SETTINGS_FILE"
+
+python3 - "$SETTINGS_FILE" <<'PYEOF'
+import sys, json, os
+
+settings_path = sys.argv[1]
+
+# Load existing settings or start fresh
+if os.path.exists(settings_path):
+    with open(settings_path, 'r') as f:
+        try:
+            settings = json.load(f)
+        except json.JSONDecodeError:
+            print(f"  WARNING: {settings_path} has invalid JSON. Backing up and starting fresh.")
+            os.rename(settings_path, settings_path + '.bak')
+            settings = {}
+else:
+    settings = {}
+
+hooks = settings.setdefault('hooks', {})
+
+# --- UserPromptSubmit hook ---
+suggest_cmd = "bash .claude/hooks/solmate-suggest.sh"
+submit_hooks = hooks.setdefault('UserPromptSubmit', [])
+
+# Check for duplicate
+already_has_suggest = any(
+    h.get('command') == suggest_cmd
+    for entry in submit_hooks
+    for h in entry.get('hooks', [])
+)
+if not already_has_suggest:
+    submit_hooks.append({
+        "hooks": [{
+            "type": "command",
+            "command": suggest_cmd,
+            "timeout": 5
+        }]
+    })
+    print("  Added: UserPromptSubmit → solmate-suggest.sh")
+else:
+    print("  Skipped (already exists): UserPromptSubmit → solmate-suggest.sh")
+
+# --- PreToolUse hook ---
+watch_cmd = "bash .claude/hooks/solmate-watch.sh"
+pre_hooks = hooks.setdefault('PreToolUse', [])
+
+already_has_watch = any(
+    h.get('command') == watch_cmd
+    for entry in pre_hooks
+    for h in entry.get('hooks', [])
+)
+if not already_has_watch:
+    pre_hooks.append({
+        "matcher": "Read|Write|Edit|Bash",
+        "hooks": [{
+            "type": "command",
+            "command": watch_cmd,
+            "timeout": 5
+        }]
+    })
+    print("  Added: PreToolUse (Read|Write|Edit|Bash) → solmate-watch.sh")
+else:
+    print("  Skipped (already exists): PreToolUse → solmate-watch.sh")
+
+# Write back
+os.makedirs(os.path.dirname(settings_path), exist_ok=True)
+with open(settings_path, 'w') as f:
+    json.dump(settings, f, indent=2, ensure_ascii=False)
+    f.write('\n')
+
+print(f"  Saved: {settings_path}")
+PYEOF
+
+# --- Step 4: Add .claude/hooks/ to .gitignore if not already there ---
+GITIGNORE="$PROJECT_ROOT/.gitignore"
+if [ -f "$GITIGNORE" ]; then
+  if ! grep -q "\.claude/hooks/" "$GITIGNORE" 2>/dev/null; then
+    echo "" >> "$GITIGNORE"
+    echo "# Solmate hook scripts (project-local)" >> "$GITIGNORE"
+    echo ".claude/hooks/" >> "$GITIGNORE"
+    echo "[4/4] Added .claude/hooks/ to .gitignore"
+  else
+    echo "[4/4] .gitignore already excludes .claude/hooks/"
+  fi
+else
+  echo "[4/4] No .gitignore found — skipping"
+fi
+
+echo ""
+echo "Done. Hooks are active in this project."
+echo ""
+echo "What was installed:"
+echo "  UserPromptSubmit  → detects keywords in your prompts → suggests relevant skills"
+echo "  PreToolUse        → detects file patterns being edited → suggests relevant skills"
+echo ""
+echo "To review or disable hooks, open /hooks in Claude Code."
+echo "To uninstall, remove .claude/hooks/ and the 'hooks' section from .claude/settings.json."

package/hooks/suggest-skills.sh

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+# solmate-skills: suggest-skills.sh
+# Event: UserPromptSubmit
+# Purpose: Detect keywords in user prompt and inject skill suggestions as context.
+# Output: JSON with hookSpecificOutput.additionalContext (non-blocking)
+
+set -euo pipefail
+
+# Read stdin JSON
+INPUT=$(cat)
+
+# Extract the user prompt text
+PROMPT=$(echo "$INPUT" | python3 -c "
+import sys, json
+data = json.load(sys.stdin)
+# UserPromptSubmit provides 'prompt' field
+print(data.get('prompt', ''))
+" 2>/dev/null || echo "")
+
+if [ -z "$PROMPT" ]; then
+  exit 0
+fi
+
+SUGGESTIONS=""
+
+# --- Keyword matching (Korean + English) ---
+
+# Decision / Design → manage-decisions
+if echo "$PROMPT" | grep -qiE '결정|설계|어떻게 할|어떤 방식|DB 스키마|테이블|API 구조|아키텍처|폴더 구조|기능 범위|MVP|스택|라이브러리|어떤 거|어떤게'; then
+  SUGGESTIONS="$SUGGESTIONS\n- 결정이 필요한 상황입니다. \`/manage-decisions\`를 실행하면 유형별 질문 템플릿으로 대화를 통해 결정을 이끌어냅니다."
+fi
+
+# Security → verify-security
+if echo "$PROMPT" | grep -qiE '보안|security|취약|OWASP|인증|인가|token|jwt|secret|API ?key|sql|injection|xss|csrf'; then
+  SUGGESTIONS="$SUGGESTIONS\n- 보안 관련 작업입니다. \`/verify-security\`로 OWASP Top 10 기준 점검을 실행하세요."
+fi
+
+# Performance → verify-performance
+if echo "$PROMPT" | grep -qiE '성능|performance|lighthouse|느리|느림|최적화|LCP|CLS|FID|번들|bundle|이미지 최적|lazy|loading'; then
+  SUGGESTIONS="$SUGGESTIONS\n- 성능 관련 작업입니다. \`/verify-performance\`로 Lighthouse 및 Core Web Vitals 점검을 실행하세요."
+fi
+
+# PR / Commit / Code review → verify-code
+if echo "$PROMPT" | grep -qiE 'PR|pull ?request|코드 ?리뷰|review|commit|머지|merge|배포 전|pre-deploy'; then
+  SUGGESTIONS="$SUGGESTIONS\n- PR 또는 배포 전 점검입니다. \`/verify-code\`로 코드 품질을 종합 리뷰하고, \`/verify-implementation\`으로 전체 verify-* 스킬을 통합 실행하세요."
+fi
+
+# Documentation → verify-docs / docs-plan / docs-dev
+if echo "$PROMPT" | grep -qiE '문서|docs?|README|VISION|LEAN_CANVAS|PRODUCT_SPECS|API_SPECS|DB_SCHEMA|ROADMAP|백로그|backlog'; then
+  SUGGESTIONS="$SUGGESTIONS\n- 문서 작업입니다. 기획·UI 문서는 \`/docs-plan\`, 기술·진행·QA 문서는 \`/docs-dev\`, 문서 구조 검증은 \`/verify-docs\`를 사용하세요."
+fi
+
+# Feature implementation / workflow → rules-workflow
+if echo "$PROMPT" | grep -qiE '기능 ?구현|구현|implement|feature|작업 ?시작|어디서 ?시작|어떻게 ?시작|개발 ?시작|시작할게'; then
+  SUGGESTIONS="$SUGGESTIONS\n- 기능 구현을 시작하려 합니다. \`/rules-workflow\`로 18단계 워크플로우를 따라 계획부터 PR까지 진행하세요."
+fi
+
+# React / UI component → rules-react
+if echo "$PROMPT" | grep -qiE 'React|컴포넌트|component|페이지|page|UI|화면|shadcn|tailwind'; then
+  SUGGESTIONS="$SUGGESTIONS\n- React/UI 작업입니다. \`/rules-react\`로 컴포넌트 설계 기준을 확인하고, shadcn/ui 활용은 \`/tools-shadcn\`을 사용하세요."
+fi
+
+# Drizzle / DB schema → verify-drizzle-schema
+if echo "$PROMPT" | grep -qiE 'drizzle|schema\.ts|마이그레이션|migration|pgTable|sqliteTable'; then
+  SUGGESTIONS="$SUGGESTIONS\n- Drizzle 스키마 작업입니다. \`/verify-drizzle-schema\`로 스키마 정합성을 검증하세요."
+fi
+
+# New project / product pipeline → rules-product
+if echo "$PROMPT" | grep -qiE '새 프로젝트|신규 프로젝트|프로젝트 시작|어디서 시작|뭐부터|처음부터|from scratch'; then
+  SUGGESTIONS="$SUGGESTIONS\n- 새 프로젝트입니다. \`/rules-product\`를 실행하면 현재 단계를 자동 진단하고 올바른 스킬로 안내합니다."
+fi
+
+# Pitch deck / business plan → docs-pitch / docs-business
+if echo "$PROMPT" | grep -qiE '피치|pitch|투자|investor|사업 ?계획|business ?plan|데모데이|해커톤'; then
+  SUGGESTIONS="$SUGGESTIONS\n- 발표·투자 자료 작업입니다. 피치덱은 \`/docs-pitch\`, 사업계획서는 \`/docs-business\`를 사용하세요."
+fi
+
+# If no suggestions, exit silently
+if [ -z "$SUGGESTIONS" ]; then
+  exit 0
+fi
+
+# Output JSON with additionalContext (non-blocking)
+python3 -c "
+import json, sys
+suggestions = sys.argv[1]
+output = {
+    'hookSpecificOutput': {
+        'hookEventName': 'UserPromptSubmit',
+        'additionalContext': '[Solmate Skills 제안]\n' + suggestions.strip()
+    }
+}
+print(json.dumps(output))
+" "$SUGGESTIONS"

package/hooks/watch-files.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+# solmate-skills: watch-files.sh
+# Event: PreToolUse (matcher: Read|Write|Edit|Bash)
+# Purpose: Detect file patterns being modified and inject relevant skill suggestions.
+# Output: JSON with hookSpecificOutput.additionalContext (non-blocking)
+
+set -euo pipefail
+
+INPUT=$(cat)
+
+# Extract file path and tool name
+FILE_PATH=$(echo "$INPUT" | python3 -c "
+import sys, json
+data = json.load(sys.stdin)
+inp = data.get('tool_input', {})
+# Write/Edit use file_path; Bash use command
+print(inp.get('file_path', inp.get('command', '')))" 2>/dev/null || echo "")
+
+TOOL_NAME=$(echo "$INPUT" | python3 -c "
+import sys, json
+data = json.load(sys.stdin)
+print(data.get('tool_name', ''))" 2>/dev/null || echo "")
+
+if [ -z "$FILE_PATH" ]; then
+  exit 0
+fi
+
+SUGGESTIONS=""
+
+# --- File pattern matching ---
+
+# Drizzle schema file → verify-drizzle-schema
+if echo "$FILE_PATH" | grep -qiE 'schema\.(ts|js)|drizzle'; then
+  SUGGESTIONS="$SUGGESTIONS\n- Drizzle 스키마 파일을 수정 중입니다. 작업 후 \`/verify-drizzle-schema\`로 스키마 정합성을 검증하세요."
+fi
+
+# .env files → verify-security
+if echo "$FILE_PATH" | grep -qiE '\.env|\.env\.local|\.env\.production|\.env\.example'; then
+  SUGGESTIONS="$SUGGESTIONS\n- 환경변수 파일을 수정 중입니다. \`/verify-security\` Check 1(시크릿 노출)을 실행하여 민감 정보 노출 여부를 확인하세요."
+fi
+
+# SKILL.md files → manage-skills
+if echo "$FILE_PATH" | grep -qiE 'SKILL\.md'; then
+  SUGGESTIONS="$SUGGESTIONS\n- 스킬 파일을 수정 중입니다. \`/manage-skills\`로 verify 스킬과의 정합성 드리프트를 점검하세요."
+fi
+
+# Page/route files → verify-performance
+if echo "$FILE_PATH" | grep -qiE 'page\.(tsx|jsx|ts|js)|route\.(tsx|jsx|ts|js)|layout\.(tsx|jsx)'; then
+  SUGGESTIONS="$SUGGESTIONS\n- 페이지·라우트 파일을 수정 중입니다. 작업 후 \`/verify-performance\`로 Core Web Vitals 및 렌더링 전략을 점검하세요."
+fi
+
+# API route files → verify-security
+if echo "$FILE_PATH" | grep -qiE 'api/.*route\.(ts|js)|api/.*index\.(ts|js)|\bapi\b.*\.(ts|js)'; then
+  SUGGESTIONS="$SUGGESTIONS\n- API 라우트 파일을 수정 중입니다. 작업 후 \`/verify-security\` Check 2(인증·인가) 및 Check 5(CSRF)를 점검하세요."
+fi
+
+# Auth-related files → verify-security
+if echo "$FILE_PATH" | grep -qiE 'auth\.(ts|js|tsx)|middleware\.(ts|js)|session\.(ts|js)'; then
+  SUGGESTIONS="$SUGGESTIONS\n- 인증·미들웨어 파일을 수정 중입니다. \`/verify-security\`로 인증·인가 취약점을 점검하세요."
+fi
+
+# Documentation files → verify-docs
+if echo "$FILE_PATH" | grep -qiE 'docs/(01|02|03|04|05)_.*\.md'; then
+  SUGGESTIONS="$SUGGESTIONS\n- 문서 레이어 파일을 수정 중입니다. 작업 후 \`/verify-docs\`로 메타데이터 및 구조 정합성을 검증하세요."
+fi
+
+# AGENTS.md → remind about skill count
+if echo "$FILE_PATH" | grep -qiE 'AGENTS\.md'; then
+  SUGGESTIONS="$SUGGESTIONS\n- AGENTS.md를 수정 중입니다. 스킬 목록·개수가 변경된 경우 Section 4의 테이블과 개수를 함께 업데이트하세요."
+fi
+
+if [ -z "$SUGGESTIONS" ]; then
+  exit 0
+fi
+
+python3 -c "
+import json, sys
+suggestions = sys.argv[1]
+output = {
+    'hookSpecificOutput': {
+        'hookEventName': 'PreToolUse',
+        'additionalContext': '[Solmate Skills 파일 감지]\n' + suggestions.strip()
+    }
+}
+print(json.dumps(output))
+" "$SUGGESTIONS"

package/manage-decisions/SKILL.md

@@ -0,0 +1,215 @@
+---
+name: manage-decisions
+description: 프로젝트 진행 중 결정이 필요한 순간에 올바른 질문을 던지고 대화를 통해 결정을 이끌어냅니다. 기술 선택, 기능 범위, DB 설계, API 구조, UX 방향, 아키텍처 등 6개 결정 유형별 질문 템플릿을 제공합니다. "이거 어떻게 할까요?", "결정이 필요합니다", 또는 설계/구조 논의 시 사용합니다.
+argument-hint: "[선택사항: 결정 유형 또는 주제 (예: DB 설계, API 구조, 기능 범위)]"
+---
+
+# 결정 관리 스킬 (manage-decisions)
+
+프로젝트를 진행하다 보면 AI가 독단적으로 결정해서는 안 되는 순간들이 있습니다. 이 스킬은 그 순간을 인식하고, 결정 유형에 맞는 질문을 사용자에게 던져 충분한 대화와 맥락을 바탕으로 결정이 이루어지도록 합니다.
+
+**원칙**: 결정을 내리기 전에 먼저 묻는다. 추측하거나 "일반적으로는" 식의 답변으로 진행하지 않는다.
+
+---
+
+## 실행 시점
+
+- "이거 어떻게 할까요?", "어떤 방식이 좋을까요?" 질문을 받았을 때
+- 기술 스택·라이브러리·패턴을 선택해야 할 때
+- 기능 범위를 정의하거나 MVP 경계를 정해야 할 때
+- DB 스키마·API 구조·아키텍처 설계를 시작하기 전
+- `rules-workflow` Step 1~4 (계획 수립·검토) 수행 중 결정이 필요할 때
+- `rules-product` 각 Phase 진입 전 핵심 방향을 잡을 때
+
+---
+
+## Step 0: 결정 유형 파악
+
+사용자의 요청 또는 현재 맥락에서 아래 6개 유형 중 하나를 먼저 식별한다. 유형이 복수인 경우 우선순위가 높은 것부터 순서대로 진행한다.
+
+| 유형 | 키워드 | 대표 상황 |
+|------|--------|-----------|
+| A. 기술 선택 | 스택, 라이브러리, 프레임워크, 도구 | "ORM은 뭘 쓸까요?", "상태관리는?" |
+| B. 기능 범위 | MVP, 기능, 우선순위, 범위, 스코프 | "이 기능도 넣을까요?", "MVP 범위는?" |
+| C. DB 설계 | 테이블, 스키마, 관계, 필드, 인덱스 | "테이블을 어떻게 나눌까요?" |
+| D. API 설계 | 엔드포인트, REST, 응답 구조, 인증 | "API 구조를 어떻게 잡을까요?" |
+| E. UX·UI 방향 | 화면, 흐름, 레이아웃, 인터랙션 | "이 화면은 어떻게 구성할까요?" |
+| F. 아키텍처 | 구조, 레이어, 모듈, 배포, 확장성 | "폴더 구조를 어떻게 잡을까요?" |
+
+---
+
+## Type A: 기술 선택
+
+**목적**: 필연적인 기술 선택. "일반적으로 많이 쓰여서"가 아니라 프로젝트 요구사항에서 이 기술이 필요한 이유를 먼저 확인한다.
+
+**질문 순서**:
+
+1. **제약 조건 먼저**: 현재 프로젝트의 기술 스택(언어, 런타임, 배포 환경)에서 이미 확정된 것은 무엇인가?
+2. **핵심 요구사항**: 이 기술을 선택하는 핵심 기능적 이유는 무엇인가? (예: 실시간 필요 → WebSocket, 타입 안전 DB 쿼리 필요 → Drizzle/Prisma)
+3. **트레이드오프 인식**: 후보 옵션들의 장단점을 비교해도 되는가? (예: A는 기능이 많지만 번들이 크고, B는 가볍지만 커뮤니티가 작다)
+4. **팀 친숙도**: 현재 팀(또는 본인)이 이 기술에 얼마나 익숙한가? 학습 비용이 허용되는가?
+5. **미래 의존성**: 이 선택이 나중에 교체하기 어려운 결정인가? (예: DB 종류, 인증 라이브러리)
+
+**결정 기록 형식**:
+```
+결정: [선택한 기술]
+이유: [핵심 이유 1-2줄]
+포기한 대안: [대안] — [포기 이유]
+재검토 조건: [이 결정을 바꿔야 하는 상황]
+```
+
+---
+
+## Type B: 기능 범위
+
+**목적**: AI가 임의로 기능을 추가하거나 제외하지 않도록 범위를 사용자와 함께 확정한다.
+
+**질문 순서**:
+
+1. **현재 단계 확인**: 지금이 MVP인가, 이후 버전인가? Phase 1(기획) 문서에 정의된 MVP 범위가 있는가?
+2. **Must Have vs Nice to Have**: 이 기능이 없으면 핵심 가치(UVP)가 전달되지 않는가, 아니면 있으면 좋은 수준인가?
+3. **사용자 여정 필수성**: 이 기능 없이 사용자가 핵심 목표를 달성할 수 없는가?
+4. **구현 비용 인식**: 이 기능의 구현 복잡도가 다른 기능들에 비해 어느 수준인가? 이 비용이 가치에 비례하는가?
+5. **제외 시 영향**: 이 기능을 이번 버전에서 제외하면 어떤 문제가 생기는가?
+
+**결정 기록 형식**:
+```
+기능: [기능명]
+결정: 포함 / 제외 / 다음 버전
+이유: [결정 근거]
+제외 시 대안: [없으면 "없음"]
+```
+
+---
+
+## Type C: DB 설계
+
+**목적**: 스키마 결정은 나중에 바꾸기 어렵다. 충분한 논의 없이 진행하지 않는다.
+
+**질문 순서**:
+
+1. **데이터 성격**: 이 데이터는 관계형(정형)인가, 비정형인가? 어떤 쿼리 패턴이 가장 빈번한가?
+2. **소유권과 관계**: 이 엔티티는 누가 소유하는가? (User → Post → Comment 같은 계층 구조가 있는가?)
+3. **확장 가능성**: 이 테이블에 나중에 어떤 필드가 추가될 가능성이 높은가? 지금 설계가 그것을 수용하는가?
+4. **삭제 정책**: 레코드 삭제 시 `hard delete`인가, `soft delete`(deleted_at)인가? 관련 데이터는 어떻게 처리하는가?
+5. **인덱스 우선순위**: 가장 자주 조회되는 필드 조합은 무엇인가? (검색, 필터, 정렬 기준)
+6. **민감 데이터**: 이 테이블에 PII(개인식별정보)가 포함되는가? 암호화·접근 제한이 필요한가?
+
+**결정 기록 형식**:
+```
+테이블: [테이블명]
+주요 결정: [핵심 설계 선택사항]
+이유: [결정 근거]
+주의사항: [나중에 재검토가 필요한 부분]
+```
+
+---
+
+## Type D: API 설계
+
+**목적**: 클라이언트-서버 계약(contract)은 한번 노출되면 바꾸기 어렵다. 구현 전에 구조를 먼저 합의한다.
+
+**질문 순서**:
+
+1. **클라이언트 요구사항**: 이 API를 호출하는 클라이언트는 무엇인가? (웹/앱/외부 파트너) 각자 필요한 데이터 형태가 다른가?
+2. **인증 방식**: 이 엔드포인트는 인증이 필요한가? 어떤 인증 방식을 사용하는가? (세션, JWT, API Key)
+3. **응답 구조**: 성공·실패 응답의 표준 형식이 있는가? 페이지네이션이 필요한가?
+4. **버전 관리**: API 버전 관리 전략이 있는가? (`/api/v1/`) 현재 명세 변경이 기존 클라이언트에 영향을 주는가?
+5. **에러 처리**: 어떤 에러 케이스가 예상되는가? 클라이언트가 각 에러를 어떻게 처리해야 하는가?
+6. **부작용 범위**: 이 API 호출이 다른 데이터에 side effect를 일으키는가? (예: 주문 생성 → 재고 차감 → 알림 발송)
+
+**결정 기록 형식**:
+```
+엔드포인트: [METHOD /path]
+결정: [설계 선택사항]
+이유: [결정 근거]
+미확정 사항: [추후 확인 필요한 부분]
+```
+
+---
+
+## Type E: UX·UI 방향
+
+**목적**: 화면 구성·흐름·인터랙션은 사용자 경험에 직결된다. AI가 임의로 레이아웃을 결정하지 않는다.
+
+**질문 순서**:
+
+1. **사용자 목표**: 이 화면에서 사용자가 달성하려는 핵심 목표는 무엇인가? 가장 빈번한 액션은?
+2. **진입 경로**: 사용자가 이 화면에 어떻게 도달하는가? 이전 화면의 맥락이 이 화면에 영향을 주는가?
+3. **정보 우선순위**: 이 화면에서 가장 먼저 눈에 들어와야 하는 요소는 무엇인가? (CTA, 핵심 정보, 상태)
+4. **빈 상태(Empty State)**: 데이터가 없을 때 어떻게 보여야 하는가? 사용자에게 다음 행동을 유도하는가?
+5. **에러·로딩 상태**: 로딩 중, 에러 발생 시 화면을 어떻게 처리하는가?
+6. **모바일 우선 여부**: 이 화면은 모바일에서 더 많이 사용되는가? 반응형 레이아웃 전략이 있는가?
+
+**결정 기록 형식**:
+```
+화면: [화면명]
+핵심 결정: [레이아웃·흐름·인터랙션 선택]
+이유: [결정 근거]
+확인 필요: [사용자 테스트 또는 추가 검토 필요한 부분]
+```
+
+---
+
+## Type F: 아키텍처
+
+**목적**: 폴더 구조, 레이어 분리, 모듈 경계는 팀 전체 생산성에 영향을 준다. 한 명이 독단적으로 결정하지 않는다.
+
+**질문 순서**:
+
+1. **팀 규모와 협업 방식**: 이 프로젝트는 혼자 진행하는가, 팀으로 진행하는가? 도메인별로 역할이 나뉘는가?
+2. **성장 예측**: 6개월 후 코드베이스 규모가 지금의 몇 배가 될 것 같은가? 현재 구조가 그것을 수용하는가?
+3. **레이어 경계**: 비즈니스 로직, 데이터 접근, UI를 어디서 분리할 것인가? (예: `services/`, `repositories/`, `components/`)
+4. **공유 코드 전략**: 여러 페이지·기능에서 공통으로 쓰이는 코드(유틸, 훅, 타입)를 어디에 두는가?
+5. **의존성 방향**: 모듈 간 의존성이 단방향인가? 순환 의존성이 발생할 가능성이 있는가?
+6. **배포 단위**: 모노레포인가 멀티레포인가? 프론트·백을 분리 배포하는가?
+
+**결정 기록 형식**:
+```
+결정: [아키텍처 선택사항]
+이유: [결정 근거]
+전제 조건: [이 구조가 성립하는 조건]
+재검토 시점: [이 결정을 다시 봐야 하는 상황]
+```
+
+---
+
+## 결정 기록 저장
+
+중요한 결정은 다음 경로에 누적 기록한다:
+
+```
+docs/04_Logic_Progress/03_DECISION_LOG.md
+```
+
+형식:
+```markdown
+# Decision Log
+> Created: YYYY-MM-DD HH:mm
+> Last Updated: YYYY-MM-DD HH:mm
+
+## [YYYY-MM-DD] [결정 제목]
+- **유형**: A·B·C·D·E·F 중 하나
+- **결정**: [선택한 방향]
+- **이유**: [핵심 근거]
+- **포기한 대안**: [대안 및 이유]
+- **재검토 조건**: [이 결정을 바꿔야 하는 상황]
+```
+
+---
+
+## Anti-Rush (AGENTS.md 준수)
+
+- 사용자가 "그냥 알아서 해줘"라고 해도 중요한 결정은 질문을 먼저 한다.
+- 답변이 불충분하면 보완 질문을 한다. 추측으로 채우지 않는다.
+- 결정이 내려지면 반드시 요약하여 사용자에게 확인받은 후 다음 단계로 넘어간다.
+- 결정 기록을 `03_DECISION_LOG.md`에 남기도록 안내한다.
+
+---
+
+## 관련 스킬
+
+- `rules-product`: Phase 전환 시 이 스킬로 핵심 결정 사전 확정
+- `rules-workflow`: Step 1~4 계획 수립 중 결정 필요 시 호출
+- `docs-plan`: 기획 단계 질문 (Why/Who/What) — Phase 1~3 질문은 docs-plan이 담당
+- `docs-dev`: 결정된 사항을 기술 명세 문서로 기록

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solmate-skills",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "description": "Curated skills for Solmate projects",
   "main": "bin/cli.js",
   "bin": {

package/{dev-conventions → rules-dev}/SKILL.md

@@ -1,9 +1,9 @@
 ---
-name: dev-conventions
+name: rules-dev
 description: Apply development setup, coding conventions, and quality rules when writing code, configuring environment, or reviewing implementation. Use when the user asks about dev setup, coding standards, commit rules, env vars, DB safety, or "what to follow when developing." Includes framework-specific patterns for Next.js, React Router v7, and React (SPA/Vite). Always align with project AGENTS.md and any DEVELOPMENT_PRINCIPLES document.
 ---
 
-# Development Conventions Skill
+# Rules Development Skill (Coding Conventions)
 
 This skill defines **development setup**, **conventions to follow**, and **prohibitions** so that code and environment stay consistent, secure, and maintainable. It is intended for **global use** across projects that follow Antigravity/AGENTS-style standards. Project-specific details (e.g. stack, app directory name) live in the repo's AGENTS.md or `docs/03_Technical_Specs/00_DEVELOPMENT_PRINCIPLES.md`.
 

package/{manage-docs → rules-docs}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: manage-docs
+name: rules-docs
 description: Create and manage project documentation according to the 365 Principle (3 Investor Lenses, 6 Rubrics, 5 Documentation Layers) with mandatory cross-layer context linking. Use when the user asks to document features, update documentation, create spec files, or manage project docs. Always include "Related Documents" sections to maintain context continuity across layers.
 ---
 
 # Documentation Management Skill
 
-이 스킬은 모든 프로젝트 문서의 **마스터 규칙**을 정의한다. 실제 문서 작성은 하위 스킬(`plan-docs`, `dev-docs`, `pitch-deck`, `business-plan`)이 담당하며, 이 스킬은 그것들이 따르는 공통 기준을 정의한다.
+이 스킬은 모든 프로젝트 문서의 **마스터 규칙**을 정의한다. 실제 문서 작성은 하위 스킬(`docs-plan`, `docs-dev`, `docs-pitch`, `docs-business`)이 담당하며, 이 스킬은 그것들이 따르는 공통 기준을 정의한다.
 
 > **365 Principle** -- 프로젝트 품질과 시장 경쟁력을 보장하는 통합 프레임워크.
 >
@@ -39,7 +39,7 @@ description: Create and manage project documentation according to the 365 Princi
 | 1 | `docs/01_Concept_Design/` | 비전, 제품 기획, 비즈니스 전략 |
 | 2 | `docs/02_UI_Screens/` | UI 디자인 시스템, 화면 흐름, 프로토타입 리뷰 |
 | 3 | `docs/03_Technical_Specs/` | DB 스키마, API 명세, 개발 원칙 |
-| 4 | `docs/04_Logic_Progress/` | 로드맵, 백로그, 비즈니스 로직, 알고리즘 |
+| 4 | `docs/04_Logic_Progress/` | 로드맵, 백로그, 개발 일정, 비즈니스 로직, 알고리즘 |
 | 5 | `docs/05_QA_Validation/` | 테스트 시나리오, QA 체크리스트, 검증 보고서 |
 
 **Context Flow**:
@@ -54,14 +54,17 @@ description: Create and manage project documentation according to the 365 Princi
 - 기획·제품 정의 → **01_Concept_Design**
 - UI 디자인·화면 흐름 → **02_UI_Screens**
 - DB, API, 개발 원칙 → **03_Technical_Specs**
-- 로드맵·백로그·비즈니스 로직 → **04_Logic_Progress**
+- 로드맵·백로그·개발 일정·비즈니스 로직 → **04_Logic_Progress** (일정 문서는 반드시 여기에 생성하며, 모든 항목은 체크박스`[ ]`를 포함한 원자적 단위로 분할해야 함)
 - 테스트·QA 보고 → **05_QA_Validation**
 
 ## 4. 파일 작성 규칙
 
 ### 네이밍
 
-파일명 앞에 2자리 순번을 붙인다: `01_VISION_CORE.md`, `02_API_SPECS.md`
+파일명 앞에 2자리 순번을 붙인다. 특히 **04_Logic_Progress**의 일정 문서는 다음 표준 명칭과 형식을 준수한다:
+- `00_BACKLOG.md`: 작업 현황 관리 (ToDo/In Progress/Done 구분 및 체크박스 활용)
+- `00_ROADMAP.md`: 마일스톤 및 단계별 일정 (Phase별 큰 줄기와 세부 항목 분할)
+- `01_EXECUTION_PLAN.md`: 기술 실행 전략 및 타임라인 (구체적인 구현 스텝 및 체크박스 필수)
 
 ### 메타데이터 (필수)
 
@@ -107,11 +110,12 @@ description: Create and manage project documentation according to the 365 Princi
 
 | 작업 | 스킬 |
 |:---|:---|
-| Layer 1-2 기획/UI 문서 | `plan-docs` |
-| Layer 3-5 기술/로직/QA 문서 | `dev-docs` |
-| 피치덱 | `pitch-deck` |
-| 사업계획서 | `business-plan` |
-| 전체 파이프라인 진행 | `product-workflow` |
+| Layer 1-2 기획/UI 문서 | `docs-plan` |
+| Layer 3-5 기술/로직/QA 문서 | `docs-dev` |
+| 피치덱 | `docs-pitch` |
+| 사업계획서 | `docs-business` |
+| 리액트 컴포넌트 표준 | `rules-react` |
+| 전체 파이프라인 진행 | `rules-product` |
 | 문서 구조 검증 | `verify-docs` |
 
 ## 7. Best Practices