solmate-skills 2.0.3 → 2.0.5

package/AGENTS.md

@@ -70,7 +70,7 @@
 - **배포 설정**: 배포 서비스의 Root Directory를 **App Directory(`web/`)** 로 지정하거나, Build Command를 `cd web && npm run build` 등으로 설정한다.
 
 ## 4. Skills & AI Capabilities
-AI 에이전트는 본 프로젝트에 설치된 다음 **24개 스킬**을 활용하여 작업을 수행하며, 모든 작업 결과물은 이 스킬들의 검증 가이드를 통과해야 한다.
+AI 에이전트는 본 프로젝트에 설치된 다음 **26개 스킬**을 활용하여 작업을 수행하며, 모든 작업 결과물은 이 스킬들의 검증 가이드를 통과해야 한다.
 
 | 카테고리 | 스킬명 | 주요 역할 |
 | :--- | :--- | :--- |
@@ -85,12 +85,14 @@ AI 에이전트는 본 프로젝트에 설치된 다음 **24개 스킬**을 활
 | | `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) |
+| **품질 검증 (QA)** | `verify-implementation` | 모든 `verify-*` 스킬의 통합 순차 실행 및 보고 |
+| | `verify-docs` | 문서 레이어 정합성 및 네이밍/메타데이터, UI-First Gate 검증 |
+| | `verify-ui` | 구현 UI와 화면 문서·사용자 동선·상태별 UI 정합성 검증 |
+| | `verify-code` | PR 전 코드 품질 종합 리뷰 (로직, 타입, 중복, 사이드 이펙트) |
 | | `verify-security` | OWASP Top 10 기준 보안 취약점 점검 (인증, 인젝션, 시크릿 노출 등) |
 | | `verify-performance` | Lighthouse·Core Web Vitals 기준 성능 점검 (LCP, CLS, 번들, 이미지) |
-| | `verify-code` | PR 전 코드 품질 종합 리뷰 (로직, 타입, 중복, 사이드 이펙트) |
+| | `verify-drizzle-schema` | Drizzle 스키마 설계 정합성 및 기술 표준 검증 |
+| | `verify-skills` | 스킬 패키지 메타데이터·CLI·README/AGENTS·패키징 검증 |
 | **개발 및 설계** | `rules-dev` | 코딩 표준 및 프로젝트 컨벤션 준수 여부 확인 |
 | | `rules-react` | UI 컴포넌트 설계 및 구현 표준 가이드 |
 | | `rules-product` | 기획→UI→React→개발문서 전체 파이프라인 오케스트레이션 |
@@ -110,11 +112,13 @@ AI 에이전트는 사용자가 스킬을 호출하지 않아도, 아래 상황
 | 기술 선택, DB/API/아키텍처 설계 논의 시작 | `manage-decisions` | "결정이 필요한 상황입니다. `/manage-decisions`로 유형별 질문을 진행할까요?" |
 | 보안·인증·인가·환경변수 관련 코드 작성 전후 | `verify-security` | "보안 관련 변경입니다. `/verify-security`로 OWASP 점검을 실행할까요?" |
 | 성능·렌더링·이미지·번들 관련 작업 완료 후 | `verify-performance` | "성능 영향이 있을 수 있습니다. `/verify-performance`로 Lighthouse 점검을 실행할까요?" |
+| UI·화면·컴포넌트 구현 완료 후 | `verify-ui` | "UI 구현 변경입니다. `/verify-ui`로 화면 문서와 사용자 동선 정합성을 검증할까요?" |
 | 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단계 워크플로우로 진행하는 것을 권장합니다." |
+| 스킬 파일·CLI·패키지 메타데이터 수정 | `verify-skills` | "스킬 패키지 변경입니다. `/verify-skills`로 메타데이터와 패키징을 검증하세요." |
+| 기능 구현 시작 전 | `rules-product`, `rules-workflow` | "먼저 `/rules-product`로 현재 단계를 진단한 뒤 `/rules-workflow`로 구현을 진행하세요." |
 | 새 프로젝트 또는 단계 전환 | `rules-product` | "현재 단계를 진단하려면 `/rules-product`를 실행하세요." |
 
 **제안 방식**:

package/README.md

@@ -2,6 +2,18 @@
 
 Curated skills for Solmate projects. Easily share and install AI tool skills across your team.
 
+## What's New in 2.0.4
+
+`solmate-skills@2.0.4` keeps **Backlog Context Lock** as the current documentation guardrail, adds **UI-First Gate** expectations, and tightens package hygiene for Codex-local settings.
+
+Key changes:
+
+- Every backlog task must link to related Concept, UI, Technical Spec, and QA documents.
+- UI, user paths, data flow, loading states, empty states, and error states must be confirmed before coding.
+- `/rules-workflow` now treats linked backlog documents as implementation inputs before coding starts.
+- `/verify-docs` fails backlog items that omit required related-document fields.
+- Local Codex settings under `.codex/` are excluded from the npm package.
+
 ## Installation
 
 You don't need to install this package globally. Simply use `npx`:
@@ -13,12 +25,17 @@ npx solmate-skills list
 # Install all available skills (use @latest to bypass npx cache)
 npx solmate-skills@latest install all
 
+# Install proactive hook suggestions for Claude Code projects
+npx solmate-skills@latest install hooks
+
 # Install a specific skill
 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.
 
+`install all` installs only skill folders that contain `SKILL.md`. Use `install hooks` separately when you want prompt/file-change suggestions that nudge the agent toward `/rules-product`, `/rules-workflow`, and the relevant `verify-*` skills.
+
 ---
 
 ## Quick Start
@@ -29,7 +46,7 @@ When you run the `install` command, the script copies the skill folder to `.agen
 |:---|:---|:---|
 | 신규 프로젝트 — 아무것도 없을 때 | `/rules-product` | 현재 단계를 자동 진단하고 Phase 1부터 순서대로 안내 |
 | 기획은 있고 코드를 작성하려 할 때 | `/rules-dev` | 커밋 형식, 환경변수, TypeScript 기준 등 컨벤션 먼저 정립 |
