solmate-skills 1.0.2 → 2.0.1

package/AGENTS.md

@@ -38,8 +38,13 @@
 - **포함 예**: `DB_SCHEMA.md`, `API_SPECS.md`, `STORAGE_POLICY.md`, 구현 가이드
 
 ### 2.4. `docs/04_Logic_Progress` — 로직·진행
-- **역할**: 백로그(진행 상태)와 비즈니스 로직·상태 관리·알고리즘 결합. UI와 데이터(DB/API) 연결 설계.
-- **포함 예**: `00_BACKLOG.md`, `00_ARCHIVE/`, 상태 머신·알고리즘 설계 문서
+- **역할**: 백로그(진행 상태), 프로젝트 로드맵, 상세 개발 일정 관리 및 비즈니스 로직·상태 관리 설계.
+- **필수 준수**: 모든 **구현 일정, 실행 계획(Execution Plan), 백로그** 정리는 반드시 이 폴더 내에서 수행해야 하며, 타 폴더(01~03)에 생성을 금지한다.
+- **표준 파일명**:
+  - `00_BACKLOG.md`: 실무 단위의 작업 목록 및 진행 상태 관리 (ToDo/Doing/Done)
+  - `01_ROADMAP.md`: 프로젝트 전체 마일스톤 및 주요 단계별 일정
+  - `02_EXECUTION_PLAN.md`: 구체적인 기술적 실행 전략 및 타임라인
+- **포함 예**: 상태 머신·알고리즘 설계 문서, `00_ARCHIVE/` (완료된 로직 보관)
 
 ### 2.5. `docs/05_QA_Validation` — QA·검증
 - **역할**: 구현 기능의 검증. 단순 테스트를 넘어 시스템 검증.
@@ -65,30 +70,59 @@
 - **배포 설정**: 배포 서비스의 Root Directory를 **App Directory(`web/`)** 로 지정하거나, Build Command를 `cd web && npm run build` 등으로 설정한다.
 
 ## 4. Skills & AI Capabilities
-AI 에이전트는 본 프로젝트에 설치된 다음 **16개 스킬**을 활용하여 작업을 수행하며, 모든 작업 결과물은 이 스킬들의 검증 가이드를 통과해야 한다.
+AI 에이전트는 본 프로젝트에 설치된 다음 **24개 스킬**을 활용하여 작업을 수행하며, 모든 작업 결과물은 이 스킬들의 검증 가이드를 통과해야 한다.
 
 | 카테고리 | 스킬명 | 주요 역할 |
 | :--- | :--- | :--- |
 | **운영 및 거버넌스** | `role-team-member` | 팀원 가이드 기반 협업 표준(브랜치, 커밋, PR 등) 준수 |
 | | `role-team-lead` | 팀장 가이드 기반 프로젝트 관리(승인, 배포, DB 등) 책임 |
 | | `manage-collaboration` | 팀장/팀원 가이드 기반 협업 표준(브랜치, PR, 승인 등) 강제 |
-| | `manage-docs` | 5단계 문서 구조 및 메타데이터 표준 관리 |
+| | `manage-decisions` | 결정 유형별 질문 템플릿으로 대화 기반 의사결정 진행 |
+| | `rules-docs` | 5단계 문서 구조 및 메타데이터 표준 관리 |
 | | `manage-skills` | 검증 스킬의 누락 탐지 및 최신화 (Self-Maint.) |
+| | `rules-workflow` | 기능 구현 전 과정(18단계)의 워크플로우 가이드 |
+| **문서 작성** | `docs-plan` | Layer 1-2 기획·UI 문서 작성 (비전, 린캔버스, UI 스크린) |
+| | `docs-dev` | Layer 3-5 기술·진행·QA 문서 작성 (DB 스키마, API, 백로그) |
+| | `docs-pitch` | 피치덱 작성 (Markdown / Reveal.js HTML) |
+| | `docs-business` | 사업계획서 작성 (정부 지원, 투자 심사, 파트너십 목적별 구성) |
 | **품질 검증 (QA)** | `verify-implementation` | 모든 `verify-*` 스킬의 통합 순차 실행 및 보고 (Template) |
 | | `verify-docs` | 문서 레이어 정합성 및 네이밍/메타데이터 검증 (Template) |
 | | `verify-drizzle-schema` | Drizzle 스키마 설계 정합성 및 기술 표준 검증 (Template) |
