@mandujs/mcp 0.36.2 → 0.37.0

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.
Files changed (153) hide show
  1. package/package.json +4 -4
  2. package/src/activity-adapter.ts +23 -23
  3. package/src/adapters/index.ts +20 -20
  4. package/src/adapters/monitor-adapter.ts +100 -100
  5. package/src/adapters/tool-adapter.ts +90 -90
  6. package/src/executor/index.ts +22 -22
  7. package/src/executor/tool-executor.ts +148 -148
  8. package/src/hooks/config-watcher.ts +173 -173
  9. package/src/hooks/index.ts +23 -23
  10. package/src/hooks/mcp-hooks.ts +227 -227
  11. package/src/index.ts +0 -0
  12. package/src/logging/index.ts +15 -15
  13. package/src/logging/mcp-transport.ts +134 -134
  14. package/src/profiles.ts +34 -34
  15. package/src/registry/index.ts +13 -13
  16. package/src/registry/mcp-tool-registry.ts +298 -298
  17. package/src/resources/skills/guides.ts +1136 -1136
  18. package/src/resources/skills/index.ts +12 -12
  19. package/src/resources/skills/mandu-composition/SKILL.md +91 -91
  20. package/src/resources/skills/mandu-composition/metadata.json +13 -13
  21. package/src/resources/skills/mandu-composition/rules/_sections.md +26 -26
  22. package/src/resources/skills/mandu-composition/rules/_template.md +77 -77
  23. package/src/resources/skills/mandu-composition/rules/comp-arch-avoid-boolean-props.md +146 -146
  24. package/src/resources/skills/mandu-composition/rules/comp-arch-compound-components.md +164 -164
  25. package/src/resources/skills/mandu-composition/rules/comp-island-event.md +161 -161
  26. package/src/resources/skills/mandu-composition/rules/comp-island-slot-split.md +167 -167
  27. package/src/resources/skills/mandu-composition/rules/comp-pattern-children.md +149 -149
  28. package/src/resources/skills/mandu-composition/rules/comp-state-context-interface.md +148 -148
  29. package/src/resources/skills/mandu-composition/rules/comp-state-lift-state.md +150 -150
  30. package/src/resources/skills/mandu-deployment/SKILL.md +92 -92
  31. package/src/resources/skills/mandu-deployment/_sections.md +41 -41
  32. package/src/resources/skills/mandu-deployment/_template.md +38 -38
  33. package/src/resources/skills/mandu-deployment/metadata.json +13 -13
  34. package/src/resources/skills/mandu-deployment/rules/db-provider-supabase.md +300 -300
  35. package/src/resources/skills/mandu-deployment/rules/deploy-build-bun.md +109 -109
  36. package/src/resources/skills/mandu-deployment/rules/deploy-build-output.md +115 -115
  37. package/src/resources/skills/mandu-deployment/rules/deploy-cicd-github.md +219 -219
  38. package/src/resources/skills/mandu-deployment/rules/deploy-docker-bun.md +150 -150
  39. package/src/resources/skills/mandu-deployment/rules/deploy-docker-compose.md +223 -223
  40. package/src/resources/skills/mandu-deployment/rules/deploy-platform-fly.md +152 -152
  41. package/src/resources/skills/mandu-deployment/rules/deploy-platform-render.md +179 -179
  42. package/src/resources/skills/mandu-deployment/rules/deploy-platform-vercel.md +140 -140
  43. package/src/resources/skills/mandu-fs-routes/SKILL.md +82 -82
  44. package/src/resources/skills/mandu-fs-routes/metadata.json +12 -12
  45. package/src/resources/skills/mandu-fs-routes/rules/_sections.md +36 -36
  46. package/src/resources/skills/mandu-fs-routes/rules/_template.md +69 -69
  47. package/src/resources/skills/mandu-fs-routes/rules/routes-api-methods.md +65 -65
  48. package/src/resources/skills/mandu-fs-routes/rules/routes-dynamic-param.md +93 -93
  49. package/src/resources/skills/mandu-fs-routes/rules/routes-naming-page.md +55 -55
  50. package/src/resources/skills/mandu-guard/SKILL.md +129 -129
  51. package/src/resources/skills/mandu-guard/metadata.json +12 -12
  52. package/src/resources/skills/mandu-guard/rules/_sections.md +36 -36
  53. package/src/resources/skills/mandu-guard/rules/_template.md +82 -82
  54. package/src/resources/skills/mandu-guard/rules/guard-config-rules.md +100 -100
  55. package/src/resources/skills/mandu-guard/rules/guard-layer-direction.md +76 -76
  56. package/src/resources/skills/mandu-guard/rules/guard-preset-mandu.md +81 -81
  57. package/src/resources/skills/mandu-guard/rules/guard-validate-import.md +80 -80
  58. package/src/resources/skills/mandu-hydration/SKILL.md +91 -91
  59. package/src/resources/skills/mandu-hydration/metadata.json +12 -12
  60. package/src/resources/skills/mandu-hydration/rules/_sections.md +31 -31
  61. package/src/resources/skills/mandu-hydration/rules/_template.md +72 -72
  62. package/src/resources/skills/mandu-hydration/rules/hydration-data-event.md +109 -109
  63. package/src/resources/skills/mandu-hydration/rules/hydration-directive-use-client.md +55 -55
  64. package/src/resources/skills/mandu-hydration/rules/hydration-island-setup.md +113 -113
  65. package/src/resources/skills/mandu-hydration/rules/hydration-priority-visible.md +68 -68
  66. package/src/resources/skills/mandu-performance/SKILL.md +85 -85
  67. package/src/resources/skills/mandu-performance/metadata.json +14 -14
  68. package/src/resources/skills/mandu-performance/rules/_sections.md +31 -31
  69. package/src/resources/skills/mandu-performance/rules/_template.md +64 -64
  70. package/src/resources/skills/mandu-performance/rules/perf-async-defer-await.md +103 -103
  71. package/src/resources/skills/mandu-performance/rules/perf-async-parallel.md +95 -95
  72. package/src/resources/skills/mandu-performance/rules/perf-bun-file.md +124 -124
  73. package/src/resources/skills/mandu-performance/rules/perf-bun-serve.md +125 -125
  74. package/src/resources/skills/mandu-performance/rules/perf-bundle-imports.md +80 -80
  75. package/src/resources/skills/mandu-performance/rules/perf-bundle-island-lazy.md +145 -145
  76. package/src/resources/skills/mandu-performance/rules/perf-cache-react.md +98 -98
  77. package/src/resources/skills/mandu-performance/rules/perf-render-transitions.md +154 -154
  78. package/src/resources/skills/mandu-security/SKILL.md +87 -87
  79. package/src/resources/skills/mandu-security/metadata.json +13 -13
  80. package/src/resources/skills/mandu-security/rules/_sections.md +31 -31
  81. package/src/resources/skills/mandu-security/rules/_template.md +74 -74
  82. package/src/resources/skills/mandu-security/rules/sec-auth-guard.md +127 -127
  83. package/src/resources/skills/mandu-security/rules/sec-env-management.md +133 -133
  84. package/src/resources/skills/mandu-security/rules/sec-input-validate.md +148 -148
  85. package/src/resources/skills/mandu-security/rules/sec-protect-csrf.md +146 -146
  86. package/src/resources/skills/mandu-security/rules/sec-protect-headers.md +138 -138
  87. package/src/resources/skills/mandu-slot/SKILL.md +85 -85
  88. package/src/resources/skills/mandu-slot/metadata.json +12 -12
  89. package/src/resources/skills/mandu-slot/rules/_sections.md +36 -36
  90. package/src/resources/skills/mandu-slot/rules/_template.md +63 -63
  91. package/src/resources/skills/mandu-slot/rules/slot-basic-structure.md +38 -38
  92. package/src/resources/skills/mandu-slot/rules/slot-ctx-response.md +56 -56
  93. package/src/resources/skills/mandu-slot/rules/slot-guard-auth.md +59 -59
  94. package/src/resources/skills/mandu-slot/rules/slot-http-methods.md +64 -64
  95. package/src/resources/skills/mandu-styling/SKILL.md +154 -154
  96. package/src/resources/skills/mandu-styling/_sections.md +43 -43
  97. package/src/resources/skills/mandu-styling/_template.md +32 -32
  98. package/src/resources/skills/mandu-styling/metadata.json +15 -15
  99. package/src/resources/skills/mandu-styling/rules/style-component-compound.md +235 -235
  100. package/src/resources/skills/mandu-styling/rules/style-component-slots.md +255 -255
  101. package/src/resources/skills/mandu-styling/rules/style-component-tokens.md +205 -205
  102. package/src/resources/skills/mandu-styling/rules/style-island-animations.md +272 -272
  103. package/src/resources/skills/mandu-styling/rules/style-island-scoping.md +167 -167
  104. package/src/resources/skills/mandu-styling/rules/style-island-variants.md +221 -221
  105. package/src/resources/skills/mandu-styling/rules/style-perf-critical.md +209 -209
  106. package/src/resources/skills/mandu-styling/rules/style-perf-purge.md +192 -192
  107. package/src/resources/skills/mandu-styling/rules/style-setup-modules.md +162 -162
  108. package/src/resources/skills/mandu-styling/rules/style-setup-panda.md +164 -164
  109. package/src/resources/skills/mandu-styling/rules/style-setup-tailwind.md +170 -170
  110. package/src/resources/skills/mandu-styling/rules/style-tailwind-v4-gotchas.md +179 -179
  111. package/src/resources/skills/mandu-styling/rules/style-theme-darkmode.md +229 -229
  112. package/src/resources/skills/mandu-testing/SKILL.md +99 -99
  113. package/src/resources/skills/mandu-testing/metadata.json +13 -13
  114. package/src/resources/skills/mandu-testing/rules/_sections.md +26 -26
  115. package/src/resources/skills/mandu-testing/rules/_template.md +65 -65
  116. package/src/resources/skills/mandu-testing/rules/test-component-island.md +195 -195
  117. package/src/resources/skills/mandu-testing/rules/test-e2e-playwright.md +196 -196
  118. package/src/resources/skills/mandu-testing/rules/test-mock-fetch.md +219 -219
  119. package/src/resources/skills/mandu-testing/rules/test-slot-unit.md +192 -192
  120. package/src/resources/skills/mandu-ui/SKILL.md +117 -117
  121. package/src/resources/skills/mandu-ui/_sections.md +23 -23
  122. package/src/resources/skills/mandu-ui/_template.md +32 -32
  123. package/src/resources/skills/mandu-ui/metadata.json +13 -13
  124. package/src/resources/skills/mandu-ui/rules/ui-accessibility-aria.md +232 -232
  125. package/src/resources/skills/mandu-ui/rules/ui-accessibility-focus.md +238 -238
  126. package/src/resources/skills/mandu-ui/rules/ui-composition-patterns.md +259 -259
  127. package/src/resources/skills/mandu-ui/rules/ui-island-integration.md +258 -258
  128. package/src/resources/skills/mandu-ui/rules/ui-radix-patterns.md +213 -213
  129. package/src/resources/skills/mandu-ui/rules/ui-shadcn-setup.md +209 -209
  130. package/src/resources/skills/recipes.ts +932 -932
  131. package/src/server.ts +3 -3
  132. package/src/tools/ate-exemplar.ts +92 -92
  133. package/src/tools/ate-flakes.ts +90 -90
  134. package/src/tools/ate-mutate.ts +103 -103
  135. package/src/tools/ate-mutation-report.ts +64 -64
  136. package/src/tools/ate-oracle-pending.ts +49 -49
  137. package/src/tools/ate-oracle-replay.ts +44 -44
  138. package/src/tools/ate-oracle-verdict.ts +70 -70
  139. package/src/tools/ate-prompt.ts +146 -146
  140. package/src/tools/brain.ts +3 -3
  141. package/src/tools/deploy-plan.ts +378 -378
  142. package/src/tools/deploy-preview.ts +316 -316
  143. package/src/tools/design.ts +825 -825
  144. package/src/tools/docs.ts +350 -350
  145. package/src/tools/kitchen.ts +109 -23
  146. package/src/tools/lint.ts +226 -226
  147. package/src/tools/loop-close.ts +175 -175
  148. package/src/tools/negotiate.ts +263 -263
  149. package/src/tools/run-tests.ts +424 -424
  150. package/src/tools/runtime.ts +1 -1
  151. package/src/tools/slot-validation.ts +199 -199
  152. package/src/tx-lock.ts +73 -73
  153. package/src/utils/runtime-control.ts +52 -52
