@tekton-ui/mcp-server 0.3.0 β†’ 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -10,8 +10,8 @@ MCP (Model Context Protocol) server enabling AI-driven blueprint generation, the
10
10
 
11
11
  ## Features
12
12
 
13
- - **πŸ€– stdio MCP Protocol**: Claude Code native tool registration via JSON-RPC 2.0 (13 tools)
14
- - **🎨 Theme Preview**: 13 built-in OKLCH-based themes with CSS variable generation
13
+ - **πŸ€– stdio MCP Protocol**: Claude Code native tool registration via JSON-RPC 2.0 (16 tools)
14
+ - **🎨 Theme Preview**: 6 built-in OKLCH-based themes with CSS variable generation
15
15
  - **πŸ“‹ Blueprint Generation**: Natural language β†’ Blueprint JSON with validation
16
16
  - **πŸ’Ύ Data-Only Output**: No file system writes, Claude Code handles file operations
17
17
  - **πŸš€ Production Export**: JSX, TSX, Vue code generation
@@ -42,49 +42,71 @@ TEKTON_API_KEY=tk_live_xxx...
42
42
  TEKTON_API_URL=https://tekton-ui.com # or http://localhost:3000 for dev
43
43
  ```
44
44
 
45
- ### Theme Access Tiers
45
+ ### Theme Access
46
46
 
47
- **Free Themes** (No authentication required):
47
+ **All Themes** (Requires valid API key and license):
48
48
 
49
- - `next-tailwind-shadcn`
50
- - `vite-tailwind-shadcn`
51
- - `next-styled-components`
52
- - `next-tailwind-radix`
53
- - `saas-modern`
54
- - `tech-startup`
49
+ - `classic-magazine` - Classic magazine style
50
+ - `equinox-fitness` - Fitness & wellness
51
+ - `minimal-workspace` - Minimal workspace
52
+ - `neutral-humanism` - Neutral humanism
53
+ - `round-minimal` - Round minimal
54
+ - `square-minimalism` - Square minimalism
55
55
 
56
- **Premium Themes** (Requires valid API key and license):
57
-
58
- - `calm-wellness` - Serene wellness applications
59
- - `dynamic-fitness` - Energetic fitness tracking
60
- - `korean-fintech` - Professional financial services
61
- - `media-streaming` - Video/audio streaming platforms
62
- - `premium-editorial` - Sophisticated content platforms
63
- - `saas-dashboard` - Modern SaaS dashboards
64
- - `warm-humanist` - Warm and inviting experiences
56
+ **Note:** All 6 themes require authentication. No free themes are available.
65
57
 
66
58
  ### Authentication Behavior
67
59
 
68
60
  **Without API Key**:
69
61
 
70
62
  - Server starts normally
71
- - Only free themes are accessible
72
- - Premium themes return authentication error
63
+ - All theme access attempts return authentication error
64
+ - Tools function but theme-related operations require auth
73
65
 
74
66
  **With Valid API Key**:
75
67
 
76
68
  - Server verifies key on startup (cached for 5 minutes)
77
- - Free themes always accessible
78
- - Licensed premium themes become accessible
79
- - Unlicensed premium themes return license error
69
+ - Licensed themes become accessible
70
+ - Unlicensed themes return license error
80
71
 
81
72
  **With Invalid API Key**:
82
73
 
83
74
  - Server logs error but continues running
84
- - Falls back to free themes only
75
+ - Falls back to no theme access
85
76
  - Does not crash the server
86
77
 
87
- ## Quick Start
78
+ ## Quick Start: `init` Command
79
+
80
+ ν”„λ‘œμ νŠΈμ— Tekton UIλ₯Ό ν•œ μ€„λ‘œ μ„€μ •ν•©λ‹ˆλ‹€.
81
+
82
+ ```bash
83
+ npx @tekton-ui/mcp-server init
84
+ ```
85
+
86
+ μžλ™μœΌλ‘œ μˆ˜ν–‰λ˜λŠ” μž‘μ—…:
87
+
88
+ 1. **ν”„λ‘œμ νŠΈ 감지** - Next.js / Vite μžλ™ 인식
89
+ 2. **νŒ¨ν‚€μ§€ μ„€μΉ˜** - `@tekton-ui/ui`, `tailwindcss-animate` (νŒ¨ν‚€μ§€ λ§€λ‹ˆμ € μžλ™ 감지: pnpm/yarn/bun/npm)
90
+ 3. **Tailwind CSS μ„€μ •** - `tailwind.config.ts`에 content 경둜 및 animate ν”ŒλŸ¬κ·ΈμΈ μΆ”κ°€
91
+ 4. **CSS 토큰 μž„ν¬νŠΈ** - `globals.css`에 `@import '@tekton-ui/ui/styles'` μΆ”κ°€
92
+ 5. **MCP μ—°κ²°** - `.mcp.json`에 tekton μ„œλ²„ 등둝 (ν”„λ‘œμ νŠΈ 루트)
93
+ 6. **κ°€μ΄λ“œ 생성** - `TEKTON-GUIDE.md` ν”„λ‘œμ νŠΈ λ£¨νŠΈμ— 생성
94
+ 7. **AI μ—μ΄μ „νŠΈ κ°€μ΄λ“œ** - `CLAUDE.md` 및 `AGENTS.md`에 Tekton μ›Œν¬ν”Œλ‘œμš° μ„Ήμ…˜ μΆ”κ°€
95
+ 8. **μ™„λ£Œ μ•ˆλ‚΄** - 인증 ν•„μš”μ„± 및 λ‹€μŒ 단계 μ•ˆλ‚΄
96
+
97
+ μ„€μ • μ™„λ£Œ ν›„ Claude Codeλ₯Ό μž¬μ‹œμž‘ν•˜λ©΄, AIμ—κ²Œ "둜그인 ν™”λ©΄ λ§Œλ“€μ–΄μ€˜"와 같이 μžμ—°μ–΄λ‘œ ν™”λ©΄ 생성을 μš”μ²­ν•  수 μžˆμŠ΅λ‹ˆλ‹€.
98
+
99
+ ### CLI Commands
100
+
101
+ | Command | Description |
102
+ | -------------------------------- | --------------------- |
103
+ | `npx @tekton-ui/mcp-server` | MCP stdio μ„œλ²„ μ‹œμž‘ |
104
+ | `npx @tekton-ui/mcp-server init` | ν”„λ‘œμ νŠΈ 초기 μ„€μ • |
105
+ | `tekton-mcp login` | λΈŒλΌμš°μ € OAuth 둜그인 |
106
+ | `tekton-mcp logout` | λ‘œκ·Έμ•„μ›ƒ |
107
+ | `tekton-mcp status` | 인증 μƒνƒœ 확인 |
108
+
109
+ ## Development Quick Start
88
110
 
89
111
  ### 1. Build the Server
90
112
 
@@ -104,26 +126,20 @@ pnpm inspect
104
126
 
105
127
  See [Claude Code Integration Guide](../../.moai/specs/SPEC-MCP-002/CLAUDE-CODE-INTEGRATION.md) for complete setup instructions.
106
128
 
107
- **Quick Config** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
129
+ **Quick Config** (ν”„λ‘œμ νŠΈ 루트 `.mcp.json`):
108
130
 
109
131
  ```json