-| 기능 하나를 구현하려 할 때 | `/rules-workflow` | 계획 수립부터 PR까지 18단계 워크플로우로 진행 |
+| 기능 하나를 구현하려 할 때 | `/rules-product` → `/rules-workflow` | 현재 Phase를 먼저 진단한 뒤 계획 수립부터 PR까지 진행 |
 | PR 전 최종 점검 | `/verify-implementation` | 모든 `verify-*` 스킬을 순차 실행하여 통합 보고 |
 
 **가장 권장하는 시작 한 줄:**
@@ -40,6 +57,49 @@ When you run the `install` command, the script copies the skill folder to `.agen
 
 `rules-product`는 프로젝트 상태를 스스로 진단해 현재 어느 단계인지 파악하고, 해당 단계의 올바른 스킬로 위임하는 오케스트레이터입니다. 새 프로젝트든 재개 중인 프로젝트든 동일하게 사용할 수 있습니다.
 
+`rules-product` and `rules-workflow` should show a short Flow Status Block at the start of work, before implementation, before verification, and at handoff:
+
+```text
+[Flow]
+현재: Phase 2 — UI 설계
+Gate: UI-First Gate 진행 중
+완료: Phase 1 — Concept
+다음: Pre-Code Technical Brief
+필요 확인: 화면별 오류 상태
+권장 스킬: /docs-plan
+```
+
+### Using Skills in an Existing Project
+
+이미 진행 중인 프로젝트에도 최신 `solmate-skills`를 다시 설치해서 사용할 수 있습니다. 사용 방식은 신규 프로젝트와 같지만, 시작점은 항상 현재 프로젝트 상태를 먼저 진단하는 것입니다.
+
+**Update or reinstall skills from the project root:**
+
+```bash
+npx solmate-skills@latest install all
+npx solmate-skills@latest install hooks
+```
+
+**Recommended first prompt:**
+
+```text
+/rules-product를 사용해서 이 프로젝트의 현재 진행 상태를 진단하고, 다음 작업을 Flow Status Block 기준으로 안내해줘.
+```
+
+**When starting implementation work:**
+
+```text
+/rules-workflow를 사용해서 현재 기능 작업을 진행해줘. 먼저 Flow Status Block으로 현재 위치를 알려주고, UI-First 흐름에 맞춰 진행해줘.
+```
+
+**When verifying finished work:**
+
+```text
+/verify-implementation으로 현재 변경사항을 전체 검증해줘. Flow Status Block을 포함해서 보고해줘.
+```
+
+진행 중인 프로젝트에서는 Phase 1부터 강제로 다시 시작하지 않습니다. `/rules-product`가 기존 문서, 코드, 백로그, 변경사항을 보고 현재 위치를 진단한 뒤, 이어서 진행할 Phase와 필요한 Gate를 제안해야 합니다.
+
 ---
 
 ## Available Skills
@@ -99,6 +159,8 @@ Skills are organized into five categories.
 | `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. |
