solmate-skills 1.0.1 → 2.0.0

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,26 +70,59 @@
 - **배포 설정**: 배포 서비스의 Root Directory를 **App Directory(`web/`)** 로 지정하거나, Build Command를 `cd web && npm run build` 등으로 설정한다.
 
 ## 4. Skills & AI Capabilities
-AI 에이전트는 본 프로젝트에 설치된 다음 **14개 스킬**을 활용하여 작업을 수행하며, 모든 작업 결과물은 이 스킬들의 검증 가이드를 통과해야 한다.
+AI 에이전트는 본 프로젝트에 설치된 다음 **24개 스킬**을 활용하여 작업을 수행하며, 모든 작업 결과물은 이 스킬들의 검증 가이드를 통과해야 한다.
 
 | 카테고리 | 스킬명 | 주요 역할 |
 | :--- | :--- | :--- |
-| **운영 및 거버넌스** | `manage-collaboration` | 팀장/팀원 가이드 기반 협업 표준(브랜치, PR, 승인 등) 강제 |
-| | `manage-docs` | 5단계 문서 구조 및 메타데이터 표준 관리 |
+| **운영 및 거버넌스** | `role-team-member` | 팀원 가이드 기반 협업 표준(브랜치, 커밋, PR 등) 준수 |
+| | `role-team-lead` | 팀장 가이드 기반 프로젝트 관리(승인, 배포, DB 등) 책임 |
+| | `manage-collaboration` | 팀장/팀원 가이드 기반 협업 표준(브랜치, PR, 승인 등) 강제 |
+| | `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 라이브러리 활용 및 커스텀 가이드 |
-| **특수 도구** | `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,33 +10,209 @@ 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 (e.g., manage-docs)
-npx solmate-skills install manage-docs
+# Install a specific skill
+npx solmate-skills install rules-docs
 ```
 
-## How it works
+When you run the `install` command, the script copies the skill folder to `.agent/skills/<skill-name>` in your current project.
 
-When you run the `install` command, the script will:
-1. Check for the selected skill in this package.
-2. Copy 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
 
-- `design-md`: Design and UI patterns.
-- `dev-conventions`: Development standards and rules.
-- `enhance-prompt`: Advanced prompting techniques.
-- `implementation-workflow`: Step-by-step implementation guides.
-- `manage-collaboration`: Team collaboration protocols.
-- `manage-docs`: Documentation structure and standards.
-- `manage-skills`: Skill management and creation tool.
-- `obsidian-sync`: Obsidian integration.
-- `react-components`: Curated React components.
-- `remotion`: Video creation as code.
-- `shadcn-ui`: Custom Shadcn UI components.
-- `stitch-loop`: Integration with Stitch.
-- `verify-docs`: Documentation audit tool.
-- `verify-drizzle-schema`: Drizzle schema verification.
-- `verify-implementation`: Logic and flow verification.
+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 |
+|:---|:---|
+| `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. |
+
+### Special Tools
+
+| Skill | Description |
+|:---|:---|
+| `tools-shadcn` | Expert guidance for shadcn/ui components. |
+| `tools-obsidian` | Sync documentation with an Obsidian vault. |
+
+### External Extensions
+
+| Skill | Description |
+|:---|:---|
+| `ext-awesome-design` | Premium design system and markdown templates. |
+| `ext-k-skill` | Collection of specialized Korean tools and services. |
+
+### Quality & Automation
+
+| Skill | Description |
+|:---|:---|
+| `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. |
+
+---
+
+## Usage Guide
+
+### Documentation System
+
+The documentation system follows the **365 Principle** (3 Investor Lenses, 6 Rubrics, 5 Documentation Layers) and is split across two skills based on the type of document.
+
+**Which skill to use:**
+
+```
+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/   ← 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. /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
+```
+
+---
+
+### Pitch Deck
+
+Create a pitch deck from existing `docs-plan` documents.
+
+**Prerequisites:** `docs-plan` Layer 1 documents (VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS) should exist first.
+
+**Output modes:**
+
+| Mode | When to use | Output |
+|:---|:---|:---|
+| 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` |
+
+**Typical workflow:**
+
+```
+1. /docs-plan    → Ensure VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS exist
+2. /docs-pitch   → Select output mode → Answer Phase 0-2 questions → Generate deck
+```
+
+---
+
+### Development Workflow
+
+**Typical workflow:**
+
+```
+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 workflow status
+```
+
+---
+
+### Governance
+
+**Role-based skills** define protocols for team lead and team member roles:
+
+```
+/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/docs-business/SKILL.md

@@ -0,0 +1,227 @@
+---
+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 Documentation Skill (사업계획서)
+
+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 `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
+
+1. 이모지 금지. 전문적이고 명확한 텍스트로만 소통한다.
+2. Ask before Write: 아래 Phase 질문을 먼저 던지고 답변을 바탕으로 작성한다.
+3. 기존 BUSINESS_PLAN.md가 있으면 반드시 먼저 읽고 컨텍스트를 유지하며 업데이트한다.
+4. 모든 수치는 출처를 명시한다. 추측 기반 수치 금지.
+5. 피치덱과의 차이를 항상 인식한다 — 이 문서는 발표용이 아닌 검토용이다.
+
+## 2. 피치덱과의 차이
+
+| 구분 | 피치덱 | 사업계획서 |
+|:---|:---|:---|
+| 독자 | 투자자, 심사위원 | 정부 기관, 심사 위원회, 기업 파트너 |
+| 형식 | 슬라이드, 시각 중심 | 정식 문서, 텍스트/표 중심 |
+| 분량 | 10-15 슬라이드 | 10-30 페이지 |
+| 핵심 | 스토리와 임팩트 | 구체적 수치와 실행 계획 |
+| 어조 | 설득적, 열정적 | 객관적, 근거 기반 |
+| 재무 | 요약 수준 | 3개년 추정 손익, 현금 흐름 포함 |
+
+## 3. Interactive Process (Ask Before Write)
+
+### Phase 0 — 제출 목적 확인 (첫 번째 질문)
+
+시작 전 반드시 제출 대상과 목적을 확인한다.
+
+| 목적 | 주요 강조 항목 |
+|:---|:---|
+| **정부 지원 사업** (창업지원, R&D 과제 등) | 사회적 가치, 고용 창출, 기술 혁신성, 실행 계획 |
+| **기업 투자 심사** (VC, 엔젤) | 수익성, 시장 규모, 팀 역량, Exit 전략 |
+| **파트너십/제휴** | 상호 이익, 역할 분담, 시너지 효과 |
+| **은행/기관 대출** | 담보, 현금 흐름, 상환 계획 |
+
+> 목적을 확인한 후 해당 목적에 맞게 각 섹션의 강조점을 조정한다.
+
+### Phase 1 — 기본 정보 수집
+
+1. **제출처 및 마감**: 어디에 제출하는가? 마감일과 페이지 제한이 있는가?
+2. **요구 양식**: 제출처에서 지정한 양식이 있는가? 있다면 해당 양식을 우선 따른다.
+3. **팀 현황**: 대표자/창업자 이름, 역할, 핵심 경력은?
+4. **재무 현황**: 현재 매출 또는 투자 유치 이력이 있는가? 없다면 추정 기준은?
+5. **요청 규모**: 지원 금액 또는 투자 유치 목표는?
+
+### Phase 2 — 내용 깊이 확인
+
+6. **기술 차별성**: 특허, 인증, 독점 기술이 있는가? 기술 완성도(TRL)는?
+7. **시장 검증 증거**: 실제 고객, 파일럿, 인터뷰 결과 등 검증 자료가 있는가?
+8. **경쟁 환경**: 주요 경쟁사 3-5개와 우리의 차별점은?
+9. **3개년 목표**: 연도별 매출, 사용자 수, 주요 마일스톤 목표는?
+10. **리스크 인식**: 예상 리스크와 대응 방안을 설명할 수 있는가?
+
+---
+
+## 4. 표준 사업계획서 구조
+
+### 1장. 사업 개요 (Executive Summary)
+
+**목적**: 1-2페이지 안에 전체 내용을 압축한다. 심사위원이 가장 먼저 읽는다.
+
+**포함 내용**:
+- 회사명, 대표자, 설립일, 업종
+- 사업 아이템 한 줄 요약 (UVP)
+- 목표 시장 및 규모
+- 현재 개발/사업 단계
+- 요청 사항 (지원금액, 투자규모 등)
+
+### 2장. 문제 정의 및 배경
+
+**목적**: 이 사업이 존재해야 하는 이유를 객관적으로 설명한다.
+
+**포함 내용**:
+- 해결하려는 문제의 구체적 현황 (수치, 통계 포함)
+- 기존 대안의 한계와 공백
+- 문제의 사회적/경제적 맥락
+- 출처: 통계청, 시장조사 보고서, 논문 등 인용
+
+### 3장. 솔루션 및 제품/서비스 설명
+
+**목적**: 우리의 해결 방식과 제품을 명확히 설명한다.
+
+**포함 내용**:
+- 핵심 기능 및 서비스 흐름 (스크린샷, 다이어그램 포함 권장)
+- 기술 구성 및 특징 (기술적 신뢰성 입증)
+- 개발 단계 (기획 / 프로토타입 / MVP / 출시 / 성장)
+- 특허, 인증, 지적재산권 현황
+
+### 4장. 시장 분석
+
+**목적**: 충분한 시장 규모와 진입 가능성을 증명한다.
+
+**포함 내용**:
+- TAM / SAM / SOM 산출 근거 (출처 명시 필수)
+- 목표 시장의 성장률 트렌드
+- 고객 세그먼트 정의 및 타겟 우선순위
+- 경쟁사 분석 매트릭스 (최소 3개사)
+
+### 5장. 비즈니스 모델
+
+**목적**: 지속 가능한 수익 구조를 설명한다.
+
+**포함 내용**:
+- 수익 모델 (구독 / 거래 수수료 / B2B 라이선스 / 광고 등)
+- 가격 정책 및 근거
+- 고객 획득 전략 (채널, 비용, 전환율)
+- 단위 경제 (CAC, LTV, 마진율)
+
+### 6장. 실행 계획 (로드맵)
+
+**목적**: 구체적이고 실현 가능한 실행 계획을 제시한다.
+
+**포함 내용**:
+- 단계별 마일스톤 (분기별 또는 반기별)
+- 인력 채용 계획
+- 주요 파트너십/협약 계획
+- 지원금/투자금 사용 계획 (항목별 예산 배분)
+
+형식 예시:
+```
+| 기간 | 마일스톤 | 예산 항목 |
+|------|---------|---------|
+| 2026 Q1 | MVP 출시, 초기 사용자 100명 | 개발비 X원 |
+| 2026 Q2 | 유료 전환 시작, 파트너십 1건 | 마케팅비 X원 |
+| 2026 Q3-Q4 | 사용자 1,000명, 월 매출 X원 달성 | 인건비 X원 |
+```
+
+### 7장. 재무 계획
+
+**목적**: 3개년 추정 재무 수치를 통해 사업의 성장 경로를 보여준다.
+
+**포함 내용**:
+- 3개년 추정 손익계산서 (매출, 비용, 영업이익)
+- 현금 흐름 요약 (투자금 소진 시점, BEP 달성 시점)
+- 주요 가정 명시 (성장률, 객단가, 고객 증가율 등)
+- 민감도 분석 (낙관 / 기본 / 보수 시나리오)
+
+> 재무 수치가 없는 초기 단계라면 가정 기반 추정임을 명시하고, 가정의 근거를 설명한다.
+
+### 8장. 팀 소개
+
+**목적**: 이 팀이 이 사업을 실행할 역량을 갖췄음을 증명한다.
+
+**포함 내용**:
+- 대표자 및 핵심 멤버 약력 (사업 관련 경력 중심)
+- 각 멤버의 역할과 책임
+- 자문단, 파트너사, 멘토 현황
+- 팀이 이 문제를 해결하기에 적합한 이유 (Unfair Advantage)
+
+### 9장. 리스크 및 대응 방안
+
+**목적**: 예상 리스크를 인식하고 대응책이 있음을 보여준다.
+
+**포함 내용**:
+- 기술 리스크 (개발 지연, 기술 한계)
+- 시장 리스크 (수요 미달, 경쟁자 진입)
+- 규제/법적 리스크 (개인정보, 인허가)
+- 각 리스크별 대응 전략
+
+### 10장. 결론 및 요청 사항
+
+**목적**: 명확한 Ask와 기대 효과로 마무리한다.
+
+**포함 내용**:
+- 지원/투자 요청 금액 및 조건
+- 자금 사용 계획 요약
+- 기대 성과 (정량 목표)
+- 비전 재확인 (1-2문장)
+
+---
+
+## 5. 출력 형식
+
+**저장 경로**: `docs/01_Concept_Design/XX_BUSINESS_PLAN.md`
+
+```
+# 사업계획서: [제품/회사명]
+> Created: YYYY-MM-DD HH:mm
+> Last Updated: YYYY-MM-DD HH:mm
+> 제출처: [기관명]
+> 제출 목적: [정부 지원 / 투자 심사 / 파트너십]
+> 버전: v1.0
+
+## 1장. 사업 개요
+...
+
+## 2장. 문제 정의 및 배경
+...
+
+(이하 각 장)
+
+## Related Documents
+- **Concept_Design**: [Vision & Core Values](./01_VISION_CORE.md) - 핵심 비전 및 타겟 오디언스
+- **Concept_Design**: [Lean Canvas](./02_LEAN_CANVAS.md) - 비즈니스 모델 및 수익 구조
+- **Concept_Design**: [Product Specs](./03_PRODUCT_SPECS.md) - 제품 기능 명세
+- **Concept_Design**: [Pitch Deck](./XX_PITCH_DECK.md) - 발표용 요약 자료
+```
+
+---
+
+## 6. Common Pitfalls
+
+| 피해야 할 것 | 이유 |
+|:---|:---|
+| 출처 없는 시장 규모 수치 | 심사위원이 검증 시 신뢰도 하락 |
+| 재무 계획 없이 제출 | 정부 지원 심사에서 탈락 요인 1위 |
+| 팀 소개 생략 또는 약력 부재 | 초기 기업은 팀이 가장 중요한 심사 기준 |
+| 리스크 언급 회피 | 현실 인식 부재로 신뢰도 하락 |
+| 피치덱과 동일한 내용 복붙 | 두 문서의 목적과 독자가 다르다 |
+| 요청 금액 근거 없음 | 항목별 사용 계획이 없으면 신뢰 불가 |
+
+---
+
+## 7. Related Skills
+
+- **docs-plan**: 사업계획서의 원천 데이터 (VISION_CORE, LEAN_CANVAS, PRODUCT_SPECS)
+- **docs-pitch**: 같은 Phase 1 데이터로 만드는 발표용 자료 (독자와 형식이 다름)
+- **rules-docs**: 공통 문서 규칙 및 5-Layer 구조
+- **verify-docs**: 문서 구조/메타데이터 검증