110
132
  {
111
133
  "mcpServers": {
112
134
  "tekton": {
113
- "command": "node",
114
- "args": ["/absolute/path/to/tekton/packages/mcp-server/dist/index.js"],
115
- "env": {
116
- "NODE_ENV": "production",
117
- "TEKTON_API_KEY": "tk_live_your_api_key_here",
118
- "TEKTON_API_URL": "https://tekton-ui.com"
119
- }
135
+ "type": "stdio",
136
+ "command": "npx",
137
+ "args": ["-y", "@tekton-ui/mcp-server"]
120
138
  }
121
139
  }
122
140
  }
123
141
  ```
124
142
 
125
- **Note**: Remove `TEKTON_API_KEY` from env to run with free themes only.
126
-
127
143
  ## MCP Tools
128
144
 
129
145
  ### 1. Generate Blueprint
@@ -584,6 +600,42 @@ See [Claude Code Integration Guide](../../.moai/specs/SPEC-MCP-002/CLAUDE-CODE-I
584
600
 
585
601
  **Total Templates**: 13
586
602
 
603
+ ## MCP Prompts (Universal Guidance)
604
+
605
+ The MCP server provides 2 built-in prompts that work across all MCP clients:
606
+
607
+ ### 1. getting-started
608
+
609
+ **Purpose**: Complete onboarding guide for Tekton UI
610
+
611
+ **Content**:
612
+
613
+ - Authentication setup (tekton-mcp login)
614
+ - Theme exploration workflow
615
+ - Component availability checking
616
+ - 4-step screen generation workflow
617
+ - Common mistakes and troubleshooting
618
+
619
+ **When to use**: First-time users, onboarding, workflow overview
620
+
621
+ ### 2. screen-workflow
622
+
623
+ **Purpose**: Detailed 4-step production workflow
624
+
625
+ **Content**:
626
+
627
+ - Step 1/4: get-screen-generation-context
628
+ - Step 2/4: validate-screen-definition
629
+ - Step 3/4: generate_screen
630
+ - Step 4/4: validate-environment
631
+ - Complete examples and troubleshooting
632
+
633
+ **When to use**: Production screen generation, workflow clarification
634
+
635
+ **Note**: These prompts are platform-agnostic and work with Claude Code, OpenAI Codex, Cursor, Windsurf, and any MCP-compatible client.
636
+
637
+ **Total Prompts**: 2
638
+
587
639
  ### 11. Preview Screen Template
588
640
 
589
641
  **Tool**: `preview-screen-template`
@@ -806,24 +858,19 @@ packages/mcp-server/
806
858
  - ❌ HTTP endpoints removed (moved to SPEC-PLAYGROUND-001)
807
859
  - ❌ previewUrl/filePath removed from outputs
808
860
 
809
- ## Built-in Themes (13 Total)
810
-
811
- 1. `calm-wellness` - Serene wellness applications
812
- 2. `dynamic-fitness` - Energetic fitness tracking
813
- 3. `korean-fintech` - Professional financial services
814
- 4. `media-streaming` - Video/audio streaming platforms
815
- 5. `next-styled-components` - Next.js with styled-components
816
- 6. `next-tailwind-radix` - Next.js + Tailwind + Radix UI
817
- 7. `next-tailwind-shadcn` - Next.js + Tailwind + shadcn/ui
818
- 8. `premium-editorial` - Sophisticated content platforms
819
- 9. `saas-dashboard` - Modern SaaS dashboards
820
- 10. `saas-modern` - Clean SaaS applications
821
- 11. `tech-startup` - Tech startup vibes
822
- 12. `vite-tailwind-shadcn` - Vite + Tailwind + shadcn/ui
823
- 13. `warm-humanist` - Warm and inviting experiences
861
+ ## Built-in Themes (6 Total)
862
+
863
+ 1. `classic-magazine` - Classic magazine style
864
+ 2. `equinox-fitness` - Fitness & wellness
865
+ 3. `minimal-workspace` - Minimal workspace
866
+ 4. `neutral-humanism` - Neutral humanism
867
+ 5. `round-minimal` - Round minimal
868
+ 6. `square-minimalism` - Square minimalism
824
869
 
825
870
  **CSS Format**: All color values use OKLCH format for perceptual uniformity
826
871
 
872
+ **Authentication**: All themes require valid API key and license
873
+
827
874
  ## Quality Metrics (SPEC-MCP-002 v2.0.0)
828
875
 
829
876
  | Metric | Target | Current | Status |
@@ -3,7 +3,7 @@
3
3
  * SPEC-DEPLOY-001: λͺ¨λ“  ν…Œλ§ˆ 유료 - 인증 ν•„μˆ˜
4
4
  */
5
5
  /**
6
- * λͺ¨λ“  프리미엄 ν…Œλ§ˆ λͺ©λ‘
6
+ * λͺ¨λ“  프리미엄 ν…Œλ§ˆ λͺ©λ‘ (μ‹€μ œ μ‘΄μž¬ν•˜λŠ” 6개 ν…Œλ§ˆλ§Œ)
7
7
  * 인증된 μ‚¬μš©μžλ§Œ λΌμ΄μ„ μŠ€ 보유 ν…Œλ§ˆμ— μ ‘κ·Ό κ°€λŠ₯
8
8
  */
9
9
  export declare const PREMIUM_THEMES: string[];
@@ -1 +1 @@
1
- {"version":3,"file":"theme-access.d.ts","sourceRoot":"","sources":["../../src/auth/theme-access.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc,UAc1B,CAAC"}
1
+ {"version":3,"file":"theme-access.d.ts","sourceRoot":"","sources":["../../src/auth/theme-access.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc,UAO1B,CAAC"}
@@ -3,22 +3,15 @@
3
3
  * SPEC-DEPLOY-001: λͺ¨λ“  ν…Œλ§ˆ 유료 - 인증 ν•„μˆ˜
4
4
  */
5
5
  /**
6
- * λͺ¨λ“  프리미엄 ν…Œλ§ˆ λͺ©λ‘
6
+ * λͺ¨λ“  프리미엄 ν…Œλ§ˆ λͺ©λ‘ (μ‹€μ œ μ‘΄μž¬ν•˜λŠ” 6개 ν…Œλ§ˆλ§Œ)
7
7
  * 인증된 μ‚¬μš©μžλ§Œ λΌμ΄μ„ μŠ€ 보유 ν…Œλ§ˆμ— μ ‘κ·Ό κ°€λŠ₯
8
8
  */
9
9
  export const PREMIUM_THEMES = [
10
- 'calm-wellness',
11
- 'dynamic-fitness',
12
- 'korean-fintech',
13
- 'media-streaming',
14
- 'premium-editorial',
15
- 'saas-dashboard',
16
- 'warm-humanist',
17
- 'next-tailwind-shadcn',
18
- 'vite-tailwind-shadcn',
19
- 'next-styled-components',
20
- 'next-tailwind-radix',
21
- 'saas-modern',
22
- 'tech-startup',
10
+ 'classic-magazine',
11
+ 'equinox-fitness',
12
+ 'minimal-workspace',
13
+ 'neutral-humanism',
14
+ 'round-minimal',
15
+ 'square-minimalism',
23
16
  ];
24
17
  //# sourceMappingURL=theme-access.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"theme-access.js","sourceRoot":"","sources":["../../src/auth/theme-access.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,eAAe;IACf,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,mBAAmB;IACnB,gBAAgB;IAChB,eAAe;IACf,sBAAsB;IACtB,sBAAsB;IACtB,wBAAwB;IACxB,qBAAqB;IACrB,aAAa;IACb,cAAc;CACf,CAAC"}
1
+ {"version":3,"file":"theme-access.js","sourceRoot":"","sources":["../../src/auth/theme-access.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,kBAAkB;IAClB,iBAAiB;IACjB,mBAAmB;IACnB,kBAAkB;IAClB,eAAe;IACf,mBAAmB;CACpB,CAAC"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Agent guidance templates for CLAUDE.md and AGENTS.md
3
+ * Provides framework-specific Tekton workflow instructions
4
+ */
5
+ export type Framework = 'nextjs' | 'vite';
6
+ /**
7
+ * Generate CLAUDE.md section for Claude Code
8
+ * (Claude Code-specific patterns and MCP integration)
9
+ */
10
+ export declare function generateClaudeMdSection(framework: Framework): string;
11
+ /**
12
+ * Generate AGENTS.md section for generic AI agents
13
+ * (Platform-agnostic guidance for OpenAI Codex, Cursor, Windsurf, etc.)
14
+ */
15
+ export declare function generateAgentsMdSection(framework: Framework): string;
16
+ //# sourceMappingURL=agent-md-templates.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-md-templates.d.ts","sourceRoot":"","sources":["../../src/cli/agent-md-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAyHpE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAoMpE"}
@@ -0,0 +1,330 @@
1
+ /**
2
+ * Agent guidance templates for CLAUDE.md and AGENTS.md
3
+ * Provides framework-specific Tekton workflow instructions
4
+ */
5
+ /**
6
+ * Generate CLAUDE.md section for Claude Code
7
+ * (Claude Code-specific patterns and MCP integration)
8
+ */
9
+ export function generateClaudeMdSection(framework) {
10
+ const importPath = framework === 'nextjs' ? 'app/page.tsx' : 'src/App.tsx';
11
+ return `
12
+ ## Tekton UI Workflow (Claude Code)
13
+
14
+ ### MCP Server Connection
15
+
16
+ Tekton MCP server is configured in \`.mcp.json\`. Claude Code automatically loads 16 tools for screen generation.
17
+
18
+ ### Authentication (Step 1)
19
+
20
+ Before generating any screens, authenticate:
21
+
22
+ \`\`\`bash
23
+ tekton-mcp login
24
+ \`\`\`
25
+
26
+ **Important:** All 6 themes require authentication. No free themes are available.
27
+
28
+ ### Screen Generation Workflow (4 Steps)
29
+
30
+ **Step 1/4:** Gather Context
31
+ - Call \`get-screen-generation-context\` with user's screen description
32
+ - Receive template matches, component suggestions, and schema
33
+
34
+ **Step 2/4:** Validate Definition
35
+ - Generate Screen Definition JSON based on context
36
+ - Call \`validate-screen-definition\` to verify structure
37
+ - Fix any errors before proceeding
38
+
39
+ **Step 3/4:** Generate Code
40
+ - Call \`generate_screen\` with validated definition
41
+ - Receive production React code and dependencies list
42
+ - Check \`dependencies.external\` field
43
+
44
+ **Step 4/4:** Validate Environment
45
+ - Call \`validate-environment\` with project path and required packages
46
+ - Verify Tailwind CSS configuration
47
+ - Show user install commands for missing packages
48
+
49
+ ### Component Usage Example
50
+
51
+ \`\`\`tsx
52
+ // ${importPath}
53
+ import { Button, Card, CardHeader, CardTitle, CardContent } from '@tekton-ui/ui';
54
+
55
+ export default function Page() {
56
+ return (
57
+ <Card>
58
+ <CardHeader>
59
+ <CardTitle>Welcome to Tekton</CardTitle>
60
+ </CardHeader>
61
+ <CardContent>
62
+ <Button variant="default" size="lg">Get Started</Button>
63
+ </CardContent>
64
+ </Card>
65
+ );
66
+ }
67
+ \`\`\`
68
+
69
+ ### Available Tools
70
+
71
+ **Discovery (6 tools):**
72
+ - \`list-themes\` - List 6 available themes
73
+ - \`preview-theme\` - Get theme design tokens
74
+ - \`list-components\` - List 30+ UI components
75
+ - \`preview-component\` - Get component props and variants
76
+ - \`list-screen-templates\` - List 13 screen templates
77
+ - \`preview-screen-template\` - Get template structure
78
+
79
+ **Screen Generation (4 tools):**
80
+ - \`get-screen-generation-context\` - Step 1/4
81
+ - \`validate-screen-definition\` - Step 2/4
82
+ - \`generate_screen\` - Step 3/4
83
+ - \`validate-environment\` - Step 4/4
84
+
85
+ **Quick Prototyping (3 tools):**
86
+ - \`generate-blueprint\` - Quick UI structure
87
+ - \`export-screen\` - Export to JSX/TSX/Vue
88
+ - \`list_tokens\` - List layout tokens
89
+
90
+ **Icon Libraries (2 tools):**
91
+ - \`list-icon-libraries\` - List available icon libraries
92
+ - \`preview-icon-library\` - Preview icon library
93
+
94
+ **Additional:**
95
+ - \`validate_screen\` - Simple validation (use \`validate-screen-definition\` for production)
96
+
97
+ ### MCP Prompts (Universal Guidance)
98
+
99
+ Claude Code can access built-in prompts for guidance:
100
+
101
+ - \`getting-started\` - Authentication β†’ Theme β†’ Components β†’ Screen generation
102
+ - \`screen-workflow\` - Detailed 4-step workflow with troubleshooting
103
+
104
+ These prompts work across all MCP clients, not just Claude Code.
105
+
106
+ ### Common Mistakes to Avoid
107
+
108
+ 1. ❌ Skipping authentication before generating screens
109
+ 2. ❌ Using non-existent theme IDs (only 6 exist)
110
+ 3. ❌ Skipping validate-screen-definition step
111
+ 4. ❌ Not checking dependencies.external field
112
+ 5. ❌ Delivering code without verifying Tailwind config
113
+
114
+ ### Troubleshooting
115
+
116
+ **Authentication issues:**
117
+ - Run \`tekton-mcp status\` to check authentication
118
+ - Run \`tekton-mcp login\` to re-authenticate
119
+
120
+ **Missing styles:**
121
+ - Run \`validate-environment\` to check Tailwind config
122
+ - Verify \`@tekton-ui/ui\` content paths are included
123
+ - Check \`tailwindcss-animate\` plugin is configured
124
+
125
+ **Component not found:**
126
+ - Use \`list-components\` to verify component exists
127
+ - Use \`preview-component\` to check correct component ID
128
+ `;
129
+ }
130
+ /**
131
+ * Generate AGENTS.md section for generic AI agents
132
+ * (Platform-agnostic guidance for OpenAI Codex, Cursor, Windsurf, etc.)
133
+ */
134
+ export function generateAgentsMdSection(framework) {
135
+ const importPath = framework === 'nextjs' ? 'app/page.tsx' : 'src/App.tsx';
136
+ return `
137
+ ## Tekton UI Workflow (AI Agents)
138
+
139
+ ### Overview
140
+
141
+ Tekton MCP server provides 16 tools for screen generation via Model Context Protocol (MCP). This guide is for AI agents on platforms like OpenAI Codex, Cursor, Windsurf, and other MCP-compatible clients.
142
+
143
+ ### Prerequisites
144
+
145
+ 1. **MCP Server Running:** Ensure \`@tekton-ui/mcp-server\` is running and connected
146
+ 2. **Authentication:** User must run \`tekton-mcp login\` before generating screens
147
+ 3. **Project Setup:** \`@tekton-ui/ui\` and \`tailwindcss-animate\` must be installed
148
+
149
+ ### Required Authentication Flow
150
+
151
+ **Step 1:** Check authentication status
152
+ \`\`\`bash
153
+ tekton-mcp status
154
+ \`\`\`
155
+
156
+ **Step 2:** If not authenticated, instruct user:
157
+ \`\`\`bash
158
+ tekton-mcp login
159
+ \`\`\`
160
+
161
+ **Important:** All 6 themes require valid licenses. There are no free themes available.
162
+
163
+ ### Screen Generation Workflow (4 Steps)
164
+
165
+ Follow this exact sequence for production-ready screens:
166
+
167
+ #### Step 1/4: Gather Context
168
+
169
+ **Tool:** \`get-screen-generation-context\`
170
+
171
+ **Purpose:** Get all context needed to create Screen Definition
172
+
173
+ **Input:**
174
+ \`\`\`json
175
+ {
176
+ "description": "user dashboard with profile card",
177
+ "themeId": "minimal-workspace",
178
+ "includeExamples": true
179
+ }
180
+ \`\`\`
181
+
182
+ **Output:** Template matches, component suggestions, schema, examples
183
+
184
+ #### Step 2/4: Validate Definition
185
+
186
+ **Tool:** \`validate-screen-definition\`
187
+
188
+ **Purpose:** Ensure Screen Definition JSON is correct
189
+
190
+ **Input:**
191
+ \`\`\`json
192
+ {
193
+ "definition": {
194
+ "id": "user-dashboard",
195
+ "shell": "shell.web.dashboard",
196
+ "page": "page.dashboard",
197
+ "sections": [...]
198
+ },
199
+ "strict": true
200
+ }
201
+ \`\`\`
202
+
203
+ **Output:** Validation results with errors, warnings, suggestions
204
+
205
+ **Critical:** Always validate before Step 3. Fix all errors before proceeding.
206
+
207
+ #### Step 3/4: Generate Code
208
+
209
+ **Tool:** \`generate_screen\`
210
+
211
+ **Purpose:** Generate production React code
212
+
213
+ **Input:**
214
+ \`\`\`json
215
+ {
216
+ "screenDefinition": { /* from Step 2 */ },
217
+ "outputFormat": "tailwind",
218
+ "options": {
219
+ "typescript": true,
220
+ "prettier": true
221
+ }
222
+ }
223
+ \`\`\`
224
+
225
+ **Output:** React code + dependencies
226
+
227
+ **Critical:** Check \`dependencies.external\` field. If non-empty, proceed to Step 4.
228
+
229
+ #### Step 4/4: Validate Environment
230
+
231
+ **Tool:** \`validate-environment\`
232
+
233
+ **Purpose:** Verify project has required packages and Tailwind config
234
+
235
+ **Input:**
236
+ \`\`\`json
237
+ {
238
+ "projectPath": "/path/to/package.json",
239
+ "requiredPackages": ["framer-motion", "@radix-ui/react-slot"],
240
+ "checkTailwind": true
241
+ }
242
+ \`\`\`
243
+
244
+ **Output:** Missing packages, install commands, Tailwind validation
245
+
246
+ **Critical:** Always inform user about missing packages and Tailwind config issues.
247
+
248
+ ### Discovery Tools
249
+
250
+ Before generating screens, explore available resources:
251
+
252
+ **Themes (6 total, all require authentication):**
253
+ - \`list-themes\` β†’ See all 6 themes
254
+ - \`preview-theme\` β†’ Get theme design tokens
255
+
256
+ **Components (30+ available):**
257
+ - \`list-components\` β†’ Browse component catalog
258
+ - \`preview-component\` β†’ Get component props, variants, examples
259
+
260
+ **Templates (13 available):**
261
+ - \`list-screen-templates\` β†’ Browse screen templates
262
+ - \`preview-screen-template\` β†’ Get template structure
263
+
264
+ ### Component Usage Example
265
+
266
+ \`\`\`tsx
267
+ // ${importPath}
268
+ import { Button, Card, CardHeader, CardTitle, CardContent } from '@tekton-ui/ui';
269
+
270
+ export default function Page() {
271
+ return (
272
+ <Card>
273
+ <CardHeader>
274
+ <CardTitle>Welcome</CardTitle>
275
+ </CardHeader>
276
+ <CardContent>
277
+ <Button variant="default">Get Started</Button>
278
+ </CardContent>
279
+ </Card>
280
+ );
281
+ }
282
+ \`\`\`
283
+
284
+ ### MCP Prompts (Universal Guidance)
285
+
286
+ Your MCP client may support prompts. If available:
287
+
288
+ - \`getting-started\` - Complete onboarding guide
289
+ - \`screen-workflow\` - Detailed 4-step workflow
290
+
291
+ These provide context to help you guide users effectively.
292
+
293
+ ### Error Handling
294
+
295
+ **Authentication errors:**
296
+ - Instruct user to run \`tekton-mcp login\`
297
+ - Verify with \`tekton-mcp status\`
298
+
299
+ **Validation errors (Step 2):**
300
+ - Read error messages - they include suggestions
301
+ - Fix errors in Screen Definition
302
+ - Re-run \`validate-screen-definition\`
303
+
304
+ **Missing dependencies (Step 3):**
305
+ - Always run Step 4 to check environment
306
+ - Show user install commands from \`validate-environment\`
307
+
308
+ **Missing styles (runtime):**
309
+ - Run \`validate-environment\` to diagnose
310
+ - Check Tailwind config includes \`@tekton-ui/ui\` content paths
311
+ - Check \`tailwindcss-animate\` plugin is configured
312
+
313
+ ### Best Practices
314
+
315
+ 1. βœ… Always authenticate before generating screens
316
+ 2. βœ… Follow all 4 workflow steps in order
317
+ 3. βœ… Validate before generating (Step 2 before Step 3)
318
+ 4. βœ… Check environment before delivering code (Step 4)
319
+ 5. βœ… Inform user about missing dependencies and Tailwind issues
320
+ 6. βœ… Use \`strict: true\` for production validation
321
+
322
+ ### Quick Reference: All 16 Tools
323
+
324
+ **Discovery:** list-themes, preview-theme, list-components, preview-component, list-screen-templates, preview-screen-template
325
+ **Workflow:** get-screen-generation-context, validate-screen-definition, generate_screen, validate-environment
326
+ **Quick:** generate-blueprint, export-screen, validate_screen, list_tokens
327
+ **Icons:** list-icon-libraries, preview-icon-library
328
+ `;
329
+ }
330
+ //# sourceMappingURL=agent-md-templates.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-md-templates.js","sourceRoot":"","sources":["../../src/cli/agent-md-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAyCJ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Ed,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmIJ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Dd,CAAC;AACF,CAAC"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * TEKTON-GUIDE.md μ½˜ν…μΈ  ν…œν”Œλ¦Ώ
3
+ * ν”„λ ˆμž„μ›Œν¬λ³„ 맞좀 κ°€μ΄λ“œ 생성
4
+ */
5
+ export type Framework = 'nextjs' | 'vite';
6
+ /**
7
+ * TEKTON-GUIDE.md μ½˜ν…μΈ  생성
8
+ */
9
+ export declare function generateGuide(framework: Framework): string;
10
+ //# sourceMappingURL=guide-template.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"guide-template.d.ts","sourceRoot":"","sources":["../../src/cli/guide-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CA8L1D"}