-| **개발 및 설계** | `dev-conventions` | 코딩 표준 및 프로젝트 컨벤션 준수 여부 확인 |
-| | `design-md` | 디자인 명세 및 기획 문서 작성 최적화 |
-| | `react-components` | UI 컴포넌트 설계 및 구현 표준 가이드 |
-| | `shadcn-ui` | shadcn/ui 라이브러리 활용 및 커스텀 가이드 |
-| **워크플로우** | `product-workflow` | 기획→UI→Stitch→React→개발문서 전체 파이프라인 오케스트레이션 |
-| | `business-plan` | 사업계획서 작성 (정부 지원, 투자 심사, 파트너십 목적별 구성) |
-| **특수 도구** | `stitch-loop` | UI 디자인-코드 간의 반복 작업 고도화 |
-| | `remotion` | 비디오 프로그래밍을 통한 시각화 자료 생성 |
-| | `obsidian-sync` | 지식 베이스(Obsidian)와의 동기화 및 관리 |
-| | `enhance-prompt` | AI 프롬프트 최적화 및 페르소나 강화 |
+| | `verify-security` | OWASP Top 10 기준 보안 취약점 점검 (인증, 인젝션, 시크릿 노출 등) |
+| | `verify-performance` | Lighthouse·Core Web Vitals 기준 성능 점검 (LCP, CLS, 번들, 이미지) |
+| | `verify-code` | PR 전 코드 품질 종합 리뷰 (로직, 타입, 중복, 사이드 이펙트) |
+| **개발 및 설계** | `rules-dev` | 코딩 표준 및 프로젝트 컨벤션 준수 여부 확인 |
+| | `rules-react` | UI 컴포넌트 설계 및 구현 표준 가이드 |
+| | `rules-product` | 기획→UI→React→개발문서 전체 파이프라인 오케스트레이션 |
+| **특수 도구(Tools)** | `tools-shadcn` | shadcn/ui 라이브러리 활용 및 커스텀 가이드 |
+| | `tools-obsidian` | 지식 베이스(Obsidian)와의 동기화 및 관리 |
+| **외부 확장(External)** | `ext-awesome-design` | 프리미엄 디자인 시스템 및 마크다운 템플릿 라이브러리 |
+| | `ext-k-skill` | 한국 특화 전문 스킬 모음 (법률, 배송, 교통 등) |
 
 ---
 
-## 5. 최종 약속
+## 5. 스킬 능동 제안 원칙 (Proactive Skill Suggestion)
+
+AI 에이전트는 사용자가 스킬을 호출하지 않아도, 아래 상황을 스스로 인식하고 관련 스킬을 **먼저 제안**한다. 제안은 강제가 아니며, 사용자가 거절하면 즉시 중단한다.
+
+| 감지 상황 | 제안 스킬 | 제안 문구 예시 |
+| :--- | :--- | :--- |
+| 기술 선택, DB/API/아키텍처 설계 논의 시작 | `manage-decisions` | "결정이 필요한 상황입니다. `/manage-decisions`로 유형별 질문을 진행할까요?" |
+| 보안·인증·인가·환경변수 관련 코드 작성 전후 | `verify-security` | "보안 관련 변경입니다. `/verify-security`로 OWASP 점검을 실행할까요?" |
+| 성능·렌더링·이미지·번들 관련 작업 완료 후 | `verify-performance` | "성능 영향이 있을 수 있습니다. `/verify-performance`로 Lighthouse 점검을 실행할까요?" |
+| PR 생성 전, 코드 변경 완료 후 | `verify-code`, `verify-implementation` | "PR 전 최종 점검입니다. `/verify-implementation`으로 전체 검증을 실행할까요?" |
+| 기획·UI 문서 작성 요청 | `docs-plan` | "Layer 1-2 문서 작성은 `/docs-plan`을 사용하세요." |
+| DB 스키마·API 명세·백로그 작성 요청 | `docs-dev` | "Layer 3-5 문서 작성은 `/docs-dev`를 사용하세요." |
+| Drizzle 스키마 파일 수정 | `verify-drizzle-schema` | "스키마 변경 후 `/verify-drizzle-schema`로 정합성을 검증하세요." |
+| 기능 구현 시작 전 | `rules-workflow` | "기능 구현은 `/rules-workflow` 18단계 워크플로우로 진행하는 것을 권장합니다." |
+| 새 프로젝트 또는 단계 전환 | `rules-product` | "현재 단계를 진단하려면 `/rules-product`를 실행하세요." |
+
+**제안 방식**:
+- 현재 대화 맥락에서 위 상황이 감지되면, 작업 진행 **전** 한 줄로 스킬 실행을 제안한다.
+- 사용자가 이미 스킬을 실행 중이거나 "그냥 진행해줘"라고 하면 제안을 생략하고 작업을 계속한다.
+- 같은 스킬을 동일 대화에서 두 번 이상 중복 제안하지 않는다.
+
+---
+
+## 6. 최종 약속
 AI 에이전트는 본 **AGENTS.md**를 모든 판단의 최우선 근거로 삼는다. 문서에 정의되지 않은 작업을 수행할 경우 반드시 사용자에게 구현 전 문서 업데이트 필요성을 먼저 확인한다.

package/CLAUDE.md

