@mandujs/mcp 0.38.12 → 0.39.0-beta.1

package/src/resources/skills/mandu-fs-routes/rules/routes-api-methods.md

@@ -1,65 +0,0 @@
----
-title: Export HTTP Method Functions for API Routes
-impact: HIGH
-impactDescription: RESTful API structure
-tags: routes, api, methods
----
-
-## Export HTTP Method Functions for API Routes
-
-API routes use named exports for each HTTP method: GET, POST, PUT, PATCH, DELETE.
-
-**Incorrect (default export handler):**
-
-```typescript
-// app/api/users/route.ts
-export default function handler(req: Request) {
-  if (req.method === "GET") {
-    return Response.json({ users: [] });
-  }
-}
-```
-
-**Correct (named method exports):**
-
-```typescript
-// app/api/users/route.ts
-
-export function GET() {
-  return Response.json({ users: [] });
-}
-
-export async function POST(request: Request) {
-  const body = await request.json();
-  return Response.json({ created: body }, { status: 201 });
-}
-
-export function DELETE() {
-  return new Response(null, { status: 204 });
-}
-```
-
-## Supported Methods
-
-```typescript
-export function GET(request: Request) { }
-export function POST(request: Request) { }
-export function PUT(request: Request) { }
-export function PATCH(request: Request) { }
-export function DELETE(request: Request) { }
-export function HEAD(request: Request) { }
-export function OPTIONS(request: Request) { }
-```
-
-## With Dynamic Parameters
-
-```typescript
-// app/api/users/[id]/route.ts
-
-export function GET(
-  request: Request,
-  { params }: { params: { id: string } }
-) {
-  return Response.json({ userId: params.id });
-}
-```

package/src/resources/skills/mandu-fs-routes/rules/routes-dynamic-param.md

@@ -1,93 +0,0 @@
----
-title: Use [param] for Dynamic Route Parameters
-impact: MEDIUM
-impactDescription: Enables dynamic URLs
-tags: routes, dynamic, params
----
-
-## Use [param] for Dynamic Route Parameters
-
-Wrap folder name in brackets to create dynamic routes that capture URL segments.
-
-**Incorrect (hardcoded routes):**
-
-```
-app/users/
-├── user1/page.tsx
-├── user2/page.tsx
-└── user3/page.tsx
-```
-
-**Correct (dynamic parameter):**
-
-```
-app/users/
-└── [id]/
-    └── page.tsx    → /users/:id
-```
-
-## Accessing Parameters
-
-### In Page Components
-
-```tsx
-// app/users/[id]/page.tsx
-
-interface Props {
-  params: { id: string };
-}
-
-export default function UserPage({ params }: Props) {
-  return <h1>User ID: {params.id}</h1>;
-}
-```
-
-### In API Routes
-
-```typescript
-// app/api/users/[id]/route.ts
-
-export function GET(
-  request: Request,
-  { params }: { params: { id: string } }
-) {
-  return Response.json({ userId: params.id });
-}
-```
-
-## Multiple Parameters
-
-```
-app/posts/[postId]/comments/[commentId]/page.tsx
-→ /posts/:postId/comments/:commentId
-```
-
-```tsx
-interface Props {
-  params: { postId: string; commentId: string };
-}
-
-export default function CommentPage({ params }: Props) {
-  return (
-    <div>
-      Post: {params.postId}, Comment: {params.commentId}
-    </div>
-  );
-}
-```
-
-## Catch-All Routes
-
-```
-app/docs/[...slug]/page.tsx → /docs/a, /docs/a/b, /docs/a/b/c
-```
-
-```tsx
-interface Props {
-  params: { slug: string[] };
-}
-
-export default function DocsPage({ params }: Props) {
-  return <p>Path: {params.slug.join("/")}</p>;
-}
-```

package/src/resources/skills/mandu-fs-routes/rules/routes-naming-page.md