+| `verify-ui` | Verify implemented UI against screen docs and user flows. |
+| `verify-skills` | Verify skill package metadata, CLI output, and release readiness. |
 
 ---
 
@@ -132,14 +194,65 @@ docs/
 ```
 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 with mandatory related document links
-5. /rules-workflow → Implement each backlog item only after reading linked docs
-6. /verify-docs  → Audit structure, metadata, and Backlog Context Lock compliance
+3. UI-First Gate → Confirm screens, user paths, data flow, and UI states before coding
+4. Pre-Code Technical Brief → Confirm data sources, API shape, state strategy, and acceptance criteria
+5. /docs-dev     → Write DEVELOPMENT_PRINCIPLES.md, DB_SCHEMA.md, API_SPECS.md
+6. /docs-dev     → Write ROADMAP.md, BACKLOG.md with mandatory related document links
+7. /rules-workflow → Implement each backlog item only after reading linked docs and passing UI-First Gate
+8. /verify-implementation  → Audit docs, UI, code, security, performance, DB, and skill package changes
 ```
 
 Backlog items are intentionally document-linked. Each task in `docs/04_Logic_Progress/00_BACKLOG.md` must include related Concept, UI, Technical Spec, and QA documents, plus implementation preconditions, acceptance criteria, and a document sync check. If a related document does not exist, the item must say `N/A - 사유`; implementation should pause when the missing document is required for a safe decision.
 
+### Backlog Context Lock
+
+Backlog Context Lock makes `docs/04_Logic_Progress/00_BACKLOG.md` act as a bridge between planning documents and implementation. A backlog item is not considered ready for coding until it names the documents that define why the task exists, how the UI should behave, what technical constraints apply, and how the work will be verified.
+
+### UI-First Gate
+
+UI-First Gate prevents implementation from starting before the team has reviewed the actual screens and the user's path through them. Before coding, confirm the core screen structure, user entry and exit paths, CTAs, screen-by-screen data flow, loading states, empty states, and error states. If these are missing, update `docs/02_UI_Screens/` or the backlog first.
+
+Required fields for every backlog item:
+
+- `Related Concept Docs`
+- `Related UI Docs`
+- `Related Technical Docs`
+- `Related QA Docs`
+- `Implementation Preconditions`
+- `Acceptance Criteria`
+- `Document Sync Check`
+
+If a related document does not exist, write `N/A - 사유`. Do not leave the field blank. If the missing document is required to make a safe implementation decision, pause implementation and write or update the document first.
+
+**Backlog item template:**
+
+```markdown
+### [ ] TASK-000: Implement feature name
+
+- Status: ToDo
+- Related Concept Docs:
+  - [Product Specs](../01_Concept_Design/03_PRODUCT_SPECS.md) - feature purpose and user value
+- Related UI Docs:
+  - [Screen Flow](../02_UI_Screens/00_SCREEN_FLOW.md) - target screen and interaction flow
+- Related Technical Docs:
+  - [API Specs](../03_Technical_Specs/02_API_SPECS.md) - endpoint and data contract
+- Related QA Docs:
+  - [QA Checklist](../05_QA_Validation/02_QA_CHECKLIST.md) - acceptance and release criteria
+- Implementation Preconditions:
+  - [ ] Read all related documents before coding
+  - [ ] Confirm screen/UI before coding
+  - [ ] Confirm user path and screen-by-screen data flow
+  - [ ] Confirm loading, empty, and error states
+  - [ ] Confirm implementation scope does not conflict with documented intent
+- Acceptance Criteria:
+  - [ ] Feature follows the confirmed screen structure and user path
+  - [ ] Feature behavior matches linked Concept/UI/Technical docs
+  - [ ] QA criteria are testable and satisfied
+- Document Sync Check:
+  - [ ] No mismatch between implementation and linked documents
+  - [ ] Update related documents if implementation changes the agreed behavior
+```
+
 ---
 
 ### Pitch Deck