@@ -0,0 +1,77 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What This Repo Is
+
+`solmate-skills` is an npm package that ships curated AI skill files (SKILL.md) to downstream projects. It is **not** an application — it is a skill library and CLI tool. Each top-level directory (except `bin/`) is a skill that gets copied into `.agent/skills/<skill-name>` of a target project.
+
+## CLI Commands
+
+```bash
+# List available skills
+npx solmate-skills list
+
+# Install a specific skill into the current project
+npx solmate-skills install <skill-name>
+
+# Install all skills
+npx solmate-skills@latest install all
+```
+
+There are no build, test, or lint scripts in this repo (`"test": "echo \"Error: no test specified\" && exit 1"`).
+
+## Installing Skills via Symlink (Dev)
+
+`init-skills.sh` creates symlinks from a target project's `.agent/skills/` to this repo, and links `AGENTS.md` to the project root. Run it from inside the target project:
+
+```bash
+bash /Users/namhyeongseog/Documents/solmate-skills/init-skills.sh
+```
+
+## Repository Structure
+
+```
+bin/cli.js          — CLI entrypoint; discovers skills as top-level dirs, copies them to .agent/skills/
+AGENTS.md           — Global AI collaboration rules (linked into target projects)
+init-skills.sh      — Symlink installer for local development
+<skill-name>/
+  SKILL.md          — Frontmatter + instructions consumed by the AI agent
+  templates/        — (optional) document templates
+  resources/        — (optional) reference files
+  examples/         — (optional) example outputs
+```
+
+Skills discovered by `bin/cli.js` = any top-level directory not in `IGNORED_FOLDERS` (`bin`, `node_modules`, `.git`, `.github`, `.gemini`, `.agent`).
+
+## Adding or Modifying Skills
+
+- Each skill lives in its own top-level directory and must contain a `SKILL.md`.
+- `SKILL.md` frontmatter fields: `name`, `description`, and optionally `disable-model-invocation`, `argument-hint`.
+- After adding a skill, run `/manage-skills` to check for coverage gaps in `verify-*` skills.
+- Keep `AGENTS.md` and `README.md` skill tables in sync when adding or removing skills.
+
+## AGENTS.md — Global AI Rules
+
+`AGENTS.md` is the authoritative rules file that gets linked into every project. Key rules it enforces (relevant to working in this repo):
+
+- **No emojis** in any AI output.
+- **Answer before acting**: explain before modifying files; get explicit approval.
+- **Self-Reflection Check**: before any file edit, confirm the user was informed, gave approval, and the change is safe.
+- **Conventional Commits in Korean**: `type(scope): 한글 요약` (e.g. `feat(login): 소셜 로그인 API 연동`).
+- **5-Layer doc structure**: `docs/01_Concept_Design/`, `02_UI_Screens/`, `03_Technical_Specs/`, `04_Logic_Progress/`, `05_QA_Validation/`.
+- **Backlogs and roadmaps** belong exclusively in `docs/04_Logic_Progress/`.
+
+## Skill Categories
+
+| Category | Skills |
+|---|---|
+| Rules / Governance | `rules-docs`, `rules-dev`, `rules-workflow`, `manage-collaboration`, `manage-decisions`, `manage-skills` |
+| Documentation | `docs-plan`, `docs-dev`, `docs-pitch`, `docs-business`, `verify-docs`, `tools-obsidian`, `ext-awesome-design`, `ext-k-skill` |
+| Development Workflow | `rules-product`, `verify-implementation`, `verify-drizzle-schema`, `verify-security`, `verify-performance`, `verify-code` |
+| UI / Frontend | `rules-react`, `tools-shadcn` |
+| Role-based | `role-team-lead`, `role-team-member` |
+
+## Publishing
+
+This package is published to npm as `solmate-skills`. Bump `version` in `package.json` and publish via `npm publish` when releasing changes.

package/README.md

@@ -10,58 +10,95 @@ You don't need to install this package globally. Simply use `npx`:
 # List available skills
 npx solmate-skills list
 
-# Install all available skills
-npx solmate-skills install all
+# Install all available skills (use @latest to bypass npx cache)
+npx solmate-skills@latest install all
 
 # Install a specific skill