@@ -1,55 +0,0 @@
----
-title: Use page.tsx for Page Components
-impact: CRITICAL
-impactDescription: Required for routing to work
-tags: routes, page, naming
----
-
-## Use page.tsx for Page Components
-
-Page components must be named `page.tsx`. This is how Mandu recognizes
-which files should become routes.
-
-**Incorrect (wrong filename):**
-
-```
-app/
-├── about/
-│   └── About.tsx      ❌ Won't be recognized
-└── users/
-    └── index.tsx      ❌ Won't be recognized
-```
-
-**Correct (page.tsx):**
-
-```
-app/
-├── about/
-│   └── page.tsx       ✅ → /about
-└── users/
-    └── page.tsx       ✅ → /users
-```
-
-## Page Component Structure
-
-```tsx
-// app/about/page.tsx
-
-export default function AboutPage() {
-  return (
-    <div>
-      <h1>About Us</h1>
-    </div>
-  );
-}
-```
-
-## Special Files
-
-| File | Purpose |
-|------|---------|
-| `page.tsx` | Page component |
-| `layout.tsx` | Shared layout |
-| `loading.tsx` | Loading UI |
-| `error.tsx` | Error boundary |
-| `route.ts` | API handler |

package/src/resources/skills/mandu-guard/SKILL.md

@@ -1,162 +0,0 @@
----
-name: mandu-guard
-description: |
-  Architecture guard system for Mandu. Use when checking layer dependencies,
-  enforcing architecture rules, or validating file locations. Triggers on
-  tasks involving architecture, layers, dependencies, or guard commands.
-license: MIT
-metadata:
-  author: mandu
-  version: "1.0.0"
----
-
-# Mandu Guard
-
-Mandu Guard는 아키텍처 규칙을 강제하는 시스템입니다.
-레이어 간 의존성을 검사하고 위반을 실시간으로 감지합니다.
-
-## Agent Workflow Contract
-
-This skill is a Domain addendum. It must not replace `mandu-agent-workflow`.
-Use it only after `mandu.agent.verify` reports guard diagnostics or `mandu.agent.plan` selects the guard domain.
-
-Canonical workflow step: `verify -> repair`.
-
-Preferred MCP tools:
-
-| Step | Tools |
-|------|-------|
-| plan | `mandu.agent.plan` |
-| verify | `mandu.agent.verify`, `mandu.guard.check`, `mandu.guard.explain` |
-| repair | `mandu.agent.repair`, `mandu.guard.heal` |
-
-Allowed file edits:
-
-- Source files that violate import/layer rules
-- `mandu.config.*` guard settings only when the plan explicitly changes policy
-- Generated files are not direct-edit targets
-
-Verification command:
-
-```bash
-mandu agent verify --changed --json --write
-```
-
-Common failures:
-
-- Running low-level guard commands before reading the agent verify report
-- Weakening guard config instead of fixing the import boundary
-- Directly editing generated files to silence diagnostics
-
-Repair path:
-
-```bash
-mandu agent repair --from .mandu/agent-verify.json --json
-```
-
-## When to Apply
-
-Reference these guidelines when:
-- Setting up architecture rules
-- Checking layer dependencies
-- Validating import paths
-- Running architecture checks in CI
-- Configuring guard presets
-
-## Rule Categories by Priority
-
-| Priority | Category | Impact | Prefix |
-|----------|----------|--------|--------|
-| 1 | Layer Rules | CRITICAL | `guard-layer-` |
-| 2 | Presets | HIGH | `guard-preset-` |
-| 3 | Validation | HIGH | `guard-validate-` |
-| 4 | Configuration | MEDIUM | `guard-config-` |
-
-## Quick Reference
-
-### 1. Layer Rules (CRITICAL)
-
-- `guard-layer-direction` - Dependencies flow downward only
-- `guard-layer-violation` - Detect and fix layer violations
-- `guard-layer-same-level` - Restrict same-layer imports
-
-### 2. Presets (HIGH)
-
-- `guard-preset-mandu` - FSD + Clean hybrid (default)
-- `guard-preset-fsd` - Feature-Sliced Design
-- `guard-preset-clean` - Clean Architecture
-- `guard-preset-hexagonal` - Hexagonal/Ports & Adapters
-
-### 3. Validation (HIGH)
-
-- `guard-validate-import` - Check import path validity
-- `guard-validate-location` - Check file location
-- `guard-validate-naming` - Check naming conventions
-
-### 4. Configuration (MEDIUM)
-
-- `guard-config-rules` - Configure rule severity
-- `guard-config-ignore` - Configure ignored paths
-
-## Mandu Preset Layers
-
-### Frontend (FSD)
-
-```
-app          # Top: app entry point
-  ↓
-pages        # Page components
-  ↓
-widgets      # Complex UI blocks
-  ↓
-features     # Feature units
-  ↓
-entities     # Business entities
-  ↓
-shared       # Shared utilities
-```
-
-### Backend (Clean)
-
-```
-api          # Top: API entry point
-  ↓
-application  # Use cases
-  ↓
-domain       # Business logic
-  ↓
-infra        # Infrastructure (DB, external APIs)
-  ↓
-core         # Core utilities
-  ↓
-shared       # Shared
-```
-
-## Validation Rules
-
-| Rule ID | Description |
-|---------|-------------|
-| `LAYER_VIOLATION` | Layer dependency violation |
-| `GENERATED_DIRECT_EDIT` | Direct edit of generated files |
-| `WRONG_SLOT_LOCATION` | Wrong slot file location |
-| `SLOT_NAMING` | Slot file naming rule violation |
-| `FORBIDDEN_IMPORT` | Forbidden import (fs, child_process, etc.) |
-
-## Low-Level CLI Commands
-
-Use these only when `agent verify` or `agent repair` asks for guard-specific detail:
-
-```bash
-mandu agent verify --changed --json --write
-mandu guard arch --ci
-mandu guard arch --preset fsd
-```
-
-## How to Use
-
-Read individual rule files for detailed explanations:
-
-```
-rules/guard-layer-direction.md
-rules/guard-preset-mandu.md
-```

