Mandu 피처 생성. 페이지/API/Island 스캐폴딩. '만들어줘', 'create', 'add page' 시 자동 호출
Scanned 9/9/2026
Install to Claude Code
npx -y skills add konamgil/mandu --skill mandu-create-feature --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Mandu Create Feature?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/konamgil-mandu-create-feature)More formats (shields.io, HTML) on the badges page.
---
name: mandu-create-feature
description: |
Mandu 피처 생성. 페이지/API/Island 스캐폴딩. '만들어줘', 'create', 'add page' 시 자동 호출
---
# Mandu Create Feature
Mandu 프로젝트에 새 피처를 생성하는 5단계 워크플로우.
MCP 도구 파이프라인을 통해 페이지, API, Island을 자동 스캐폴딩합니다.
## 5-Phase Workflow
### Phase 1: Negotiate (요구사항 분석)
MCP 도구 `mandu_negotiate`를 호출하여 피처 요구사항을 분석합니다.
```
mandu_negotiate({ description: "사용자 프로필 페이지와 편집 기능" })
```
결과: 필요한 라우트, 컴포넌트, API 엔드포인트 목록이 반환됩니다.
### Phase 2: Add Routes (라우트 생성)
분석 결과를 바탕으로 `mandu_add_route`로 라우트를 생성합니다.
```
mandu_add_route({ path: "/users/[id]", type: "page" })
mandu_add_route({ path: "/api/users/[id]", type: "api" })
```
파일 생성 규칙:
- Page: `app/users/[id]/page.tsx`
- API: `app/api/users/[id]/route.ts`
- Layout: `app/users/layout.tsx`
### Phase 3: Create Contracts (타입 계약)
`mandu_create_contract`로 API 계약을 정의합니다.
```
mandu_create_contract({
name: "user",
methods: ["get", "patch"],
fields: { name: "string", email: "string", avatar: "string?" }
})
```
생성 위치: `src/shared/contracts/user.contract.ts`
### Phase 4: Generate Scaffold (코드 생성)
`mandu_generate`로 전체 스캐폴드를 생성합니다.
```
mandu_generate({ spec: negotiateResult })
```
생성되는 파일:
- `.mandu/generated/server/` - 서버 코드
- `.mandu/generated/web/` - 클라이언트 코드
- `spec/slots/*.slot.ts` - 서버 데이터 로더
- `app/**/*.island.tsx` - Island 컴포넌트
### Phase 5: Guard Heal (아키텍처 검증)
`mandu_guard_heal`로 생성된 코드의 아키텍처 규칙 준수를 검증합니다.
```
mandu_guard_heal({ autofix: true })
```
위반 사항이 있으면 자동 수정을 시도합니다.
## Quick Recipes
### 새 페이지 추가
```
negotiate → add_route(page) → generate
```
### 새 API + 페이지
```
negotiate → add_route(page) → add_route(api) → create_contract → generate → guard_heal
```
### Island 추가
```
negotiate → add_route(page) → generate → island 파일에 "use client" 확인
```
## Key Rules
1. 항상 `mandu_negotiate`부터 시작 (분석 없이 직접 생성하지 않기)
2. API 엔드포인트에는 반드시 contract 생성
3. 생성 후 `mandu_guard_heal`로 검증
4. Layout에 `<html>/<head>/<body>` 태그 사용 금지
5. Island 파일은 `@mandujs/core/client`에서 import
## See also
- `mandu-mcp-create-flow` — MCP 도구 오케스트레이션 순서 (`negotiate → contract → generate`)
- `mandu-mcp-verify` — 생성 직후 자동 검증 루프
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!