guide-maker

name	guide-maker
description	Place 프로젝트 사용자 가이드를 Notion에 생성하는 스킬. 테이블, 색상, 코드블록, 화살표, 이모지를 활용한 가시성 높은 문서 생성. "가이드 만들어줘", "사용자 매뉴얼 작성해줘", "도움말 문서 생성해줘", "Notion에 문서 작성해줘" 요청 시 사용. Notion MCP (MCP_DOCKER) 필요.

Guide Maker

Place 프로젝트 기능에 대한 가시성 높은 사용자 가이드를 Notion에 생성.

사전 요구사항

• Notion MCP (MCP_DOCKER) 연결
• 부모 페이지 ID: 0656783731824d52aa4ac9523521bd14

워크플로우

1. 기능 분석

해당 기능의 코드(app/ 폴더) 분석 → 주요 버튼, 폼, 테이블, 상태값 파악

2. 콘텐츠 구조 설계

문서 구조에 맞춰 전체 블록 배열 설계 (페이지 위치, Part별 Step, 테이블, FAQ 등)

3. 한 번에 생성 (🚨 필수!)

반드시 code-mode 스크립트 한 번으로 전체 가이드 생성:

// 1. 페이지 생성
const result = JSON.parse(this['API-post-page']({
  parent: { page_id: "0656783731824d52aa4ac9523521bd14" },
  properties: { title: [{ text: { content: "📑 [기능명]" } }] }
}));
const pageId = result.id;

// 2. 모든 블록을 하나의 배열로 구성
const allBlocks = [
  // Part 1 헤더 + Step 1~N + divider
  // Part 2 헤더 + Step 1~N + divider
  // 테이블들
  // FAQ 토글들
];

// 3. 단 한 번의 API 호출로 콘텐츠 추가
this['API-patch-block-children']({ block_id: pageId, children: allBlocks });

return `https://www.notion.so/${pageId.replace(/-/g, '')}`;

❌ 금지: Step별/Part별로 나눠서 여러 번 API 호출 ✅ 필수: 전체 블록을 하나의 배열로 → 단 1회 API 호출

4. 완료

URL 전달: https://www.notion.so/[page_id_without_hyphens]

---

문서 구조 (필수)

## 페이지 위치
**가맹점 대시보드** → **기능명**
[이미지]
---

## [기능] 방법

### Step 1. [작업 제목]
[설명]
[이미지]
1. **'버튼명'**을 클릭합니다.
2. [동작]
💡 Tip: [정보]
---

### Step 2. ...

## [테이블명] 컬럼 설명
| 컬럼명 | 설명 |
|--------|------|
| ... | ... |
---

## [상태] 안내
| 상태 | 색상 | 설명 |
|------|------|------|
| ✅ 완료 | 🟢 초록 | ... |
| ⏳ 대기 | 🟡 노랑 | ... |
| ❌ 실패 | 🔴 빨강 | ... |
---

## 자주 묻는 질문
> Q: [질문]?
A: [답변]

---

가시성 원칙

요소	용도	예시
테이블	컬럼/상태/필드 설명	상태 테이블, 입력 필드 테이블
→ 화살표	경로/흐름	대시보드 → 원비청구
이모지+색상	상태 구분	✅ 완납 🟢, ❌ 미납 🔴
굵은 텍스트	버튼/메뉴 강조	**'저장'**
인라인 코드	입력값/형식	`010-1234-5678`
콜아웃	팁/주의/자동화	💡⚠️⚡
코드 블록	예시 데이터	입력 예시

---

레퍼런스

• Notion 블록 JSON: references/notion-blocks.md
• 가시성 패턴 예시: references/visual-patterns.md

---

체크리스트

필수

• 페이지 위치 (→ 화살표 + 이미지)
• 모든 Step에 이미지 블록
• 버튼/메뉴: '작은따옴표'와 굵게
• 각 Step 끝에 divider
• FAQ 섹션 (최소 3개 토글)

가시성

• 컬럼 설명 테이블
• 상태값 테이블 (이모지+색상)
• 입력 형식: 인라인 코드
• 콜아웃 활용 (💡⚠️⚡)