package/src/resources/skills/mandu-guard/metadata.json

@@ -1,12 +0,0 @@
-{
-  "version": "1.0.0",
-  "organization": "Mandu Framework",
-  "date": "February 2026",
-  "abstract": "아키텍처 가드 시스템 가이드. 레이어 간 의존성 규칙을 강제하고 위반을 실시간으로 감지합니다. FSD, Clean Architecture, Hexagonal 등 다양한 프리셋을 지원하며, CI/CD 파이프라인에 통합할 수 있습니다.",
-  "references": [
-    "https://feature-sliced.design/",
-    "https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html",
-    "https://alistair.cockburn.us/hexagonal-architecture/"
-  ],
-  "tags": ["guard", "architecture", "layers", "dependencies", "mandu"]
-}

package/src/resources/skills/mandu-guard/rules/_sections.md

@@ -1,36 +0,0 @@
-# Sections
-
-This file defines all sections, their ordering, impact levels, and descriptions.
-The section ID (in parentheses) is the filename prefix used to group rules.
-
----
-
-## 1. Layer Rules (guard-layer)
-
-**Impact:** CRITICAL
-**Description:** 레이어 의존성 방향 규칙. 상위→하위만 허용, 역방향 import 금지. 아키텍처 무결성의 핵심입니다.
-
-## 2. Presets (guard-preset)
-
-**Impact:** HIGH
-**Description:** mandu, fsd, clean, hexagonal 프리셋 선택. 프로젝트 유형에 맞는 아키텍처 템플릿입니다.
-
-## 3. Validation (guard-validate)
-
-**Impact:** HIGH
-**Description:** import 경로, 파일 위치, 네이밍 검증. 실시간 위반 감지와 리포팅입니다.
-
-## 4. Configuration (guard-config)
-
-**Impact:** MEDIUM
-**Description:** 규칙 severity 설정, ignore 패턴. 프로젝트 특성에 맞게 가드를 커스터마이징합니다.
-
-## 5. CI Integration (guard-ci)
-
-**Impact:** MEDIUM
-**Description:** --ci 플래그, exit code, 리포트 생성. 자동화된 아키텍처 검증 파이프라인입니다.
-
-## 6. Auto Fix (guard-fix)
-
-**Impact:** LOW
-**Description:** --auto-correct 옵션. 일부 위반의 자동 수정 기능입니다.