-npx solmate-skills install manage-docs
+npx solmate-skills install rules-docs
 ```
 
 When you run the `install` command, the script copies the skill folder to `.agent/skills/<skill-name>` in your current project.
 
 ---
 
+## Quick Start
+
+설치 후 상황에 맞는 스킬을 하나 실행하는 것으로 시작합니다.
+
+| 상황 | 시작 명령 | 설명 |
+|:---|:---|:---|
+| 신규 프로젝트 — 아무것도 없을 때 | `/rules-product` | 현재 단계를 자동 진단하고 Phase 1부터 순서대로 안내 |
+| 기획은 있고 코드를 작성하려 할 때 | `/rules-dev` | 커밋 형식, 환경변수, TypeScript 기준 등 컨벤션 먼저 정립 |
+| 기능 하나를 구현하려 할 때 | `/rules-workflow` | 계획 수립부터 PR까지 18단계 워크플로우로 진행 |
+| PR 전 최종 점검 | `/verify-implementation` | 모든 `verify-*` 스킬을 순차 실행하여 통합 보고 |
+
+**가장 권장하는 시작 한 줄:**
+
+```
+/rules-product
+```
+
+`rules-product`는 프로젝트 상태를 스스로 진단해 현재 어느 단계인지 파악하고, 해당 단계의 올바른 스킬로 위임하는 오케스트레이터입니다. 새 프로젝트든 재개 중인 프로젝트든 동일하게 사용할 수 있습니다.
+
+---
+
 ## Available Skills
 
-Skills are organized into four categories.
+Skills are organized into five categories.
+
+### Governance
+
+| Skill | Description |
+|:---|:---|
+| `role-team-lead` | Team lead protocols: branch protection, PR review, DB migration, deployment. |
+| `role-team-member` | Team member protocols: branching, Conventional Commits (Korean), PR creation. |
+
+### Rules
+
+| Skill | Description |
+|:---|:---|
+| `rules-docs` | Master documentation rules and 365 Principle governance. |
+| `rules-dev` | Enforce development setup, coding conventions, and quality rules. |
+| `rules-react` | Create modular, premium React components and pages. |
+| `rules-workflow` | Full 18-step implementation and execution lifecycle. |
+| `rules-product` | Orchestrate the full product development pipeline. |
+| `manage-collaboration` | Enforce AI-Human collaboration standards. |
+| `manage-decisions` | Question-driven decision making for tech, DB, API, UX, and architecture choices. |
+| `manage-skills` | Detect and fix drift between verify skills and changed code. |
 
 ### Documentation
 
 | Skill | Description |
 |:---|:---|
-| `manage-docs` | Router for the documentation system. Delegates to `plan-docs` or `dev-docs` and defines shared formatting conventions. |
-| `plan-docs` | Create and manage **planning documents** (Layer 1-2: product vision, lean canvas, UI screens). |
-| `dev-docs` | Create and manage **development documents** (Layer 3-5: technical specs, logic, QA). |
-| `pitch-deck` | Create pitch decks for investors, hackathons, and demo days. Supports Markdown, Reveal.js HTML, and Stitch output modes. |
+| `docs-plan` | Create and manage **planning documents** (Layer 1-2: vision, UI screens). |
+| `docs-dev` | Create and manage **development documents** (Layer 3-5: specs, logic, QA). |
+| `docs-pitch` | Create pitch decks for investors, hackathons, and demo days. |
+| `docs-business` | Generate professional business plans for funding or partnerships. |
 | `verify-docs` | Audit documentation structure and metadata standards. |
-| `obsidian-sync` | Sync the project `docs/` directory with an Obsidian vault via symbolic links. |
 
-### Development Workflow
+### Special Tools
 
 | Skill | Description |
 |:---|:---|
-| `dev-conventions` | Enforce development setup, coding conventions, and quality rules. Covers Next.js, React Router v7, and React (SPA/Vite). |
-| `implementation-workflow` | 18-step implementation checklist from planning through PR. |
-| `manage-collaboration` | Enforce AI-Human collaboration standards including branch strategy, PR review, and approval workflows. |
-| `manage-skills` | Detect and fix drift between verify skills and changed code. |
-| `verify-implementation` | Dynamically discover and run all `verify-*` skills, then generate a unified report. |
-| `verify-drizzle-schema` | Verify Drizzle ORM schema matches architecture specs and project standards. |
+| `tools-shadcn` | Expert guidance for shadcn/ui components. |
+| `tools-obsidian` | Sync documentation with an Obsidian vault. |
 
-### UI / Frontend
+### External Extensions
 
 | Skill | Description |
 |:---|:---|
-| `shadcn-ui` | Expert guidance for integrating and customizing shadcn/ui components. |
-| `react-components` | Convert Stitch designs into modular Vite/React components with AST-based validation. |
+| `ext-awesome-design` | Premium design system and markdown templates. |
+| `ext-k-skill` | Collection of specialized Korean tools and services. |
 
-### Stitch / Design
+### Quality & Automation
 
 | Skill | Description |
 |:---|:---|
-| `design-md` | Analyze a Stitch project and synthesize a semantic design system into `DESIGN.md`. |
-| `enhance-prompt` | Transform vague UI ideas into polished, Stitch-optimized prompts. |
-| `stitch-loop` | Iteratively build websites using Stitch with an autonomous baton-passing loop pattern. |
-| `remotion` | Generate walkthrough videos from Stitch projects using Remotion. |
+| `verify-implementation` | Dynamically discover and run all `verify-*` skills. |
+| `verify-drizzle-schema` | Verify Drizzle ORM schema matches architecture specs. |
+| `verify-security` | Check for security vulnerabilities based on OWASP Top 10. |
+| `verify-performance` | Lighthouse & Core Web Vitals check. |
+| `verify-code` | Comprehensive pre-PR code quality review. |
 
 ---
 
@@ -74,29 +111,29 @@ The documentation system follows the **365 Principle** (3 Investor Lenses, 6 Rub
 **Which skill to use:**
 
 ```
