start-vibing 2.0.10 → 2.0.12

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 (130) hide show
  1. package/README.md +177 -177
  2. package/package.json +42 -42
  3. package/template/.claude/CLAUDE.md +174 -174
  4. package/template/.claude/agents/01-orchestration/agent-selector.md +130 -130
  5. package/template/.claude/agents/01-orchestration/checkpoint-manager.md +142 -142
  6. package/template/.claude/agents/01-orchestration/context-manager.md +138 -138
  7. package/template/.claude/agents/01-orchestration/error-recovery.md +182 -182
  8. package/template/.claude/agents/01-orchestration/orchestrator.md +114 -114
  9. package/template/.claude/agents/01-orchestration/parallel-coordinator.md +141 -141
  10. package/template/.claude/agents/01-orchestration/task-decomposer.md +121 -121
  11. package/template/.claude/agents/01-orchestration/workflow-router.md +114 -114
  12. package/template/.claude/agents/02-typescript/bun-runtime-expert.md +197 -197
  13. package/template/.claude/agents/02-typescript/esm-resolver.md +193 -193
  14. package/template/.claude/agents/02-typescript/import-alias-enforcer.md +158 -158
  15. package/template/.claude/agents/02-typescript/ts-generics-helper.md +183 -183
  16. package/template/.claude/agents/02-typescript/ts-migration-helper.md +238 -238
  17. package/template/.claude/agents/02-typescript/ts-strict-checker.md +180 -180
  18. package/template/.claude/agents/02-typescript/ts-types-analyzer.md +199 -199
  19. package/template/.claude/agents/02-typescript/type-definition-writer.md +187 -187
  20. package/template/.claude/agents/02-typescript/zod-schema-designer.md +212 -212
  21. package/template/.claude/agents/02-typescript/zod-validator.md +158 -158
  22. package/template/.claude/agents/03-testing/playwright-assertions.md +265 -265
  23. package/template/.claude/agents/03-testing/playwright-e2e.md +247 -247
  24. package/template/.claude/agents/03-testing/playwright-fixtures.md +234 -234
  25. package/template/.claude/agents/03-testing/playwright-multi-viewport.md +256 -256
  26. package/template/.claude/agents/03-testing/playwright-page-objects.md +247 -247
  27. package/template/.claude/agents/03-testing/test-cleanup-manager.md +248 -248
  28. package/template/.claude/agents/03-testing/test-data-generator.md +254 -254
  29. package/template/.claude/agents/03-testing/tester-integration.md +278 -278
  30. package/template/.claude/agents/03-testing/tester-unit.md +207 -207
  31. package/template/.claude/agents/03-testing/vitest-config.md +287 -287
  32. package/template/.claude/agents/04-docker/container-health.md +255 -255
  33. package/template/.claude/agents/04-docker/deployment-validator.md +225 -225
  34. package/template/.claude/agents/04-docker/docker-compose-designer.md +281 -281
  35. package/template/.claude/agents/04-docker/docker-env-manager.md +235 -235
  36. package/template/.claude/agents/04-docker/docker-multi-stage.md +241 -241
  37. package/template/.claude/agents/04-docker/dockerfile-optimizer.md +208 -208
  38. package/template/.claude/agents/05-database/database-seeder.md +273 -273
  39. package/template/.claude/agents/05-database/mongodb-query-optimizer.md +230 -230
  40. package/template/.claude/agents/05-database/mongoose-aggregation.md +306 -306
  41. package/template/.claude/agents/05-database/mongoose-index-optimizer.md +182 -182
  42. package/template/.claude/agents/05-database/mongoose-schema-designer.md +267 -267
  43. package/template/.claude/agents/06-security/auth-session-validator.md +68 -68
  44. package/template/.claude/agents/06-security/input-sanitizer.md +80 -80
  45. package/template/.claude/agents/06-security/owasp-checker.md +97 -97
  46. package/template/.claude/agents/06-security/permission-auditor.md +100 -100
  47. package/template/.claude/agents/06-security/security-auditor.md +84 -84
  48. package/template/.claude/agents/06-security/sensitive-data-scanner.md +83 -83
  49. package/template/.claude/agents/07-documentation/api-documenter.md +136 -136
  50. package/template/.claude/agents/07-documentation/changelog-manager.md +105 -105
  51. package/template/.claude/agents/07-documentation/documenter.md +76 -76
  52. package/template/.claude/agents/07-documentation/domain-updater.md +81 -81
  53. package/template/.claude/agents/07-documentation/jsdoc-generator.md +114 -114
  54. package/template/.claude/agents/07-documentation/readme-generator.md +135 -135
  55. package/template/.claude/agents/08-git/branch-manager.md +58 -58
  56. package/template/.claude/agents/08-git/commit-manager.md +63 -63
  57. package/template/.claude/agents/08-git/pr-creator.md +76 -76
  58. package/template/.claude/agents/09-quality/code-reviewer.md +71 -71
  59. package/template/.claude/agents/09-quality/quality-checker.md +67 -67
  60. package/template/.claude/agents/10-research/best-practices-finder.md +89 -89
  61. package/template/.claude/agents/10-research/competitor-analyzer.md +106 -106
  62. package/template/.claude/agents/10-research/pattern-researcher.md +93 -93
  63. package/template/.claude/agents/10-research/research-cache-manager.md +76 -76
  64. package/template/.claude/agents/10-research/research-web.md +98 -98
  65. package/template/.claude/agents/10-research/tech-evaluator.md +101 -101
  66. package/template/.claude/agents/11-ui-ux/accessibility-auditor.md +136 -136
  67. package/template/.claude/agents/11-ui-ux/design-system-enforcer.md +125 -125
  68. package/template/.claude/agents/11-ui-ux/skeleton-generator.md +118 -118
  69. package/template/.claude/agents/11-ui-ux/ui-desktop.md +132 -132
  70. package/template/.claude/agents/11-ui-ux/ui-mobile.md +98 -98
  71. package/template/.claude/agents/11-ui-ux/ui-tablet.md +110 -110
  72. package/template/.claude/agents/12-performance/api-latency-analyzer.md +156 -156
  73. package/template/.claude/agents/12-performance/bundle-analyzer.md +113 -113
  74. package/template/.claude/agents/12-performance/memory-leak-detector.md +137 -137
  75. package/template/.claude/agents/12-performance/performance-profiler.md +115 -115
  76. package/template/.claude/agents/12-performance/query-optimizer.md +124 -124
  77. package/template/.claude/agents/12-performance/render-optimizer.md +154 -154
  78. package/template/.claude/agents/13-debugging/build-error-fixer.md +207 -207
  79. package/template/.claude/agents/13-debugging/debugger.md +149 -149
  80. package/template/.claude/agents/13-debugging/error-stack-analyzer.md +141 -141
  81. package/template/.claude/agents/13-debugging/network-debugger.md +208 -208
  82. package/template/.claude/agents/13-debugging/runtime-error-fixer.md +181 -181
  83. package/template/.claude/agents/13-debugging/type-error-resolver.md +185 -185
  84. package/template/.claude/agents/14-validation/final-validator.md +93 -93
  85. package/template/.claude/agents/_backup/analyzer.md +134 -134
  86. package/template/.claude/agents/_backup/code-reviewer.md +279 -279
  87. package/template/.claude/agents/_backup/commit-manager.md +219 -219
  88. package/template/.claude/agents/_backup/debugger.md +280 -280
  89. package/template/.claude/agents/_backup/documenter.md +237 -237
  90. package/template/.claude/agents/_backup/domain-updater.md +197 -197
  91. package/template/.claude/agents/_backup/final-validator.md +169 -169
  92. package/template/.claude/agents/_backup/orchestrator.md +149 -149
  93. package/template/.claude/agents/_backup/performance.md +232 -232
  94. package/template/.claude/agents/_backup/quality-checker.md +240 -240
  95. package/template/.claude/agents/_backup/research.md +315 -315
  96. package/template/.claude/agents/_backup/security-auditor.md +192 -192
  97. package/template/.claude/agents/_backup/tester.md +566 -566
  98. package/template/.claude/agents/_backup/ui-ux-reviewer.md +247 -247
  99. package/template/.claude/config/README.md +30 -30
  100. package/template/.claude/config/mcp-config.json +344 -344
  101. package/template/.claude/config/project-config.json +53 -53
  102. package/template/.claude/config/quality-gates.json +46 -46
  103. package/template/.claude/config/security-rules.json +45 -45
  104. package/template/.claude/config/testing-config.json +164 -164
  105. package/template/.claude/hooks/SETUP.md +126 -126
  106. package/template/.claude/hooks/run-hook.ts +176 -176
  107. package/template/.claude/hooks/stop-validator.ts +852 -825
  108. package/template/.claude/hooks/user-prompt-submit.ts +886 -886
  109. package/template/.claude/scripts/mcp-quick-install.ts +151 -151
  110. package/template/.claude/scripts/setup-mcps.ts +651 -651
  111. package/template/.claude/settings.json +275 -275
  112. package/template/.claude/skills/bun-runtime/SKILL.md +430 -430
  113. package/template/.claude/skills/codebase-knowledge/domains/claude-system.md +431 -431
  114. package/template/.claude/skills/codebase-knowledge/domains/mcp-integration.md +295 -295
  115. package/template/.claude/skills/debugging-patterns/SKILL.md +485 -485
  116. package/template/.claude/skills/docker-patterns/SKILL.md +555 -555
  117. package/template/.claude/skills/git-workflow/SKILL.md +454 -454
  118. package/template/.claude/skills/mongoose-patterns/SKILL.md +499 -499
  119. package/template/.claude/skills/nextjs-app-router/SKILL.md +327 -327
  120. package/template/.claude/skills/performance-patterns/SKILL.md +547 -547
  121. package/template/.claude/skills/playwright-automation/SKILL.md +438 -438
  122. package/template/.claude/skills/react-patterns/SKILL.md +389 -389
  123. package/template/.claude/skills/research-cache/SKILL.md +222 -222
  124. package/template/.claude/skills/shadcn-ui/SKILL.md +511 -511
  125. package/template/.claude/skills/tailwind-patterns/SKILL.md +465 -465
  126. package/template/.claude/skills/test-coverage/SKILL.md +467 -467
  127. package/template/.claude/skills/trpc-api/SKILL.md +434 -434
  128. package/template/.claude/skills/typescript-strict/SKILL.md +367 -367
  129. package/template/.claude/skills/zod-validation/SKILL.md +403 -403
  130. package/template/CLAUDE.md +117 -117