package/src/resources/skills/mandu-guard/rules/_template.md

@@ -1,82 +0,0 @@
-# Rule Template
-
-Use this template when creating new rules for mandu-guard.
-
----
-
-```markdown
----
-title: Rule Title Here
-impact: CRITICAL | HIGH | MEDIUM | LOW
-impactDescription: 영향 설명
-tags: guard, tag1, tag2
----
-
-## Rule Title Here
-
-**Impact: {LEVEL} ({impactDescription})**
-
-규칙의 목적과 중요성을 설명합니다.
-
-**Incorrect (위반 예시):**
-
-\`\`\`typescript
-// ❌ entities → features (역방향 의존)
-// src/entities/user/index.ts
-import { useAuth } from "@/features/auth";  // VIOLATION!
-
-export function User() {
-  const { isLoggedIn } = useAuth();
-}
-\`\`\`
-
-**Correct (올바른 방향):**
-
-\`\`\`typescript
-// ✅ features → entities (순방향 의존)
-// src/features/auth/index.ts
-import { User } from "@/entities/user";
-
-export function useAuth() {
-  const user = getCurrentUser();
-  return { user, isLoggedIn: !!user };
-}
-\`\`\`
-
-## CLI Command
-
-\`\`\`bash
-bunx mandu guard arch --ci
-\`\`\`
-
-Reference: [관련 문서 링크](https://example.com)
-```
-
----
-
-## Naming Convention
-
-- 파일명: `{section}-{rule-name}.md`
-- 예시: `guard-layer-direction.md`, `guard-preset-mandu.md`
-
-## Layer Hierarchy Quick Reference
-
-### Frontend (FSD)
-```
-app → pages → widgets → features → entities → shared
-```
-
-### Backend (Clean)
-```
-api → application → domain → infra → core → shared
-```
-
-## Rule IDs Quick Reference
-
-| Rule ID | Description |
-|---------|-------------|
-| `LAYER_VIOLATION` | 레이어 의존성 위반 |
-| `GENERATED_DIRECT_EDIT` | generated 파일 직접 수정 |
-| `WRONG_SLOT_LOCATION` | 잘못된 slot 파일 위치 |
-| `SLOT_NAMING` | slot 파일 이름 규칙 위반 |
-| `FORBIDDEN_IMPORT` | 금지된 import |

package/src/resources/skills/mandu-guard/rules/guard-config-rules.md