@@ -1,150 +1,150 @@
1
- ---
2
- title: Lift State into Provider for Sibling Access
3
- impact: HIGH
4
- impactDescription: Enables state sharing without prop drilling
5
- tags: composition, state, provider, lift-state
6
- ---
7
-
8
- ## Lift State into Provider for Sibling Access
9
-
10
- **Impact: HIGH (Enables state sharing without prop drilling)**
11
-
12
- 형제 컴포넌트가 상태를 공유해야 할 때, 상태를 Provider로 끌어올리세요. Provider 경계 내의 모든 컴포넌트가 상태에 접근할 수 있습니다.
13
-
14
- **Incorrect (prop drilling):**
15
-
16
- ```tsx
17
- // ❌ 상태를 여러 단계로 전달
18
- function ChatPage() {
19
- const [message, setMessage] = useState("");
20
- const [isTyping, setIsTyping] = useState(false);
21
-
22
- return (
23
- <div>
24
- <MessageList
25
- isTyping={isTyping}
26
- typingMessage={message} // prop drilling
27
- />
28
- <Composer
29
- message={message}
30
- setMessage={setMessage}
31
- setIsTyping={setIsTyping}
32
- />
33
- <TypingIndicator isTyping={isTyping} /> // prop drilling
34
- </div>
35
- );
36
- }
37
- ```
38
-
39
- **Correct (Provider로 끌어올리기):**
40
-
41
- ```tsx
42
- // ✅ Provider가 상태 관리
43
- interface ChatContextValue {
44
- state: { message: string; isTyping: boolean };
45
- actions: { setMessage: (msg: string) => void; setIsTyping: (val: boolean) => void };
46
- }
47
-
48
- const ChatContext = createContext<ChatContextValue | null>(null);
49
-
50
- function ChatProvider({ children }: { children: React.ReactNode }) {
51
- const [message, setMessage] = useState("");
52
- const [isTyping, setIsTyping] = useState(false);
53
-
54
- return (
55
- <ChatContext value={{
56
- state: { message, isTyping },
57
- actions: { setMessage, setIsTyping },
58
- }}>
59
- {children}
60
- </ChatContext>
61
- );
62
- }
63
-
64
- // 각 컴포넌트가 필요한 것만 가져감
65
- function MessageList() {
66
- const { state } = use(ChatContext)!;
67
- return (
68
- <div>
69
- {messages.map(msg => <Message key={msg.id} {...msg} />)}
70
- {state.isTyping && <TypingPreview text={state.message} />}
71
- </div>
72
- );
73
- }
74
-
75
- function Composer() {
76
- const { state, actions } = use(ChatContext)!;
77
- return (
78
- <textarea
79
- value={state.message}
80
- onChange={(e) => {
81
- actions.setMessage(e.target.value);
82
- actions.setIsTyping(e.target.value.length > 0);
83
- }}
84
- />
85
- );
86
- }
87
-
88
- function TypingIndicator() {
89
- const { state } = use(ChatContext)!;
90
- if (!state.isTyping) return null;
91
- return <span>Someone is typing...</span>;
92
- }
93
- ```
94
-
95
- **사용:**
96
-
97
- ```tsx
98
- function ChatPage() {
99
- return (
100
- <ChatProvider>
101
- <div>
102
- <MessageList /> {/* context에서 상태 읽음 */}
103
- <Composer /> {/* context에서 상태 수정 */}
104
- <TypingIndicator /> {/* context에서 상태 읽음 */}
105
- </div>
106
- </ChatProvider>
107
- );
108
- }
109
- ```
110
-
111
- ## Provider 경계 이해하기
112
-
113
- Provider 경계 내라면 시각적 위치와 무관하게 상태 접근 가능:
114
-
115
- ```tsx
116
- <ChatProvider>
117
- <Dialog>
118
- {/* Dialog 내부 */}
119
- <Composer.Frame>
120
- <Composer.Input />
121
- </Composer.Frame>
122
-
123
- {/* Frame 외부지만 Provider 내부! */}
124
- <MessagePreview /> {/* ✅ context 접근 가능 */}
125
-
126
- <DialogActions>
127
- <SendButton /> {/* ✅ context 접근 가능 */}
128
- </DialogActions>
129
- </Dialog>
130
- </ChatProvider>
131
- ```
132
-
133
- ## Mandu Island에서의 적용
134
-
135
- ```tsx
136
- // app/chat/page.tsx
137
- import { ChatIsland } from "./client";
138
-
139
- export default function ChatPage({ data }) {
140
- return (
141
- <div>
142
- <h1>Chat</h1>
143
- {/* Island 내부에서 Provider로 상태 관리 */}
144
- <ChatIsland initialMessages={data.messages} />
145
- </div>
146
- );
147
- }
148
- ```
149
-
150
- Reference: [Lifting State Up](https://react.dev/learn/sharing-state-between-components)
1
+ ---
2
+ title: Lift State into Provider for Sibling Access
3
+ impact: HIGH
4
+ impactDescription: Enables state sharing without prop drilling
5
+ tags: composition, state, provider, lift-state
6
+ ---
7
+
8
+ ## Lift State into Provider for Sibling Access
9
+
10
+ **Impact: HIGH (Enables state sharing without prop drilling)**
11
+
12
+ 형제 컴포넌트가 상태를 공유해야 할 때, 상태를 Provider로 끌어올리세요. Provider 경계 내의 모든 컴포넌트가 상태에 접근할 수 있습니다.
13
+
14
+ **Incorrect (prop drilling):**
15
+
16
+ ```tsx
17
+ // ❌ 상태를 여러 단계로 전달
18
+ function ChatPage() {
19
+ const [message, setMessage] = useState("");
20
+ const [isTyping, setIsTyping] = useState(false);
21
+
22
+ return (
23
+ <div>
24
+ <MessageList
25
+ isTyping={isTyping}
26
+ typingMessage={message} // prop drilling
27
+ />
28
+ <Composer
29
+ message={message}
30
+ setMessage={setMessage}
31
+ setIsTyping={setIsTyping}
32
+ />
33
+ <TypingIndicator isTyping={isTyping} /> // prop drilling
34
+ </div>
35
+ );
36
+ }
37
+ ```
38
+
39
+ **Correct (Provider로 끌어올리기):**
40
+
41
+ ```tsx
42
+ // ✅ Provider가 상태 관리
43
+ interface ChatContextValue {
44
+ state: { message: string; isTyping: boolean };
45
+ actions: { setMessage: (msg: string) => void; setIsTyping: (val: boolean) => void };
46
+ }
47
+
48
+ const ChatContext = createContext<ChatContextValue | null>(null);
49
+
50
+ function ChatProvider({ children }: { children: React.ReactNode }) {
51
+ const [message, setMessage] = useState("");
52
+ const [isTyping, setIsTyping] = useState(false);
53
+
54
+ return (
55
+ <ChatContext value={{
56
+ state: { message, isTyping },
57
+ actions: { setMessage, setIsTyping },
58
+ }}>
59
+ {children}
60
+ </ChatContext>
61
+ );
62
+ }
63
+
64
+ // 각 컴포넌트가 필요한 것만 가져감
65
+ function MessageList() {
66
+ const { state } = use(ChatContext)!;
67
+ return (
68
+ <div>
69
+ {messages.map(msg => <Message key={msg.id} {...msg} />)}
70
+ {state.isTyping && <TypingPreview text={state.message} />}
71
+ </div>
72
+ );
73
+ }
74
+
75
+ function Composer() {
76
+ const { state, actions } = use(ChatContext)!;
77
+ return (
78
+ <textarea
79
+ value={state.message}
80
+ onChange={(e) => {
81
+ actions.setMessage(e.target.value);
82
+ actions.setIsTyping(e.target.value.length > 0);
83
+ }}
84
+ />
85
+ );
86
+ }
87
+
88
+ function TypingIndicator() {
89
+ const { state } = use(ChatContext)!;
90
+ if (!state.isTyping) return null;
91
+ return <span>Someone is typing...</span>;
92
+ }
93
+ ```
94
+
95
+ **사용:**
96
+
97
+ ```tsx
98
+ function ChatPage() {
99
+ return (
100
+ <ChatProvider>
101
+ <div>
102
+ <MessageList /> {/* context에서 상태 읽음 */}
103
+ <Composer /> {/* context에서 상태 수정 */}
104
+ <TypingIndicator /> {/* context에서 상태 읽음 */}
105
+ </div>
106
+ </ChatProvider>
107
+ );
108
+ }
109
+ ```
110
+
111
+ ## Provider 경계 이해하기
112
+
113
+ Provider 경계 내라면 시각적 위치와 무관하게 상태 접근 가능:
114
+
115
+ ```tsx
116
+ <ChatProvider>
117
+ <Dialog>
118
+ {/* Dialog 내부 */}
119
+ <Composer.Frame>
120
+ <Composer.Input />
121
+ </Composer.Frame>
122
+
123
+ {/* Frame 외부지만 Provider 내부! */}
124
+ <MessagePreview /> {/* ✅ context 접근 가능 */}
125
+
126
+ <DialogActions>
127
+ <SendButton /> {/* ✅ context 접근 가능 */}
128
+ </DialogActions>
129
+ </Dialog>
130
+ </ChatProvider>
131
+ ```
132
+
133
+ ## Mandu Island에서의 적용
134
+
135
+ ```tsx
136
+ // app/chat/page.tsx
137
+ import { ChatIsland } from "./client";
138
+
139
+ export default function ChatPage({ data }) {
140
+ return (
141
+ <div>
142
+ <h1>Chat</h1>
143
+ {/* Island 내부에서 Provider로 상태 관리 */}
144
+ <ChatIsland initialMessages={data.messages} />
145
+ </div>
146
+ );
147
+ }
148
+ ```
149
+
150
+ Reference: [Lifting State Up](https://react.dev/learn/sharing-state-between-components)
@@ -1,92 +1,92 @@
1
- ---
2
- name: Mandu Deployment
3
- description: Production deployment patterns for Mandu applications
4
- metadata:
5
- version: "1.0.0"
6
- author: mandu
7
- globs:
8
- - "render.yaml"
9
- - "Dockerfile"
10
- - "docker-compose.yml"
11
- - ".github/workflows/*.yml"
12
- - "bunfig.toml"
13
- ---
14
-
15
- # Mandu Deployment Skill
16
-
17
- Mandu 앱을 프로덕션 환경에 안전하고 효율적으로 배포하기 위한 가이드입니다.
18
-
19
- ## 핵심 원칙
20
-
21
- 1. **Bun 네이티브**: Bun 런타임과 번들러를 최대한 활용
22
- 2. **환경 분리**: 개발/스테이징/프로덕션 환경 명확히 구분
23
- 3. **자동화**: CI/CD를 통한 일관된 배포 프로세스
24
- 4. **보안 우선**: 민감 정보는 환경 변수로 관리
25
-
26
- ## 빠른 시작
27
-
28
- ### Render 배포 (권장)
29
-
30
- ```yaml
31
- # render.yaml
32
- services:
33
- - type: web
34
- name: mandu-app
35
- runtime: node
36
- buildCommand: bun install && bun run build
37
- startCommand: bun run start
38
- envVars:
39
- - key: NODE_ENV
40
- value: production
41
- - key: BUN_ENV
42
- value: production
43
- ```
44
-
45
- ### Docker 배포
46
-
47
- ```dockerfile
48
- FROM oven/bun:1.0
49
-
50
- WORKDIR /app
51
- COPY package.json bun.lockb ./
52
- RUN bun install --frozen-lockfile --production
53
-
54
- COPY . .
55
- RUN bun run build
56
-
57
- EXPOSE 3000
58
- CMD ["bun", "run", "start"]
59
- ```
60
-
61
- ## 배포 체크리스트
62
-
63
- ### 빌드 준비
64
- - [ ] `bun run build` 성공 확인
65
- - [ ] 번들 크기 최적화 (tree-shaking, code-splitting)
66
- - [ ] 환경 변수 설정 완료
67
-
68
- ### 플랫폼 설정
69
- - [ ] Render/Docker 설정 파일 작성
70
- - [ ] 헬스체크 엔드포인트 구현
71
- - [ ] 로깅 설정 완료
72
-
73
- ### 보안
74
- - [ ] 민감 정보 환경 변수로 분리
75
- - [ ] HTTPS 강제 적용
76
- - [ ] 보안 헤더 설정
77
-
78
- ### 모니터링
79
- - [ ] 에러 트래킹 설정
80
- - [ ] 성능 모니터링 구성
81
- - [ ] 알림 설정
82
-
83
- ## 규칙 카테고리
84
-
85
- | Category | Description | Rules |
86
- |----------|-------------|-------|
87
- | Build | 프로덕션 빌드 최적화 | 2 |
88
- | Platform | 플랫폼별 배포 설정 | 3 |
89
- | Container | Docker 컨테이너화 | 2 |
90
- | CI/CD | 자동화 파이프라인 | 1 |
91
-
92
- → 세부 규칙은 `rules/` 폴더 참조
1
+ ---
2
+ name: Mandu Deployment
3
+ description: Production deployment patterns for Mandu applications
4
+ metadata:
5
+ version: "1.0.0"
6
+ author: mandu
7
+ globs:
8
+ - "render.yaml"
9
+ - "Dockerfile"
10
+ - "docker-compose.yml"
11
+ - ".github/workflows/*.yml"
12
+ - "bunfig.toml"
13
+ ---
14
+
15
+ # Mandu Deployment Skill
16
+
17
+ Mandu 앱을 프로덕션 환경에 안전하고 효율적으로 배포하기 위한 가이드입니다.
18
+
19
+ ## 핵심 원칙
20
+
21
+ 1. **Bun 네이티브**: Bun 런타임과 번들러를 최대한 활용
22
+ 2. **환경 분리**: 개발/스테이징/프로덕션 환경 명확히 구분
23
+ 3. **자동화**: CI/CD를 통한 일관된 배포 프로세스
24
+ 4. **보안 우선**: 민감 정보는 환경 변수로 관리
25
+
26
+ ## 빠른 시작
27
+
28
+ ### Render 배포 (권장)
29
+
30
+ ```yaml
31
+ # render.yaml
32
+ services:
33
+ - type: web
34
+ name: mandu-app
35
+ runtime: node
36
+ buildCommand: bun install && bun run build
37
+ startCommand: bun run start
38
+ envVars:
39
+ - key: NODE_ENV
40
+ value: production
41
+ - key: BUN_ENV
42
+ value: production
43
+ ```
44
+
45
+ ### Docker 배포
46
+
47
+ ```dockerfile
48
+ FROM oven/bun:1.0
49
+
50
+ WORKDIR /app
51
+ COPY package.json bun.lockb ./
52
+ RUN bun install --frozen-lockfile --production
53
+
54
+ COPY . .
55
+ RUN bun run build
56
+
57
+ EXPOSE 3000
58
+ CMD ["bun", "run", "start"]
59
+ ```
60
+
61
+ ## 배포 체크리스트
62
+
63
+ ### 빌드 준비
64
+ - [ ] `bun run build` 성공 확인
65
+ - [ ] 번들 크기 최적화 (tree-shaking, code-splitting)
66
+ - [ ] 환경 변수 설정 완료
67
+
68
+ ### 플랫폼 설정
69
+ - [ ] Render/Docker 설정 파일 작성
70
+ - [ ] 헬스체크 엔드포인트 구현
71
+ - [ ] 로깅 설정 완료
72
+
73
+ ### 보안
74
+ - [ ] 민감 정보 환경 변수로 분리
75
+ - [ ] HTTPS 강제 적용
76
+ - [ ] 보안 헤더 설정
77
+
78
+ ### 모니터링
79
+ - [ ] 에러 트래킹 설정
80
+ - [ ] 성능 모니터링 구성
81
+ - [ ] 알림 설정
82
+
83
+ ## 규칙 카테고리
84
+
85
+ | Category | Description | Rules |
86
+ |----------|-------------|-------|
87
+ | Build | 프로덕션 빌드 최적화 | 2 |
88
+ | Platform | 플랫폼별 배포 설정 | 3 |
89
+ | Container | Docker 컨테이너화 | 2 |
90
+ | CI/CD | 자동화 파이프라인 | 1 |
91
+
92
+ → 세부 규칙은 `rules/` 폴더 참조
@@ -1,41 +1,41 @@
1
- # Mandu Deployment - Rule Categories
2
-
3
- ## Build
4
- 프로덕션 빌드 최적화 및 번들링 설정
5
-
6
- | Impact | Description |
7
- |--------|-------------|
8
- | CRITICAL | 빌드 실패 시 배포 불가 |
9
- | HIGH | 번들 크기, 빌드 시간에 큰 영향 |
10
-
11
- ## Platform
12
- 배포 플랫폼별 설정 및 최적화
13
-
14
- | Impact | Description |
15
- |--------|-------------|
16
- | CRITICAL | 플랫폼 호환성 필수 |
17
- | HIGH | 성능, 비용에 큰 영향 |
18
-
19
- ## Container
20
- Docker 컨테이너화 및 오케스트레이션
21
-
22
- | Impact | Description |
23
- |--------|-------------|
24
- | HIGH | 일관된 배포 환경 보장 |
25
- | MEDIUM | 개발/프로덕션 환경 일치 |
26
-
27
- ## CI/CD
28
- 지속적 통합 및 배포 파이프라인
29
-
30
- | Impact | Description |
31
- |--------|-------------|
32
- | HIGH | 자동화된 품질 보증 |
33
- | MEDIUM | 배포 속도 및 안정성 향상 |
34
-
35
- ## Environment
36
- 환경 변수 및 설정 관리
37
-
38
- | Impact | Description |
39
- |--------|-------------|
40
- | CRITICAL | 보안 민감 정보 보호 |
41
- | HIGH | 환경별 설정 분리 |
1
+ # Mandu Deployment - Rule Categories
2
+
3
+ ## Build
4
+ 프로덕션 빌드 최적화 및 번들링 설정
5
+
6
+ | Impact | Description |
7
+ |--------|-------------|
8
+ | CRITICAL | 빌드 실패 시 배포 불가 |
9
+ | HIGH | 번들 크기, 빌드 시간에 큰 영향 |
10
+
11
+ ## Platform
12
+ 배포 플랫폼별 설정 및 최적화
13
+
14
+ | Impact | Description |
15
+ |--------|-------------|
16
+ | CRITICAL | 플랫폼 호환성 필수 |
17
+ | HIGH | 성능, 비용에 큰 영향 |
18
+
19
+ ## Container
20
+ Docker 컨테이너화 및 오케스트레이션
21
+
22
+ | Impact | Description |
23
+ |--------|-------------|
24
+ | HIGH | 일관된 배포 환경 보장 |
25
+ | MEDIUM | 개발/프로덕션 환경 일치 |
26
+
27
+ ## CI/CD
28
+ 지속적 통합 및 배포 파이프라인
29
+
30
+ | Impact | Description |
31
+ |--------|-------------|
32
+ | HIGH | 자동화된 품질 보증 |
33
+ | MEDIUM | 배포 속도 및 안정성 향상 |
34
+
35
+ ## Environment
36
+ 환경 변수 및 설정 관리
37
+
38
+ | Impact | Description |
39
+ |--------|-------------|
40
+ | CRITICAL | 보안 민감 정보 보호 |
41
+ | HIGH | 환경별 설정 분리 |
@@ -1,38 +1,38 @@
1
- ---
2
- title: Rule Title Here
3
- impact: CRITICAL | HIGH | MEDIUM | LOW
4
- impactDescription: One-line description of why this matters
5
- tags: deployment, tag2, tag3
6
- ---
7
-
8
- ## Rule Title Here
9
-
10
- **Impact: LEVEL (Impact description)**
11
-
12
- 규칙에 대한 간단한 설명.
13
-
14
- **설정 예시:**
15
-
16
- ```yaml
17
- # 설정 파일 예시
18
- key: value
19
- ```
20
-
21
- **구현 예시:**
22
-
23
- ```typescript
24
- // 코드 예시
25
- ```
26
-
27
- ## 추가 설정
28
-
29
- ```bash
30
- # 명령어 예시
31
- ```
32
-
33
- ## 주의사항
34
-
35
- - 첫 번째 주의사항
36
- - 두 번째 주의사항
37
-
38
- Reference: [문서 링크](https://example.com)
1
+ ---
2
+ title: Rule Title Here
3
+ impact: CRITICAL | HIGH | MEDIUM | LOW
4
+ impactDescription: One-line description of why this matters
5
+ tags: deployment, tag2, tag3
6
+ ---
7
+
8
+ ## Rule Title Here
9
+
10
+ **Impact: LEVEL (Impact description)**
11
+
12
+ 규칙에 대한 간단한 설명.
13
+
14
+ **설정 예시:**
15
+
16
+ ```yaml
17
+ # 설정 파일 예시
18
+ key: value
19
+ ```
20
+
21
+ **구현 예시:**
22
+
23
+ ```typescript
24
+ // 코드 예시
25
+ ```
26
+
27
+ ## 추가 설정
28
+
29
+ ```bash
30
+ # 명령어 예시
31
+ ```
32
+
33
+ ## 주의사항
34
+
35
+ - 첫 번째 주의사항
36
+ - 두 번째 주의사항
37
+
38
+ Reference: [문서 링크](https://example.com)
@@ -1,13 +1,13 @@
1
- {
2
- "id": "mandu-deployment",
3
- "name": "Mandu Deployment",
4
- "version": "1.0.0",
5
- "description": "Production deployment patterns for Mandu applications",
6
- "author": "mandu",
7
- "references": [
8
- "https://bun.sh/docs/bundler",
9
- "https://render.com/docs",
10
- "https://docs.docker.com/"
11
- ],
12
- "abstract": "Mandu 앱을 프로덕션 환경에 배포하기 위한 패턴과 가이드. Bun 빌드 최적화, Render/Docker 배포, CI/CD 파이프라인, 환경 설정을 다룹니다."
13
- }
1
+ {
2
+ "id": "mandu-deployment",
3
+ "name": "Mandu Deployment",
4
+ "version": "1.0.0",
5
+ "description": "Production deployment patterns for Mandu applications",
6
+ "author": "mandu",
7
+ "references": [
8
+ "https://bun.sh/docs/bundler",
9
+ "https://render.com/docs",
10
+ "https://docs.docker.com/"
11
+ ],
12
+ "abstract": "Mandu 앱을 프로덕션 환경에 배포하기 위한 패턴과 가이드. Bun 빌드 최적화, Render/Docker 배포, CI/CD 파이프라인, 환경 설정을 다룹니다."
13
+ }