package/bin/cli.js

@@ -19,7 +19,12 @@ const targetSkillsDir = path.join(targetProjectRoot, '.agent', 'skills');
 
 function getAvailableSkills() {
     return fs.readdirSync(packageRoot, { withFileTypes: true })
-        .filter(dirent => dirent.isDirectory() && !IGNORED_FOLDERS.includes(dirent.name))
+        .filter(dirent => {
+            if (!dirent.isDirectory() || IGNORED_FOLDERS.includes(dirent.name)) {
+                return false;
+            }
+            return fs.existsSync(path.join(packageRoot, dirent.name, 'SKILL.md'));
+        })
         .map(dirent => dirent.name);
 }
 
@@ -42,7 +47,33 @@ function listSkills() {
     const skills = getAvailableSkills();
     console.log('\nAvailable skills to install:');
     skills.forEach(skill => console.log(` - ${skill}`));
-    console.log('\nUsage: npx solmate-skills install <skill-name> | all\n');
+    console.log('\nUtilities:');
+    console.log(' - hooks (install with: npx solmate-skills install hooks)');
+    console.log('\nUsage: npx solmate-skills install <skill-name> | all | hooks\n');
+}
+
+function installHooks() {
+    const sourcePath = path.join(packageRoot, 'hooks');
+    const destPath = path.join(targetSkillsDir, 'hooks');
+
+    if (!fs.existsSync(sourcePath)) {
+        console.error('Error: hooks directory not found.');
+        process.exit(1);
+    }
+
+    console.log('Installing hooks utility...');
+    copyFolderSync(sourcePath, destPath);
+    console.log('Successfully installed hooks utility to .agent/skills/hooks');
+
+    const scriptPath = path.join(destPath, 'install.sh');
+    if (fs.existsSync(scriptPath)) {
+        console.log('Running hook installer...');
+        try {
+            execSync(`bash "${scriptPath}"`, { stdio: 'inherit', cwd: targetProjectRoot });
+        } catch (err) {
+            console.error('Warning: hook installer exited with an error.');
+        }
+    }
 }
 
 function installSkill(skillName) {
@@ -54,6 +85,11 @@ function installSkill(skillName) {
         return;
     }
 
+    if (skillName === 'hooks') {
+        installHooks();
+        return;
+    }
+
     if (!skills.includes(skillName)) {
         console.error(`Error: Skill "${skillName}" not found.`);
         process.exit(1);
@@ -94,11 +130,15 @@ if (!command || command === 'list') {
     }
     if (subCommand === 'all' || subCommand === 'install-all') {
         installSkill('install-all');
+    } else if (subCommand === 'hooks' || subCommand === 'install-hooks') {
+        installHooks();
     } else {
         installSkill(subCommand);
     }
 } else if (command === 'install-all' || command === 'all') {
     installSkill('install-all');
+} else if (command === 'install-hooks' || command === 'hooks') {
+    installHooks();
 } else {
     console.log(`Unknown command: ${command}`);
     listSkills();

package/docs-business/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Business Documents"
+  short_description: "Create structured business plan documents"
+  default_prompt: "Use $docs-business to draft a grant-ready business plan from the project planning docs."

package/docs-dev/SKILL.md

@@ -60,6 +60,10 @@ This skill manages **Layer 3 (Technical_Specs)**, **Layer 4 (Logic_Progress)**,
 
 **Backlog 문서 참조 강제 규칙**: `00_BACKLOG.md`의 모든 작업 항목은 관련 문서를 읽은 뒤 작성해야 하며, 구현자는 코드 작성 전에 해당 문서를 다시 확인해야 한다. 백로그는 단순 ToDo 목록이 아니라 Concept, UI, Technical Spec, QA 기준을 구현으로 연결하는 실행 티켓이어야 한다.
 
+**UI-First Gate 강제 규칙**: 구현 코드는 화면 확인 이후에만 작성한다. 백로그 항목은 관련 UI 문서에서 화면 구조, 사용자 동선, 데이터 흐름, 로딩·빈 상태·오류 상태를 확인했음을 `Implementation Preconditions`에 포함해야 한다. 해당 정보가 없으면 `docs/02_UI_Screens/` 문서부터 보완한다.
+
+**Pre-Code Technical Brief 강제 규칙**: UI 확인 후에도 바로 구현하지 않는다. 데이터 소스, 최소 필드, mutation, 상태 관리 방식, acceptance criteria가 백로그나 기술 문서에 기록되어야 한다. 불명확하면 `docs/03_Technical_Specs/` 문서 또는 백로그 항목을 먼저 보완한다.
+
 Backlog 항목 작성 전 필수 확인 대상:
 - `docs/01_Concept_Design/`: 기능 목적, 사용자 가치, 제품 방향
 - `docs/02_UI_Screens/`: 화면 흐름, UI 상태, 인터랙션
@@ -80,6 +84,11 @@ Backlog 항목 작성 전 필수 확인 대상:
 구현 시작 전 체크:
 - 관련 문서를 실제로 읽었는가?
 - 문서의 요구사항이 Backlog 항목에 반영되어 있는가?
+- 화면 구조와 사용자 동선을 먼저 확인했는가?
+- 화면별 입력·출력 데이터와 상태 변화를 확인했는가?
+- 로딩·빈 상태·오류 상태가 UI 문서나 백로그에 반영되어 있는가?
+- 데이터 소스, 최소 필드, mutation, 상태 관리 방식이 정리되었는가?
+- acceptance criteria가 사용자 시나리오 기준으로 검증 가능한가?
 - 구현 범위가 관련 문서의 의도와 충돌하지 않는가?
 - 관련 QA 기준이 `Acceptance Criteria`에 반영되어 있는가?
 - 누락된 문서가 있다면 `N/A - 사유`가 타당한가?
@@ -185,8 +194,16 @@ Backlog 항목 작성 전 필수 확인 대상:
   - [문서명](../05_QA_Validation/XX_DOCUMENT.md) - 테스트 기준/수용 조건 근거
 - Implementation Preconditions:
   - [ ] 관련 문서 전체 확인 완료
+  - [ ] 화면/UI 선확인 완료
+  - [ ] 사용자 진입·전환·이탈 동선 확인 완료
+  - [ ] 화면별 입력·출력 데이터 및 상태 변화 확인 완료
+  - [ ] 로딩·빈 상태·오류 상태 확인 완료
+  - [ ] 데이터 소스와 최소 필드 확인 완료
+  - [ ] mutation 및 상태 관리 방식 확인 완료
   - [ ] 구현 범위와 문서 요구사항 충돌 없음
 - Acceptance Criteria:
+  - [ ] 구현 결과가 확인된 화면 구조와 사용자 동선을 따른다
+  - [ ] 데이터 흐름과 상태 변화가 Pre-Code Technical Brief와 일치한다
   - [ ] QA 기준이 구현 완료 판단에 반영됨
   - [ ] 핵심 사용자 흐름이 검증됨
 - Document Sync Check:

package/docs-dev/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Development Docs"
+  short_description: "Write technical specs, backlogs, and QA docs"
+  default_prompt: "Use $docs-dev to create technical specs, implementation plans, and QA validation docs."

package/docs-pitch/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Pitch Deck Docs"
+  short_description: "Create investor and demo day pitch decks"
+  default_prompt: "Use $docs-pitch to turn the product planning docs into a concise pitch deck."

package/docs-plan/SKILL.md

@@ -37,9 +37,9 @@ This skill manages **Layer 1 (Concept_Design)** and **Layer 2 (UI_Screens)** —
 - `04_USER_RESEARCH.md` — 사용자 인터뷰, 페르소나, 행동 패턴 (선택, 권장)
 
 **Layer 2 — UI_Screens**
-- `00_SCREEN_FLOW.md` — 전체 사용자 여정
-- `01_UI_DESIGN.md` — 디자인 시스템 (색상, 타이포그래피, 레이아웃)
-- `XX_PROTOTYPE_REVIEW.md` — 페이지별 피드백
+- `00_SCREEN_FLOW.md` — 전체 사용자 여정, 진입·전환·이탈 흐름, 화면별 데이터 입출력
+- `01_UI_DESIGN.md` — 디자인 시스템, 화면 구조, 상태별 UI, 핵심 CTA
+- `XX_PROTOTYPE_REVIEW.md` — 페이지별 화면 확인 결과와 구현 전 피드백
 
 ## 3. Interactive Process (Ask Before Write)
 
@@ -69,6 +69,16 @@ This skill manages **Layer 1 (Concept_Design)** and **Layer 2 (UI_Screens)** —
 15. **The 3 Investor Lenses**: Leverage / Realistic Money Flow / Defensibility — 세 가지를 증명했는가?
 16. **The Future Weapon**: 6~18개월 뒤 시장에서 싸울 강력한 무기는 무엇인가?
 
+### Phase 4 — UI-First Gate (코딩 시작 전 필수)
+
+구현 코드를 작성하기 전 반드시 화면 기준으로 아래 질문에 답한다.
+
+17. **Screen Inventory**: 구현할 주요 화면은 무엇이며, 각 화면의 목적은 무엇인가?
+18. **User Path**: 사용자는 어디서 진입하고, 어떤 CTA를 누르며, 어디로 이동하거나 이탈하는가?
+19. **Data Flow**: 각 화면에서 필요한 입력 데이터, 표시 데이터, 저장/전송 데이터는 무엇인가?
+20. **State Coverage**: 로딩, 빈 상태, 오류 상태, 권한 없음 상태는 화면에서 어떻게 보이는가?
+21. **Prototype Review**: 사용자가 실제 화면, 스크린샷, 와이어프레임, 또는 프로토타입 리뷰를 먼저 확인했는가?
+
 ## 4. Templates
 
 ### Template 0 — User Research (`04_USER_RESEARCH.md`)
@@ -139,10 +149,29 @@ This skill manages **Layer 1 (Concept_Design)** and **Layer 2 (UI_Screens)** —
 ## 2. Key User Flows
 (이 프로토타입에서 시연된 흐름 설명)
 
-## 3. Feedback & Improvements
+## 3. Screen States
+- Default:
+- Loading:
+- Empty:
+- Error:
+- Permission denied / unavailable:
+
+## 4. Data Flow
+- Inputs:
+- Displayed data:
+- Mutations / saved data:
+- External dependencies:
+
+## 5. User Confirmation
+- 화면/UI 선확인 여부:
+- 확인자:
+- 확인 일시:
+- 보완 필요 사항:
+
+## 6. Feedback & Improvements
 (구현 전 변경이 필요한 사항)
 
-## 4. Related Documents
+## 7. Related Documents
 - **Concept_Design**: [Product Specs](../01_Concept_Design/03_PRODUCT_SPECS.md) - 사이트맵 및 사용자 플로우
 - **UI_Screens**: [UI Design](./01_UI_DESIGN.md) - 디자인 시스템 및 컴포넌트 가이드라인
 - **Technical_Specs**: [Related Spec](../03_Technical_Specs/XX_SPEC.md) - 구현 명세 요구사항

package/docs-plan/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Planning Docs"
+  short_description: "Write product vision, concept, and UI docs"
+  default_prompt: "Use $docs-plan to build the product vision, screen flow, and UI planning documents."

package/manage-collaboration/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Collaboration Management"
+  short_description: "Enforce AI-human collaboration protocols"
+  default_prompt: "Use $manage-collaboration to check the repository collaboration rules before changing code."

package/manage-decisions/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Decision Management"
+  short_description: "Guide structured project decisions"
+  default_prompt: "Use $manage-decisions to walk through the questions needed for this technical decision."

package/manage-skills/SKILL.md

@@ -28,7 +28,14 @@ argument-hint: "[선택사항: 특정 스킬 이름 또는 집중할 영역]"
 
 | 스킬 | 설명 | 커버 파일 패턴 |
 |------|------|---------------|
-| `verify-*` | (동적 탐색 수행) | (동적 탐색 수행) |
+| `verify-docs` | 문서 구조, Backlog Context Lock, UI-First Gate | `docs/**/*.md`, `README.md`, `AGENTS.md` |
+| `verify-ui` | 화면 구현과 UI 문서, 사용자 동선, 상태별 UI 정합성 | `src/**/*.tsx`, `src/**/*.jsx`, `docs/02_UI_Screens/**/*.md` |
+| `verify-code` | 코드 품질, 타입, 로직, 사이드 이펙트 | `src/**/*.{ts,tsx,js,jsx}` |
+| `verify-security` | 인증·인가·입력·시크릿·OWASP 보안 | `auth`, `api`, `route`, `middleware`, `.env`, `db` 관련 파일 |
+| `verify-performance` | Lighthouse, Core Web Vitals, 렌더링·번들 | page/layout/image/font/bundle 관련 파일 |
+| `verify-drizzle-schema` | Drizzle 스키마와 기술 명세 정합성 | `schema.ts`, `schema/*.ts`, migration 파일 |
+| `verify-skills` | 스킬 패키지 메타데이터, CLI, README/AGENTS, npm pack | `*/SKILL.md`, `*/agents/openai.yaml`, `bin/cli.js`, `package.json` |
+| `verify-implementation` | 전체 verify 스킬 통합 실행 | 모든 변경 |
 
 ## 워크플로우
 

package/manage-skills/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Skill Maintenance"
+  short_description: "Detect and update drifting verification skills"
+  default_prompt: "Use $manage-skills to inspect whether changed files need new or updated verification skills."

package/package.json

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

package/role-team-lead/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Team Lead Role"
+  short_description: "Apply lead-level release and review protocols"
+  default_prompt: "Use $role-team-lead to review release, branch, migration, and deployment responsibilities."

package/role-team-member/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Team Member Role"
+  short_description: "Apply branch, commit, and PR protocols"
+  default_prompt: "Use $role-team-member to follow the team member branch, commit, and PR workflow."

package/rules-dev/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Development Rules"
+  short_description: "Apply coding, environment, and commit rules"
+  default_prompt: "Use $rules-dev to check development conventions before editing application code."

package/rules-docs/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Documentation Rules"
+  short_description: "Apply the five-layer documentation standard"
+  default_prompt: "Use $rules-docs to decide where a document belongs and how it should link context."