-Product vision, Lean Canvas, UI design  →  plan-docs
-DB schema, API specs, roadmap, QA       →  dev-docs
-Unsure which layer?                     →  manage-docs (router)
+Product vision, Lean Canvas, UI design  →  docs-plan
+DB schema, API specs, roadmap, QA       →  docs-dev
+Unsure which layer?                     →  rules-docs
 ```
 
 **5-Layer structure:**
 
 ```
 docs/
-├── 01_Concept_Design/   ← plan-docs
-├── 02_UI_Screens/       ← plan-docs
-├── 03_Technical_Specs/  ← dev-docs
-├── 04_Logic_Progress/   ← dev-docs
-└── 05_QA_Validation/    ← dev-docs
+├── 01_Concept_Design/   ← docs-plan
+├── 02_UI_Screens/       ← docs-plan
+├── 03_Technical_Specs/  ← docs-dev
+├── 04_Logic_Progress/   ← docs-dev
+└── 05_QA_Validation/    ← docs-dev
 ```
 
 **Typical workflow:**
 
 ```
-1. /plan-docs    → Write VISION_CORE.md, LEAN_CANVAS.md, PRODUCT_SPECS.md
-2. /plan-docs    → Write SCREEN_FLOW.md, UI_DESIGN.md
-3. /dev-docs     → Write DEVELOPMENT_PRINCIPLES.md, DB_SCHEMA.md, API_SPECS.md
-4. /dev-docs     → Write ROADMAP.md, BACKLOG.md
+1. /docs-plan    → Write VISION_CORE.md, LEAN_CANVAS.md, PRODUCT_SPECS.md
+2. /docs-plan    → Write SCREEN_FLOW.md, UI_DESIGN.md
+3. /docs-dev     → Write DEVELOPMENT_PRINCIPLES.md, DB_SCHEMA.md, API_SPECS.md
+4. /docs-dev     → Write ROADMAP.md, BACKLOG.md
 5. /verify-docs  → Audit all docs for structure and metadata compliance
 ```
 
@@ -104,9 +141,9 @@ docs/
 
 ### Pitch Deck
 
-Create a pitch deck from existing `plan-docs` documents.
+Create a pitch deck from existing `docs-plan` documents.
 
-**Prerequisites:** `plan-docs` Layer 1 documents (VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS) should exist first.
+**Prerequisites:** `docs-plan` Layer 1 documents (VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS) should exist first.
 
 **Output modes:**
 
@@ -114,29 +151,12 @@ Create a pitch deck from existing `plan-docs` documents.
 |:---|:---|:---|
 | Markdown | Content-first, will export to Notion/Slides | `docs/01_Concept_Design/XX_PITCH_DECK.md` |
 | Reveal.js HTML | Present directly in browser, deploy to GitHub Pages | `pitch/index.html` |
-| Stitch | Visual design quality matters | Stitch project slides |
 
 **Typical workflow:**
 
 ```
-1. /plan-docs    → Ensure VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS exist
-2. /pitch-deck   → Select output mode → Answer Phase 0-2 questions → Generate deck
-```
-
----
-
-### Stitch Build Pipeline
-
-Build a complete website iteratively using Stitch.
-
-**Typical workflow:**
-
-```
-1. /enhance-prompt  → Polish UI idea into a Stitch-optimized prompt
-2. /stitch-loop     → Generate pages iteratively with the baton system
-3. /design-md       → Extract design system from generated screens → DESIGN.md
-4. /react-components → Convert Stitch HTML into modular React components
-5. /remotion        → Generate a walkthrough video from the Stitch project
+1. /docs-plan    → Ensure VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS exist
+2. /docs-pitch   → Select output mode → Answer Phase 0-2 questions → Generate deck
 ```
 
 ---
@@ -146,10 +166,10 @@ Build a complete website iteratively using Stitch.
 **Typical workflow:**
 
 ```
-1. /dev-conventions          → Review conventions before writing code
-2. /implementation-workflow  → Follow the 18-step checklist during implementation
+1. /rules-dev                → Review conventions before writing code
+2. /rules-product            → Orchestrate the development pipeline
 3. /verify-implementation    → Run all verify-* skills before PR
-4. /manage-collaboration     → Check branch naming, PR format, and approval status
+4. /manage-collaboration     → Check branch naming, PR format, and workflow status
 ```
 
 ---
@@ -162,3 +182,37 @@ Build a complete website iteratively using Stitch.
 /role-team-lead    → Branch protection, PR review, DB migration, deployment
 /role-team-member  → Branching, commits (Conventional Commits in Korean), PR creation
 ```