@@ -1,100 +0,0 @@
----
-title: Configure Rule Severity Levels
-impact: MEDIUM
-impactDescription: Customize guard behavior
-tags: guard, config, rules
----
-
-## Configure Rule Severity Levels
-
-Set severity levels for each guard rule based on your project needs.
-
-## Severity Levels
-
-| Level | Behavior | Use Case |
-|-------|----------|----------|
-| `error` | Fails check, blocks CI | Critical violations |
-| `warn` | Reports issue, continues | Gradual migration |
-| `off` | Ignores rule | Not applicable to project |
-
-## Configuration File
-
-```typescript
-// mandu.config.ts
-
-export default {
-  guard: {
-    preset: "mandu",
-    rules: {
-      // Core rules
-      "LAYER_VIOLATION": "error",      // Always enforce layers
-      "GENERATED_DIRECT_EDIT": "error", // Protect generated files
-
-      // Naming rules
-      "SLOT_NAMING": "warn",           // Warn during migration
-      "WRONG_SLOT_LOCATION": "error",
-
-      // Security rules
-      "FORBIDDEN_IMPORT": "error",     // Block dangerous imports
-    },
-  },
-};
-```
-
-## Available Rules
-
-| Rule ID | Default | Description |
-|---------|---------|-------------|
-| `LAYER_VIOLATION` | error | Layer dependency violation |
-| `GENERATED_DIRECT_EDIT` | error | Direct edit of generated files |
-| `WRONG_SLOT_LOCATION` | error | Slot file in wrong directory |
-| `SLOT_NAMING` | error | Incorrect slot file naming |
-| `FORBIDDEN_IMPORT` | warn | Importing fs, child_process, etc. in browser code |
-| `CIRCULAR_DEPENDENCY` | warn | Circular import detected |
-| `DEEP_IMPORT` | warn | Importing from nested paths instead of index |
-
-## Ignoring Paths
-
-```typescript
-export default {
-  guard: {
-    ignore: [
-      "**/test/**",       // Test files
-      "**/*.test.ts",     // Test files
-      "**/*.spec.ts",     // Spec files
-      "**/mocks/**",      // Mock files
-      "scripts/**",       // Build scripts
-    ],
-  },
-};
-```
-
-## Per-File Override
-
-```typescript
-// src/features/legacy/index.ts
-
-// @guard-disable LAYER_VIOLATION
-import { oldHelper } from "@/entities/legacy";  // Allowed temporarily
-// @guard-enable LAYER_VIOLATION
-```
-
-## Gradual Migration
-
-```typescript
-// Start with warnings for legacy code
-{
-  rules: {
-    "LAYER_VIOLATION": "warn",  // Start with warn
-    "SLOT_NAMING": "off",       // Fix later
-  }
-}
-
-// After migration, enforce strictly
-{
-  rules: {
-    "LAYER_VIOLATION": "error", // Now enforce
-    "SLOT_NAMING": "error",     // Now enforce
-  }
-}
-```

package/src/resources/skills/mandu-guard/rules/guard-layer-direction.md

@@ -1,76 +0,0 @@
----
-title: Dependencies Must Flow Downward Only
-impact: CRITICAL
-impactDescription: Core architecture principle
-tags: guard, layer, dependency
----
-
-## Dependencies Must Flow Downward Only
-
-In layered architecture, imports must always flow from higher to lower layers.
-
-**Incorrect (upward dependency):**
-
-```typescript
-// ❌ entities/user/index.ts importing from features (higher layer)
-import { useAuth } from "@/features/auth";
-
-export function User() {
-  const { isLoggedIn } = useAuth();  // VIOLATION!
-  // ...
-}
-```
-
-**Correct (downward dependency):**
-
-```typescript
-// ✅ features/auth/index.ts importing from entities (lower layer)
-import { User } from "@/entities/user";
-
-export function useAuth() {
-  const user = getCurrentUser();  // Uses entity
-  return { user, isLoggedIn: !!user };
-}
-```
-
-## Layer Hierarchy (Mandu Preset)
-
-### Frontend Layers (top to bottom)
-
-```
-app         → Can import: pages, widgets, features, entities, shared
-pages       → Can import: widgets, features, entities, shared
-widgets     → Can import: features, entities, shared
-features    → Can import: entities, shared
-entities    → Can import: shared
-shared      → Can import: (nothing above)
-```
-
-### Backend Layers (top to bottom)
-
-```
-api         → Can import: application, domain, infra, core, shared
-application → Can import: domain, infra, core, shared
-domain      → Can import: core, shared
-infra       → Can import: core, shared
-core        → Can import: shared
-shared      → Can import: (nothing above)
-```
-
-## Common Violations
-
-| Violation | Fix |
-|-----------|-----|
-| Entity imports Feature | Move shared logic to Entity or Shared |
-| Domain imports API | Use dependency injection |
-| Shared imports Feature | Extract to Shared or keep in Feature |
-
-## Checking Dependencies
-
-```bash
-# Check all architecture rules
-bunx mandu guard arch
-
-# Check specific file
-bunx mandu guard check src/entities/user/index.ts
-```