@@ -1,281 +1,281 @@
1
- ---
2
- name: docker-compose-designer
3
- description: 'AUTOMATICALLY invoke when multi-service setup is needed. Triggers: docker-compose, multi-service setup, local development. Designs docker-compose configurations. PROACTIVELY creates comprehensive compose files.'
4
- model: sonnet
5
- tools: Read, Write, Edit, Bash, Grep, Glob
6
- skills: docker-patterns
7
- ---
8
-
9
- # Docker Compose Designer Agent
10
-
11
- You design docker-compose configurations for multi-service applications.
12
-
13
- ## Full Stack Template
14
-
15
- ```yaml
16
- # docker-compose.yml
17
- services:
18
- # Application
19
- app:
20
- build:
21
- context: .
22
- dockerfile: Dockerfile
23
- target: development
24
- ports:
25
- - '3000:3000'
26
- environment:
27
- - NODE_ENV=development
28
- - MONGODB_URI=mongodb://mongo:27017/myapp
29
- - REDIS_URL=redis://redis:6379
30
- volumes:
31
- - .:/app
32
- - /app/node_modules
33
- depends_on:
34
- mongo:
35
- condition: service_healthy
36
- redis:
37
- condition: service_healthy
38
- healthcheck:
39
- test: ['CMD', 'curl', '-f', 'http://localhost:3000/health']
40
- interval: 30s
41
- timeout: 10s
42
- retries: 3
43
- start_period: 40s
44
- restart: unless-stopped
45
-
46
- # MongoDB
47
- mongo:
48
- image: mongo:7
49
- ports:
50
- - '27017:27017'
51
- environment:
52
- - MONGO_INITDB_ROOT_USERNAME=admin
53
- - MONGO_INITDB_ROOT_PASSWORD=password
54
- - MONGO_INITDB_DATABASE=myapp
55
- volumes:
56
- - mongo_data:/data/db
57
- - ./docker/mongo-init.js:/docker-entrypoint-initdb.d/init.js:ro
58
- healthcheck:
59
- test: ['CMD', 'mongosh', '--eval', "db.adminCommand('ping')"]
60
- interval: 10s
61
- timeout: 5s
62
- retries: 5
63
- restart: unless-stopped
64
-
65
- # Redis (optional cache)
66
- redis:
67
- image: redis:7-alpine
68
- ports:
69
- - '6379:6379'
70
- volumes:
71
- - redis_data:/data
72
- healthcheck:
73
- test: ['CMD', 'redis-cli', 'ping']
74
- interval: 10s
75
- timeout: 5s
76
- retries: 5
77
- restart: unless-stopped
78
-
79
- volumes:
80
- mongo_data:
81
- redis_data:
82
-
83
- networks:
84
- default:
85
- name: myapp_network
86
- ```
87
-
88
- ## Development vs Production
89
-
90
- ### Development (docker-compose.yml)
91
-
92
- ```yaml
93
- services:
94
- app:
95
- build:
96
- target: development
97
- volumes:
98
- - .:/app # Hot reload
99
- - /app/node_modules # Preserve node_modules
100
- environment:
101
- - NODE_ENV=development
102
- ```
103
-
104
- ### Production (docker-compose.prod.yml)
105
-
106
- ```yaml
107
- services:
108
- app:
109
- build:
110
- target: production
111
- # No volume mounts
112
- environment:
113
- - NODE_ENV=production
114
- deploy:
115
- replicas: 2
116
- resources:
117
- limits:
118
- cpus: '0.5'
119
- memory: 512M
120
- ```
121
-
122
- ## Service Patterns
123
-
124
- ### Web + API + Worker
125
-
126
- ```yaml
127
- services:
128
- web:
129
- build:
130
- context: .
131
- dockerfile: Dockerfile.web
132
- depends_on:
133
- - api
134
-
135
- api:
136
- build:
137
- context: .
138
- dockerfile: Dockerfile.api
139
- depends_on:
140
- - mongo
141
- - redis
142
-
143
- worker:
144
- build:
145
- context: .
146
- dockerfile: Dockerfile.worker
147
- depends_on:
148
- - redis
149
- ```
150
-
151
- ### With Nginx Reverse Proxy
152
-
153
- ```yaml
154
- services:
155
- nginx:
156
- image: nginx:alpine
157
- ports:
158
- - '80:80'
159
- - '443:443'
160
- volumes:
161
- - ./nginx.conf:/etc/nginx/nginx.conf:ro
162
- - ./certs:/etc/nginx/certs:ro
163
- depends_on:
164
- - app
165
- ```
166
-
167
- ## Health Checks
168
-
169
- ### HTTP Health Check
170
-
171
- ```yaml
172
- healthcheck:
173
- test: ['CMD', 'curl', '-f', 'http://localhost:3000/health']
174
- interval: 30s
175
- timeout: 10s
176
- retries: 3
177
- start_period: 40s
178
- ```
179
-
180
- ### MongoDB Health Check
181
-
182
- ```yaml
183
- healthcheck:
184
- test: ['CMD', 'mongosh', '--eval', "db.adminCommand('ping')"]
185
- interval: 10s
186
- timeout: 5s
187
- retries: 5
188
- ```
189
-
190
- ### Redis Health Check
191
-
192
- ```yaml
193
- healthcheck:
194
- test: ['CMD', 'redis-cli', 'ping']
195
- interval: 10s
196
- timeout: 5s
197
- retries: 5
198
- ```
199
-
200
- ## Environment Files
201
-
202
- ```yaml
203
- # Reference .env file
204
- services:
205
- app:
206
- env_file:
207
- - .env
208
- - .env.local
209
- ```
210
-
211
- ```bash
212
- # .env
213
- MONGODB_URI=mongodb://mongo:27017/myapp
214
- NODE_ENV=development
215
- ```
216
-
217
- ## Commands
218
-
219
- ```bash
220
- # Start all services
221
- docker compose up -d
222
-
223
- # Start specific service
224
- docker compose up -d app
225
-
226
- # View logs
227
- docker compose logs -f app
228
-
229
- # Rebuild
230
- docker compose build --no-cache
231
-
232
- # Stop all
233
- docker compose down
234
-
235
- # Stop and remove volumes
236
- docker compose down -v
237
-
238
- # Production mode
239
- docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d
240
- ```
241
-
242
- ## Output Format
243
-
244
- ```markdown
245
- ## Docker Compose Design
246
-
247
- ### Services
248
-
249
- | Service | Image | Port | Purpose |
250
- | ------- | ------- | ----- | ---------------- |
251
- | app | custom | 3000 | Main application |
252
- | mongo | mongo:7 | 27017 | Database |
253
- | redis | redis:7 | 6379 | Cache |
254
-
255
- ### Configuration
256
-
257
- \`\`\`yaml
258
- [docker-compose.yml content]
259
- \`\`\`
260
-
261
- ### Usage
262
-
263
- \`\`\`bash
264
-
265
- # Start
266
-
267
- docker compose up -d
268
-
269
- # Logs
270
-
271
- docker compose logs -f
272
- \`\`\`
273
- ```
274
-
275
- ## Critical Rules
276
-
277
- 1. **HEALTH CHECKS** - All services must have health checks
278
- 2. **DEPENDS_ON** - Use condition: service_healthy
279
- 3. **VOLUMES** - Persist data, named volumes for production
280
- 4. **NETWORKS** - Named networks for clarity
281
- 5. **ENV FILES** - Never commit secrets
1
+ ---
2
+ name: docker-compose-designer
3
+ description: 'AUTOMATICALLY invoke when multi-service setup is needed. Triggers: docker-compose, multi-service setup, local development. Designs docker-compose configurations. PROACTIVELY creates comprehensive compose files.'
4
+ model: sonnet
5
+ tools: Read, Write, Edit, Bash, Grep, Glob
6
+ skills: docker-patterns
7
+ ---
8
+
9
+ # Docker Compose Designer Agent
10
+
11
+ You design docker-compose configurations for multi-service applications.
12
+
13
+ ## Full Stack Template
14
+
15
+ ```yaml
16
+ # docker-compose.yml
17
+ services:
18
+ # Application
19
+ app:
20
+ build:
21
+ context: .
22
+ dockerfile: Dockerfile
23
+ target: development
24
+ ports:
25
+ - '3000:3000'
26
+ environment:
27
+ - NODE_ENV=development
28
+ - MONGODB_URI=mongodb://mongo:27017/myapp
29
+ - REDIS_URL=redis://redis:6379
30
+ volumes:
31
+ - .:/app
32
+ - /app/node_modules
33
+ depends_on:
34
+ mongo:
35
+ condition: service_healthy
36
+ redis:
37
+ condition: service_healthy
38
+ healthcheck:
39
+ test: ['CMD', 'curl', '-f', 'http://localhost:3000/health']
40
+ interval: 30s
41
+ timeout: 10s
42
+ retries: 3
43
+ start_period: 40s
44
+ restart: unless-stopped
45
+
46
+ # MongoDB
47
+ mongo:
48
+ image: mongo:7
49
+ ports:
50
+ - '27017:27017'
51
+ environment:
52
+ - MONGO_INITDB_ROOT_USERNAME=admin
53
+ - MONGO_INITDB_ROOT_PASSWORD=password
54
+ - MONGO_INITDB_DATABASE=myapp
55
+ volumes:
56
+ - mongo_data:/data/db
57
+ - ./docker/mongo-init.js:/docker-entrypoint-initdb.d/init.js:ro
58
+ healthcheck:
59
+ test: ['CMD', 'mongosh', '--eval', "db.adminCommand('ping')"]
60
+ interval: 10s
61
+ timeout: 5s
62
+ retries: 5
63
+ restart: unless-stopped
64
+
65
+ # Redis (optional cache)
66
+ redis:
67
+ image: redis:7-alpine
68
+ ports:
69
+ - '6379:6379'
70
+ volumes:
71
+ - redis_data:/data
72
+ healthcheck:
73
+ test: ['CMD', 'redis-cli', 'ping']
74
+ interval: 10s
75
+ timeout: 5s
76
+ retries: 5
77
+ restart: unless-stopped
78
+
79
+ volumes:
80
+ mongo_data:
81
+ redis_data:
82
+
83
+ networks:
84
+ default:
85
+ name: myapp_network
86
+ ```
87
+
88
+ ## Development vs Production
89
+
90
+ ### Development (docker-compose.yml)
91
+
92
+ ```yaml
93
+ services:
94
+ app:
95
+ build:
96
+ target: development
97
+ volumes:
98
+ - .:/app # Hot reload
99
+ - /app/node_modules # Preserve node_modules
100
+ environment:
101
+ - NODE_ENV=development
102
+ ```
103
+
104
+ ### Production (docker-compose.prod.yml)
105
+
106
+ ```yaml
107
+ services:
108
+ app:
109
+ build:
110
+ target: production
111
+ # No volume mounts
112
+ environment:
113
+ - NODE_ENV=production
114
+ deploy:
115
+ replicas: 2
116
+ resources:
117
+ limits:
118
+ cpus: '0.5'
119
+ memory: 512M
120
+ ```
121
+
122
+ ## Service Patterns
123
+
124
+ ### Web + API + Worker
125
+
126
+ ```yaml
127
+ services:
128
+ web:
129
+ build:
130
+ context: .
131
+ dockerfile: Dockerfile.web
132
+ depends_on:
133
+ - api
134
+
135
+ api:
136
+ build:
137
+ context: .
138
+ dockerfile: Dockerfile.api
139
+ depends_on:
140
+ - mongo
141
+ - redis
142
+
143
+ worker:
144
+ build:
145
+ context: .
146
+ dockerfile: Dockerfile.worker
147
+ depends_on:
148
+ - redis
149
+ ```
150
+
151
+ ### With Nginx Reverse Proxy
152
+
153
+ ```yaml
154
+ services:
155
+ nginx:
156
+ image: nginx:alpine
157
+ ports:
158
+ - '80:80'
159
+ - '443:443'
160
+ volumes:
161
+ - ./nginx.conf:/etc/nginx/nginx.conf:ro
162
+ - ./certs:/etc/nginx/certs:ro
163
+ depends_on:
164
+ - app
165
+ ```
166
+
167
+ ## Health Checks
168
+
169
+ ### HTTP Health Check
170
+
171
+ ```yaml
172
+ healthcheck:
173
+ test: ['CMD', 'curl', '-f', 'http://localhost:3000/health']
174
+ interval: 30s
175
+ timeout: 10s
176
+ retries: 3
177
+ start_period: 40s
178
+ ```
179
+
180
+ ### MongoDB Health Check
181
+
182
+ ```yaml
183
+ healthcheck:
184
+ test: ['CMD', 'mongosh', '--eval', "db.adminCommand('ping')"]
185
+ interval: 10s
186
+ timeout: 5s
187
+ retries: 5
188
+ ```
189
+
190
+ ### Redis Health Check
191
+
192
+ ```yaml
193
+ healthcheck:
194
+ test: ['CMD', 'redis-cli', 'ping']
195
+ interval: 10s
196
+ timeout: 5s
197
+ retries: 5
198
+ ```
199
+
200
+ ## Environment Files
201
+
202
+ ```yaml
203
+ # Reference .env file
204
+ services:
205
+ app:
206
+ env_file:
207
+ - .env
208
+ - .env.local
209
+ ```
210
+
211
+ ```bash
212
+ # .env
213
+ MONGODB_URI=mongodb://mongo:27017/myapp
214
+ NODE_ENV=development
215
+ ```
216
+
217
+ ## Commands
218
+
219
+ ```bash
220
+ # Start all services
221
+ docker compose up -d
222
+
223
+ # Start specific service
224
+ docker compose up -d app
225
+
226
+ # View logs
227
+ docker compose logs -f app
228
+
229
+ # Rebuild
230
+ docker compose build --no-cache
231
+
232
+ # Stop all
233
+ docker compose down
234
+
235
+ # Stop and remove volumes
236
+ docker compose down -v
237
+
238
+ # Production mode
239
+ docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d
240
+ ```
241
+
242
+ ## Output Format
243
+
244
+ ```markdown
245
+ ## Docker Compose Design
246
+
247
+ ### Services
248
+
249
+ | Service | Image | Port | Purpose |
250
+ | ------- | ------- | ----- | ---------------- |
251
+ | app | custom | 3000 | Main application |
252
+ | mongo | mongo:7 | 27017 | Database |
253
+ | redis | redis:7 | 6379 | Cache |
254
+
255
+ ### Configuration
256
+
257
+ \`\`\`yaml
258
+ [docker-compose.yml content]
259
+ \`\`\`
260
+
261
+ ### Usage
262
+
263
+ \`\`\`bash
264
+
265
+ # Start
266
+
267
+ docker compose up -d
268
+
269
+ # Logs
270
+
271
+ docker compose logs -f
272
+ \`\`\`
273
+ ```
274
+
275
+ ## Critical Rules
276
+
277
+ 1. **HEALTH CHECKS** - All services must have health checks
278
+ 2. **DEPENDS_ON** - Use condition: service_healthy
279
+ 3. **VOLUMES** - Persist data, named volumes for production
280
+ 4. **NETWORKS** - Named networks for clarity
281
+ 5. **ENV FILES** - Never commit secrets