+
+---
+
+### Proactive Skill Suggestions (Hooks)
+
+Install hook scripts so Claude **automatically suggests** the right skill as you work — without needing to invoke them manually.
+
+**Two layers work together:**
+
+| Layer | Mechanism | Trigger |
+|:---|:---|:---|
+| Method 1 | AGENTS.md rules | Claude judges context and suggests skills by reasoning |
+| Method 2 | Hook scripts | Keyword/file-pattern matching fires on every prompt or file edit |
+
+**Install hooks into your project:**
+
+```bash
+# 1. Install the hooks skill first (if not already installed)
+npx solmate-skills install hooks
+
+# 2. Run the installer from your project root
+bash .agent/skills/hooks/install.sh
+```
+
+This copies two scripts to `.claude/hooks/` and merges the hook config into `.claude/settings.json`:
+
+| Script | Event | What it detects |
+|:---|:---|:---|
+| `solmate-suggest.sh` | UserPromptSubmit | Keywords: 결정/설계, 보안, 성능, PR, 코드리뷰, 문서, 기능구현, 피치덱, 새 프로젝트 |
+| `solmate-watch.sh` | PreToolUse | File patterns: `schema.ts`, `.env*`, `SKILL.md`, `page.tsx`, `api/route.ts`, `auth.ts`, `AGENTS.md` |
+
+**To review or disable hooks:** open `/hooks` in Claude Code.
+
+**To uninstall:** remove `.claude/hooks/` and the `hooks` section from `.claude/settings.json`.

package/bin/cli.js

@@ -2,10 +2,17 @@
 
 const fs = require('fs');
 const path = require('path');
+const { execSync } = require('child_process');
 
 const IGNORED_FOLDERS = ['bin', 'node_modules', '.git', '.github', '.gemini', '.agent'];
 const IGNORED_FILES = ['package.json', 'package-lock.json', 'AGENTS.md', 'SKILL.md', 'init-skills.sh', 'README.md', '.DS_Store', 'old_AGENTS.md'];
 
+// Skills that require a post-install script to be executed after copying.
+// Key: skill name, Value: path relative to the skill folder.
+const POST_INSTALL_SCRIPTS = {
+    'hooks': 'install.sh',
+};
+
 const packageRoot = path.join(__dirname, '..');
 const targetProjectRoot = process.cwd();
 const targetSkillsDir = path.join(targetProjectRoot, '.agent', 'skills');
@@ -58,6 +65,19 @@ function installSkill(skillName) {
     console.log(`Installing ${skillName}...`);
     copyFolderSync(sourcePath, destPath);
     console.log(`Successfully installed ${skillName} to .agent/skills/${skillName}`);
+
+    // Run post-install script if defined for this skill
+    if (POST_INSTALL_SCRIPTS[skillName]) {
+        const scriptPath = path.join(destPath, POST_INSTALL_SCRIPTS[skillName]);
+        if (fs.existsSync(scriptPath)) {
+            console.log(`Running post-install for ${skillName}...`);
+            try {
+                execSync(`bash "${scriptPath}"`, { stdio: 'inherit', cwd: targetProjectRoot });
+            } catch (err) {
+                console.error(`Warning: post-install script for ${skillName} exited with an error.`);
+            }
+        }
+    }
 }
 
 const args = process.argv.slice(2);

package/{business-plan → docs-business}/SKILL.md

@@ -1,13 +1,13 @@
 ---
-name: business-plan
-description: Create formal business plan documents (사업계획서) for government grants, investment review, or partnership proposals. Reads from plan-docs Layer 1 documents as source material. Produces structured, evidence-based documents with financials, execution plans, and market analysis. Use when applying for grants, preparing for institutional review, or documenting business strategy in full.
+name: docs-business
+description: Create formal business plan documents (사업계획서) for government grants, investment review, or partnership proposals. Reads from docs-plan Layer 1 documents as source material. Produces structured, evidence-based documents with financials, execution plans, and market analysis. Use when applying for grants, preparing for institutional review, or documenting business strategy in full.
 ---
 
-# Business Plan Skill (사업계획서)
+# Business Documentation Skill (사업계획서)
 
-You are a **business documentation specialist**. Your goal is to transform plan-docs Layer 1 materials into a formal, structured 사업계획서 that passes institutional review.
+You are a **business documentation specialist**. Your goal is to transform docs-plan Layer 1 materials into a formal, structured 사업계획서 that passes institutional review.
 
-> This skill reads from `plan-docs` Layer 1 documents (VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS) as source material. Run `plan-docs` first if those documents don't exist yet.
+> This skill reads from `docs-plan` Layer 1 documents (VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS) as source material. Run `docs-plan` first if those documents don't exist yet.
 
 ## 1. Rules
 
@@ -221,7 +221,7 @@ You are a **business documentation specialist**. Your goal is to transform plan-
 
 ## 7. Related Skills
 
