mandu-mcp-create-flow

Mandu MCP Create Flow

새 기능을 스캐폴딩할 때의 스펙 우선 레시피. "contract 없이 generate 먼저" 라는 대표적 실수를 방지하고, 가능한 한 집계 도구 (resource/feature/scaffold) 를 사용한다.

Trigger

• "만들어줘", "추가해줘", "create", "add"
• "CRUD" + 엔티티 이름
• 피처 / 라우트 / 리소스 / API 엔드포인트 / 컴포넌트 추가
• mandu-create-feature 또는 mandu-create-api task-shaped skill 이 활성화될 때

Decision Tree

요청의 단위를 먼저 구분한다.

요청 내용
├─ 리소스 단위 (User, Post, Comment 같은 도메인 엔티티)
│    → Track A: Resource flow
├─ 피처 단위 (페이지 + 섹션 + island + slot 세트)
│    → Track B: Feature flow
├─ 단일 라우트 (페이지 하나 또는 API 하나만)
│    → Track C: Route flow
└─ 스키마만 이미 있고 스캐폴드만 필요
     → Track D: Scaffold-only

Track A — Resource Flow (도메인 엔티티)

mandu.resource.create        ← Tier-0 aggregate: resource + fields 묶음 생성
  └─> mandu_create_contract  ← Zod 계약 (집계 도구가 자동으로 요청하지 않을 때만)
       └─> mandu_generate    ← 스캐폴드 생성
            └─> mandu-mcp-verify 로 전이

mandu.resource.create 인자 예:

mandu.resource.create({
  name: "Post",
  fields: { title: "string", content: "string", publishedAt: "datetime?" }
})

리소스가 생성되면 route / slot / contract 의 후보가 제안된다. 제안을 그대로 받아 mandu_generate 로 흘린다. 제안된 경로를 무시하고 mandu_add_route 로 손수 만들지 않는다.

Track B — Feature Flow (페이지 + island + slot)

mandu_analyze_structure         ← alias of mandu.negotiate.analyze, 요구사항 → 구조 제안
  └─> mandu.feature.create      ← Tier-0 aggregate: 여러 라우트 + slot + island 묶음
       └─> mandu_create_contract ← API 엔드포인트가 포함된 경우
            └─> mandu_generate
                 └─> mandu-mcp-verify 로 전이

또는 단축 경로:

mandu_generate_scaffold   ← alias of mandu.negotiate.scaffold,
                            negotiate + scaffold 를 한 번에
  └─> mandu-mcp-verify

사용자가 이미 스키마를 구체적으로 제시했다면 mandu_analyze_structure 는 스킵. "대충 사용자 프로필 페이지 만들어줘" 처럼 모호한 요청일 때만 negotiate 먼저.

Track C — Single Route Flow

mandu_add_route          ← 파일 생성 (경로 규칙 자동 적용)
  └─> mandu_create_contract ← API 라우트면 필수, 페이지만이면 생략 가능
       └─> mandu_generate    ← 스캐폴드 반영
            └─> mandu-mcp-verify