-- **plan-docs**: 사업계획서의 원천 데이터 (VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS)
-- **pitch-deck**: 같은 Phase 1 데이터로 만드는 발표용 자료 (독자와 형식이 다름)
-- **manage-docs**: 공통 문서 규칙 및 5-Layer 구조
+- **docs-plan**: 사업계획서의 원천 데이터 (VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS)
+- **docs-pitch**: 같은 Phase 1 데이터로 만드는 발표용 자료 (독자와 형식이 다름)
+- **rules-docs**: 공통 문서 규칙 및 5-Layer 구조
 - **verify-docs**: 문서 구조/메타데이터 검증

package/{dev-docs → docs-dev}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: dev-docs
+name: docs-dev
 description: Create and manage development documents for Layer 3 (Technical_Specs), Layer 4 (Logic_Progress), and Layer 5 (QA_Validation). Use when writing DB schema docs, API specs, development principles, roadmaps, backlogs, business logic designs, or test scenarios. Always read existing files before editing. Include Related Documents sections.
 ---
 
@@ -7,7 +7,7 @@ description: Create and manage development documents for Layer 3 (Technical_Spec
 
 This skill manages **Layer 3 (Technical_Specs)**, **Layer 4 (Logic_Progress)**, and **Layer 5 (QA_Validation)** — the "How" of the project.
 
-> Shared conventions (metadata format, naming rules, 365 Principle overview, link format) are defined in `manage-docs`.
+> Shared conventions (metadata format, naming rules, 365 Principle overview, link format) are defined in `rules-docs`.
 
 ## 1. Rules
 
@@ -36,8 +36,9 @@ This skill manages **Layer 3 (Technical_Specs)**, **Layer 4 (Logic_Progress)**,
 - `02_API_SPECS.md` — API 엔드포인트 명세
 
 **Layer 4 — Logic_Progress**
-- `00_ROADMAP.md` — Now/Next/Later 전략 (Layer 3 기술 명세 링크 필수)
-- `01_BACKLOG.md` — Kanban 보드 (Current / Upcoming / Completed)
+- `00_BACKLOG.md` — Kanban 보드 (ToDo / In Progress / Done 구분 및 **모든 항목 체크박스 필수**)
+- `00_ROADMAP.md` — Phase별 마일스톤 및 일정 전략 (Layer 3 기술 명세 링크 필수)
+- `01_EXECUTION_PLAN.md` — 구체적인 작업 구현 일정 및 실행 전략 (**원자적 단위로 분할된 체크리스트 필수**)
 - `02_ROADMAP_BACKLOG_SYNC.md` — Roadmap과 Backlog 동기화 규칙
 
 **Layer 5 — QA_Validation**
@@ -55,6 +56,8 @@ This skill manages **Layer 3 (Technical_Specs)**, **Layer 4 (Logic_Progress)**,
 
 ### Logic Phase (BACKLOG, 코딩 시작 전 필수)
 
+**중요 규칙**: 실무 문서(`00_BACKLOG.md`, `00_ROADMAP.md`, `01_EXECUTION_PLAN.md`) 작성 시, 모든 작업은 반드시 체크박스`[ ]`를 사용하여 원자적 단위(Atomic Task)로 최대한 상세히 나누어 기록해야 한다. "추상적인 작업" 대신 "실제로 실행 및 검증 가능한 단계"로 분할한다.
+
 1. **Project Initialization**: CLI 프리셋 vs 수동 설정?
 2. **UI Theme Strategy**: 사전 정의된 테마 vs 커스텀 브랜드 색상? 폰트 선택?
 3. **Folder Structure**: Feature 기반 vs Type 기반?
@@ -172,7 +175,7 @@ This skill manages **Layer 3 (Technical_Specs)**, **Layer 4 (Logic_Progress)**,
 
 ## 6. Related Skills
 
-- **plan-docs**: Layer 1-2 기획/디자인 문서 작성
-- **dev-conventions**: 코딩 컨벤션 및 개발 설정 규칙 적용 (문서화가 아닌 코드 작성 시)
+- **docs-plan**: Layer 1-2 기획/디자인 문서 작성
+- **rules-dev**: 코딩 컨벤션 및 개발 설정 규칙 적용 (문서화가 아닌 코드 작성 시)
 - **verify-docs**: 문서 구조/메타데이터 검증
 - **verify-db**: DB 스키마 검증 (Drizzle/Prisma)

package/{pitch-deck → docs-pitch}/SKILL.md

@@ -1,14 +1,14 @@
 ---
-name: pitch-deck
-description: Create compelling pitch decks for investors, hackathons, and competitions. Supports three output modes — Markdown (content-first), Reveal.js HTML (browser presentation), or Stitch (visual design). Applies the 3 Investor Lenses and 6 Global Rubrics. Use when preparing for investor meetings, competition submissions, or demo days. Integrates with plan-docs Layer 1 documents.
+name: docs-pitch
+description: Create compelling pitch decks for investors, hackathons, and competitions. Supports two output modes — Markdown (content-first) or Reveal.js HTML (browser presentation). Applies the 3 Investor Lenses and 6 Global Rubrics. Use when preparing for investor meetings, competition submissions, or demo days. Integrates with docs-plan Layer 1 documents.
 ---
 
-# Pitch Deck Skill
+# Pitch Documentation Skill (Pitch Deck)
 
 This skill creates pitch decks optimized for investors, hackathon judges, and competition reviewers.
-**Output mode는 상황에 따라 선택한다** — Markdown, Reveal.js HTML, Stitch 중 하나.
+**Output mode는 상황에 따라 선택한다** — Markdown, Reveal.js HTML 중 하나.
 
-> This skill reads from `plan-docs` Layer 1 documents (VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS) as source material. Run `plan-docs` first if those documents don't exist yet.
+> This skill reads from `docs-plan` Layer 1 documents (VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS) as source material. Run `docs-plan` first if those documents don't exist yet.
 
 ## 1. Rules
 
@@ -50,7 +50,6 @@ This skill creates pitch decks optimized for investors, hackathon judges, and co
 |:---|:---|:---|
 | **A. Markdown** | 내용 작성이 목적, 노션/Slides.com 등 외부 도구로 옮길 예정 | `docs/01_Concept_Design/XX_PITCH_DECK.md` |
 | **B. Reveal.js HTML** | 브라우저에서 바로 발표, GitHub Pages 배포 예정 | `pitch/index.html` |
-| **C. Stitch** | 시각적 완성도가 중요, 디자인이 필요한 발표 | Stitch 프로젝트 슬라이드 |
 
 > 모드를 명시하지 않으면 목적과 청중을 파악한 뒤 권장 모드를 제안한다.
 
@@ -226,33 +225,7 @@ This skill creates pitch decks optimized for investors, hackathon judges, and co
 
 ---
 
-### Mode C — Stitch
-
-**실행 절차:**
-
-1. Stitch MCP prefix 탐색: `list_tools`로 prefix 확인
-2. DESIGN.md가 있으면 읽어 디자인 시스템을 프롬프트에 포함
-3. 슬라이드별 `generate_screen_from_text` 호출:
-   - `deviceType`: `DESKTOP`
-   - `prompt`: 슬라이드 내용 + DESIGN.md 디자인 시스템 블록
-4. 생성된 슬라이드 HTML을 `pitch/slide-01.html` 형식으로 저장
-5. 네비게이션 링크로 슬라이드 간 연결
-
-**슬라이드별 프롬프트 구조:**
-```
-[Slide N: Slide Name] — [Product Name] Pitch Deck
-
-DESIGN SYSTEM (REQUIRED):
-[DESIGN.md Section 6 내용 복사]
-
-Slide content:
-- Headline: [핵심 메시지 1문장]
-- Body: [슬라이드 본문 내용]
-- Visual: [원하는 시각 요소 설명]
-- Layout: Full-width slide, desktop 16:9
-```
-
-> DESIGN.md가 없으면 `design-md` 스킬로 먼저 생성하거나, 첫 슬라이드 생성 후 디자인 시스템을 추출한다.
+---
 
 ## 7. Common Pitfalls
 
@@ -267,6 +240,6 @@ Slide content:
 
 ## 8. Related Skills
 
-- **plan-docs**: 피치덱의 원천 데이터 (VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS)
-- **manage-docs**: 공통 문서 규칙 및 365 Principle 정의
+- **docs-plan**: 피치덱의 원천 데이터 (VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS)
+- **rules-docs**: 공통 문서 규칙 및 365 Principle 정의
 - **verify-docs**: 작성된 문서 구조/메타데이터 검증

package/{plan-docs → docs-plan}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: plan-docs
+name: docs-plan
 description: Create and manage planning documents for Layer 1 (Concept_Design) and Layer 2 (UI_Screens). Use when documenting product vision, lean canvas, product specs, UI design systems, screen flows, or prototype reviews. Ask before writing. Always include Related Documents sections.
 ---
 
@@ -7,7 +7,7 @@ description: Create and manage planning documents for Layer 1 (Concept_Design) a
 
 This skill manages **Layer 1 (Concept_Design)** and **Layer 2 (UI_Screens)** — the "Why, Who, What" of the project.
 
-> Shared conventions (metadata format, naming rules, 365 Principle overview, link format) are defined in `manage-docs`.
+> Shared conventions (metadata format, naming rules, 365 Principle overview, link format) are defined in `rules-docs`.
 
 ## 1. Rules
 
@@ -150,7 +150,5 @@ This skill manages **Layer 1 (Concept_Design)** and **Layer 2 (UI_Screens)** —
 
 ## 5. Related Skills
 
-- **dev-docs**: Layer 3-5 기술 명세/로직/QA 문서 작성
-- **design-md**: Stitch 프로젝트에서 디자인 시스템 추출
-- **enhance-prompt**: UI 아이디어를 Stitch 프롬프트로 변환
+- **docs-dev**: Layer 3-5 기술 명세/로직/QA 문서 작성
 - **verify-docs**: 작성된 문서의 구조/메타데이터 검증