@nguyenphp/antigravity-marketing 1.0.18 → 1.0.20

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 (231) hide show
  1. package/README.md +130 -78
  2. package/package.json +4 -3
  3. package/templates/.agent/skills/marketing-report-expert/SKILL.md +70 -0
  4. package/templates/.agent/skills/minimax-docx/LICENSE +21 -0
  5. package/templates/.agent/skills/minimax-docx/SKILL.md +274 -0
  6. package/templates/.agent/skills/minimax-docx/assets/styles/academic_styles.xml +250 -0
  7. package/templates/.agent/skills/minimax-docx/assets/styles/corporate_styles.xml +284 -0
  8. package/templates/.agent/skills/minimax-docx/assets/styles/default_styles.xml +449 -0
  9. package/templates/.agent/skills/minimax-docx/assets/xsd/aesthetic-rules.xsd +470 -0
  10. package/templates/.agent/skills/minimax-docx/assets/xsd/business-rules.xsd +130 -0
  11. package/templates/.agent/skills/minimax-docx/assets/xsd/common-types.xsd +159 -0
  12. package/templates/.agent/skills/minimax-docx/assets/xsd/wml-subset.xsd +589 -0
  13. package/templates/.agent/skills/minimax-docx/references/cjk_typography.md +357 -0
  14. package/templates/.agent/skills/minimax-docx/references/cjk_university_template_guide.md +184 -0
  15. package/templates/.agent/skills/minimax-docx/references/comments_guide.md +191 -0
  16. package/templates/.agent/skills/minimax-docx/references/design_good_bad_examples.md +829 -0
  17. package/templates/.agent/skills/minimax-docx/references/design_principles.md +819 -0
  18. package/templates/.agent/skills/minimax-docx/references/openxml_element_order.md +308 -0
  19. package/templates/.agent/skills/minimax-docx/references/openxml_encyclopedia_part1.md +4061 -0
  20. package/templates/.agent/skills/minimax-docx/references/openxml_encyclopedia_part2.md +2820 -0
  21. package/templates/.agent/skills/minimax-docx/references/openxml_encyclopedia_part3.md +3381 -0
  22. package/templates/.agent/skills/minimax-docx/references/openxml_namespaces.md +82 -0
  23. package/templates/.agent/skills/minimax-docx/references/openxml_units.md +72 -0
  24. package/templates/.agent/skills/minimax-docx/references/scenario_a_create.md +284 -0
  25. package/templates/.agent/skills/minimax-docx/references/scenario_b_edit_content.md +295 -0
  26. package/templates/.agent/skills/minimax-docx/references/scenario_c_apply_template.md +456 -0
  27. package/templates/.agent/skills/minimax-docx/references/track_changes_guide.md +200 -0
  28. package/templates/.agent/skills/minimax-docx/references/troubleshooting.md +506 -0
  29. package/templates/.agent/skills/minimax-docx/references/typography_guide.md +294 -0
  30. package/templates/.agent/skills/minimax-docx/references/xsd_validation_guide.md +158 -0
  31. package/templates/.agent/skills/minimax-docx/scripts/doc_to_docx.sh +40 -0
  32. package/templates/.agent/skills/minimax-docx/scripts/docx_preview.sh +37 -0
  33. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Cli/MiniMaxAIDocx.Cli.csproj +19 -0
  34. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Cli/Program.cs +18 -0
  35. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
  36. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
  37. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/CreateCommand.cs +324 -0
  38. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/DiffCommand.cs +155 -0
  39. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/EditContentCommand.cs +487 -0
  40. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
  41. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
  42. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/ValidateCommand.cs +107 -0
  43. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/MiniMaxAIDocx.Core.csproj +15 -0
  44. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
  45. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
  46. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
  47. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/RunMerger.cs +81 -0
  48. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
  49. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
  50. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
  51. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
  52. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
  53. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
  54. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
  55. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
  56. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
  57. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
  58. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
  59. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
  60. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
  61. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/ImageSamples.cs +917 -0
  62. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
  63. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
  64. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
  65. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/TableSamples.cs +1163 -0
  66. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
  67. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Typography/CjkHelper.cs +39 -0
  68. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Typography/FontDefaults.cs +24 -0
  69. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Typography/PageSizes.cs +20 -0
  70. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
  71. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
  72. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Validation/ValidationResult.cs +23 -0
  73. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Validation/XsdValidator.cs +69 -0
  74. package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.slnx +4 -0
  75. package/templates/.agent/skills/minimax-docx/scripts/env_check.sh +196 -0
  76. package/templates/.agent/skills/minimax-docx/scripts/setup.ps1 +274 -0
  77. package/templates/.agent/skills/minimax-docx/scripts/setup.sh +504 -0
  78. package/templates/.agent/skills/minimax-multimodal-toolkit/SKILL.md +359 -0
  79. package/templates/.agent/skills/minimax-pdf/README.md +222 -0
  80. package/templates/.agent/skills/minimax-pdf/SKILL.md +201 -0
  81. package/templates/.agent/skills/minimax-pdf/design/design.md +381 -0
  82. package/templates/.agent/skills/minimax-pdf/scripts/cover.py +1579 -0
  83. package/templates/.agent/skills/minimax-pdf/scripts/fill_inspect.py +200 -0
  84. package/templates/.agent/skills/minimax-pdf/scripts/fill_write.py +242 -0
  85. package/templates/.agent/skills/minimax-pdf/scripts/make.sh +491 -0
  86. package/templates/.agent/skills/minimax-pdf/scripts/merge.py +112 -0
  87. package/templates/.agent/skills/minimax-pdf/scripts/palette.py +559 -0
  88. package/templates/.agent/skills/minimax-pdf/scripts/reformat_parse.py +374 -0
  89. package/templates/.agent/skills/minimax-pdf/scripts/render_body.py +1055 -0
  90. package/templates/.agent/skills/minimax-pdf/scripts/render_cover.cjs +111 -0
  91. package/templates/.agent/skills/minimax-xlsx/SKILL.md +138 -0
  92. package/templates/.agent/skills/minimax-xlsx/references/create.md +691 -0
  93. package/templates/.agent/skills/minimax-xlsx/references/edit.md +684 -0
  94. package/templates/.agent/skills/minimax-xlsx/references/fix.md +37 -0
  95. package/templates/.agent/skills/minimax-xlsx/references/format.md +768 -0
  96. package/templates/.agent/skills/minimax-xlsx/references/ooxml-cheatsheet.md +231 -0
  97. package/templates/.agent/skills/minimax-xlsx/references/read-analyze.md +97 -0
  98. package/templates/.agent/skills/minimax-xlsx/references/validate.md +772 -0
  99. package/templates/.agent/skills/minimax-xlsx/scripts/formula_check.py +422 -0
  100. package/templates/.agent/skills/minimax-xlsx/scripts/libreoffice_recalc.py +248 -0
  101. package/templates/.agent/skills/minimax-xlsx/scripts/shared_strings_builder.py +163 -0
  102. package/templates/.agent/skills/minimax-xlsx/scripts/style_audit.py +575 -0
  103. package/templates/.agent/skills/minimax-xlsx/scripts/xlsx_add_column.py +395 -0
  104. package/templates/.agent/skills/minimax-xlsx/scripts/xlsx_insert_row.py +274 -0
  105. package/templates/.agent/skills/minimax-xlsx/scripts/xlsx_pack.py +87 -0
  106. package/templates/.agent/skills/minimax-xlsx/scripts/xlsx_reader.py +362 -0
  107. package/templates/.agent/skills/minimax-xlsx/scripts/xlsx_shift_rows.py +396 -0
  108. package/templates/.agent/skills/minimax-xlsx/scripts/xlsx_unpack.py +130 -0
  109. package/templates/.agent/skills/minimax-xlsx/templates/minimal_xlsx/[Content_Types].xml +9 -0
  110. package/templates/.agent/skills/minimax-xlsx/templates/minimal_xlsx/_rels/.rels +6 -0
  111. package/templates/.agent/skills/minimax-xlsx/templates/minimal_xlsx/xl/_rels/workbook.xml.rels +19 -0
  112. package/templates/.agent/skills/minimax-xlsx/templates/minimal_xlsx/xl/sharedStrings.xml +33 -0
  113. package/templates/.agent/skills/minimax-xlsx/templates/minimal_xlsx/xl/styles.xml +160 -0
  114. package/templates/.agent/skills/minimax-xlsx/templates/minimal_xlsx/xl/workbook.xml +30 -0
  115. package/templates/.agent/skills/minimax-xlsx/templates/minimal_xlsx/xl/worksheets/sheet1.xml +70 -0
  116. package/templates/.agent/skills/pptx-generator/SKILL.md +249 -0
  117. package/templates/.agent/skills/pptx-generator/references/design-system.md +392 -0
  118. package/templates/.agent/skills/pptx-generator/references/editing.md +162 -0
  119. package/templates/.agent/skills/pptx-generator/references/pitfalls.md +112 -0
  120. package/templates/.agent/skills/pptx-generator/references/pptxgenjs.md +420 -0
  121. package/templates/.agent/skills/pptx-generator/references/slide-types.md +413 -0
  122. package/templates/.agent/skills/tutorial-video-expert/SKILL.md +88 -0
  123. package/templates/.agent/skills/ui-ux-pro-max/SKILL.md +170 -585
  124. package/templates/.agent/skills/vision-analysis/SKILL.md +174 -0
  125. package/templates/.agent/workflows/analyze.md +3 -0
  126. package/templates/.agent/workflows/brand-report.md +44 -0
  127. package/templates/.agent/workflows/report.md +49 -0
  128. package/templates/.agent/agents/backend-specialist.md +0 -263
  129. package/templates/.agent/agents/database-architect.md +0 -226
  130. package/templates/.agent/agents/debugger.md +0 -225
  131. package/templates/.agent/agents/devops-engineer.md +0 -242
  132. package/templates/.agent/agents/frontend-specialist.md +0 -527
  133. package/templates/.agent/agents/game-developer.md +0 -162
  134. package/templates/.agent/agents/mobile-developer.md +0 -377
  135. package/templates/.agent/agents/penetration-tester.md +0 -188
  136. package/templates/.agent/agents/security-auditor.md +0 -170
  137. package/templates/.agent/agents/test-engineer.md +0 -158
  138. package/templates/.agent/skills/api-patterns/SKILL.md +0 -81
  139. package/templates/.agent/skills/api-patterns/api-style.md +0 -42
  140. package/templates/.agent/skills/api-patterns/auth.md +0 -24
  141. package/templates/.agent/skills/api-patterns/documentation.md +0 -26
  142. package/templates/.agent/skills/api-patterns/graphql.md +0 -41
  143. package/templates/.agent/skills/api-patterns/rate-limiting.md +0 -31
  144. package/templates/.agent/skills/api-patterns/response.md +0 -37
  145. package/templates/.agent/skills/api-patterns/rest.md +0 -40
  146. package/templates/.agent/skills/api-patterns/scripts/api_validator.py +0 -211
  147. package/templates/.agent/skills/api-patterns/security-testing.md +0 -122
  148. package/templates/.agent/skills/api-patterns/trpc.md +0 -41
  149. package/templates/.agent/skills/api-patterns/versioning.md +0 -22
  150. package/templates/.agent/skills/app-builder/SKILL.md +0 -75
  151. package/templates/.agent/skills/app-builder/agent-coordination.md +0 -71
  152. package/templates/.agent/skills/app-builder/feature-building.md +0 -53
  153. package/templates/.agent/skills/app-builder/project-detection.md +0 -34
  154. package/templates/.agent/skills/app-builder/scaffolding.md +0 -118
  155. package/templates/.agent/skills/app-builder/tech-stack.md +0 -40
  156. package/templates/.agent/skills/app-builder/templates/SKILL.md +0 -39
  157. package/templates/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +0 -76
  158. package/templates/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +0 -92
  159. package/templates/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +0 -88
  160. package/templates/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +0 -88
  161. package/templates/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +0 -83
  162. package/templates/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +0 -90
  163. package/templates/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +0 -90
  164. package/templates/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +0 -82
  165. package/templates/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +0 -100
  166. package/templates/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +0 -106
  167. package/templates/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +0 -101
  168. package/templates/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +0 -83
  169. package/templates/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +0 -93
  170. package/templates/.agent/skills/architecture/SKILL.md +0 -55
  171. package/templates/.agent/skills/architecture/context-discovery.md +0 -43
  172. package/templates/.agent/skills/architecture/examples.md +0 -94
  173. package/templates/.agent/skills/architecture/pattern-selection.md +0 -68
  174. package/templates/.agent/skills/architecture/patterns-reference.md +0 -50
  175. package/templates/.agent/skills/architecture/trade-off-analysis.md +0 -77
  176. package/templates/.agent/skills/bash-linux/SKILL.md +0 -199
  177. package/templates/.agent/skills/behavioral-modes/SKILL.md +0 -242
  178. package/templates/.agent/skills/clean-code/SKILL.md +0 -201
  179. package/templates/.agent/skills/code-review-checklist/SKILL.md +0 -109
  180. package/templates/.agent/skills/database-design/SKILL.md +0 -52
  181. package/templates/.agent/skills/database-design/database-selection.md +0 -43
  182. package/templates/.agent/skills/database-design/indexing.md +0 -39
  183. package/templates/.agent/skills/database-design/migrations.md +0 -48
  184. package/templates/.agent/skills/database-design/optimization.md +0 -36
  185. package/templates/.agent/skills/database-design/orm-selection.md +0 -30
  186. package/templates/.agent/skills/database-design/schema-design.md +0 -56
  187. package/templates/.agent/skills/database-design/scripts/schema_validator.py +0 -172
  188. package/templates/.agent/skills/deployment-procedures/SKILL.md +0 -241
  189. package/templates/.agent/skills/docker-expert/SKILL.md +0 -409
  190. package/templates/.agent/skills/game-development/2d-games/SKILL.md +0 -119
  191. package/templates/.agent/skills/game-development/3d-games/SKILL.md +0 -135
  192. package/templates/.agent/skills/game-development/SKILL.md +0 -167
  193. package/templates/.agent/skills/game-development/game-art/SKILL.md +0 -185
  194. package/templates/.agent/skills/game-development/game-audio/SKILL.md +0 -190
  195. package/templates/.agent/skills/game-development/game-design/SKILL.md +0 -129
  196. package/templates/.agent/skills/game-development/mobile-games/SKILL.md +0 -108
  197. package/templates/.agent/skills/game-development/multiplayer/SKILL.md +0 -132
  198. package/templates/.agent/skills/game-development/pc-games/SKILL.md +0 -144
  199. package/templates/.agent/skills/game-development/vr-ar/SKILL.md +0 -123
  200. package/templates/.agent/skills/game-development/web-games/SKILL.md +0 -150
  201. package/templates/.agent/skills/lint-and-validate/SKILL.md +0 -45
  202. package/templates/.agent/skills/lint-and-validate/scripts/lint_runner.py +0 -172
  203. package/templates/.agent/skills/lint-and-validate/scripts/type_coverage.py +0 -173
  204. package/templates/.agent/skills/mcp-builder/SKILL.md +0 -176
  205. package/templates/.agent/skills/nestjs-expert/SKILL.md +0 -552
  206. package/templates/.agent/skills/nextjs-best-practices/SKILL.md +0 -203
  207. package/templates/.agent/skills/nodejs-best-practices/SKILL.md +0 -333
  208. package/templates/.agent/skills/parallel-agents/SKILL.md +0 -175
  209. package/templates/.agent/skills/performance-profiling/SKILL.md +0 -143
  210. package/templates/.agent/skills/performance-profiling/scripts/lighthouse_audit.py +0 -76
  211. package/templates/.agent/skills/powershell-windows/SKILL.md +0 -167
  212. package/templates/.agent/skills/prisma-expert/SKILL.md +0 -355
  213. package/templates/.agent/skills/python-patterns/SKILL.md +0 -441
  214. package/templates/.agent/skills/react-patterns/SKILL.md +0 -198
  215. package/templates/.agent/skills/red-team-tactics/SKILL.md +0 -199
  216. package/templates/.agent/skills/server-management/SKILL.md +0 -161
  217. package/templates/.agent/skills/systematic-debugging/SKILL.md +0 -109
  218. package/templates/.agent/skills/tdd-workflow/SKILL.md +0 -149
  219. package/templates/.agent/skills/testing-patterns/SKILL.md +0 -178
  220. package/templates/.agent/skills/testing-patterns/scripts/test_runner.py +0 -219
  221. package/templates/.agent/skills/typescript-expert/SKILL.md +0 -429
  222. package/templates/.agent/skills/vue-expert/SKILL.md +0 -374
  223. package/templates/.agent/skills/vulnerability-scanner/SKILL.md +0 -276
  224. package/templates/.agent/skills/vulnerability-scanner/checklists.md +0 -121
  225. package/templates/.agent/skills/vulnerability-scanner/scripts/security_scan.py +0 -458
  226. package/templates/.agent/skills/webapp-testing/SKILL.md +0 -187
  227. package/templates/.agent/skills/webapp-testing/scripts/playwright_runner.py +0 -173
  228. package/templates/.agent/workflows/debug.md +0 -103
  229. package/templates/.agent/workflows/deploy.md +0 -176
  230. package/templates/.agent/workflows/enhance.md +0 -63
  231. package/templates/.agent/workflows/test.md +0 -144
@@ -1,118 +0,0 @@
1
- # Project Scaffolding
2
-
3
- > Directory structure and core files for new projects.
4
-
5
- ---
6
-
7
- ## Next.js Full-Stack Structure (2025 Optimized)
8
-
9
- ```
10
- project-name/
11
- ├── src/
12
- │ ├── app/ # Routes only (thin layer)
13
- │ │ ├── layout.tsx
14
- │ │ ├── page.tsx
15
- │ │ ├── globals.css
16
- │ │ ├── (auth)/ # Route group - auth pages
17
- │ │ │ ├── login/page.tsx
18
- │ │ │ └── register/page.tsx
19
- │ │ ├── (dashboard)/ # Route group - dashboard layout
20
- │ │ │ ├── layout.tsx
21
- │ │ │ └── page.tsx
22
- │ │ └── api/
23
- │ │ └── [resource]/route.ts
24
- │ │
25
- │ ├── features/ # Feature-based modules
26
- │ │ ├── auth/
27
- │ │ │ ├── components/
28
- │ │ │ ├── hooks/
29
- │ │ │ ├── actions.ts # Server Actions
30
- │ │ │ ├── queries.ts # Data fetching
31
- │ │ │ └── types.ts
32
- │ │ ├── products/
33
- │ │ │ ├── components/
34
- │ │ │ ├── actions.ts
35
- │ │ │ └── queries.ts
36
- │ │ └── cart/
37
- │ │ └── ...
38
- │ │
39
- │ ├── shared/ # Shared utilities
40
- │ │ ├── components/ui/ # Reusable UI components
41
- │ │ ├── lib/ # Utils, helpers
42
- │ │ └── hooks/ # Global hooks
43
- │ │
44
- │ └── server/ # Server-only code
45
- │ ├── db/ # Database client (Prisma)
46
- │ ├── auth/ # Auth config
47
- │ └── services/ # External API integrations
48
-
49
- ├── prisma/
50
- │ ├── schema.prisma
51
- │ ├── migrations/
52
- │ └── seed.ts
53
-
54
- ├── public/
55
- ├── .env.example
56
- ├── .env.local
57
- ├── package.json
58
- ├── tailwind.config.ts
59
- ├── tsconfig.json
60
- └── README.md
61
- ```
62
-
63
- ---
64
-
65
- ## Structure Principles
66
-
67
- | Principle | Implementation |
68
- |-----------|----------------|
69
- | **Feature isolation** | Each feature in `features/` with its own components, hooks, actions |
70
- | **Server/Client separation** | Server-only code in `server/`, prevents accidental client imports |
71
- | **Thin routes** | `app/` only for routing, logic lives in `features/` |
72
- | **Route groups** | `(groupName)/` for layout sharing without URL impact |
73
- | **Shared code** | `shared/` for truly reusable UI and utilities |
74
-
75
- ---
76
-
77
- ## Core Files
78
-
79
- | File | Purpose |
80
- |------|---------|
81
- | `package.json` | Dependencies |
82
- | `tsconfig.json` | TypeScript + path aliases (`@/features/*`) |
83
- | `tailwind.config.ts` | Tailwind config |
84
- | `.env.example` | Environment template |
85
- | `README.md` | Project documentation |
86
- | `.gitignore` | Git ignore rules |
87
- | `prisma/schema.prisma` | Database schema |
88
-
89
- ---
90
-
91
- ## Path Aliases (tsconfig.json)
92
-
93
- ```json
94
- {
95
- "compilerOptions": {
96
- "paths": {
97
- "@/*": ["./src/*"],
98
- "@/features/*": ["./src/features/*"],
99
- "@/shared/*": ["./src/shared/*"],
100
- "@/server/*": ["./src/server/*"]
101
- }
102
- }
103
- }
104
- ```
105
-
106
- ---
107
-
108
- ## When to Use What
109
-
110
- | Need | Location |
111
- |------|----------|
112
- | New page/route | `app/(group)/page.tsx` |
113
- | Feature component | `features/[name]/components/` |
114
- | Server action | `features/[name]/actions.ts` |
115
- | Data fetching | `features/[name]/queries.ts` |
116
- | Reusable button/input | `shared/components/ui/` |
117
- | Database query | `server/db/` |
118
- | External API call | `server/services/` |
@@ -1,40 +0,0 @@
1
- # Tech Stack Selection (2025)
2
-
3
- > Default and alternative technology choices for web applications.
4
-
5
- ## Default Stack (Web App - 2025)
6
-
7
- ```yaml
8
- Frontend:
9
- framework: Next.js 16 (Stable)
10
- language: TypeScript 5.7+
11
- styling: Tailwind CSS v4
12
- state: React 19 Actions / Server Components
13
- bundler: Turbopack (Stable for Dev)
14
-
15
- Backend:
16
- runtime: Node.js 23
17
- framework: Next.js API Routes / Hono (for Edge)
18
- validation: Zod / TypeBox
19
-
20
- Database:
21
- primary: PostgreSQL
22
- orm: Prisma / Drizzle
23
- hosting: Supabase / Neon
24
-
25
- Auth:
26
- provider: Auth.js (v5) / Clerk
27
-
28
- Monorepo:
29
- tool: Turborepo 2.0
30
- ```
31
-
32
- ## Alternative Options
33
-
34
- | Need | Default | Alternative |
35
- |------|---------|-------------|
36
- | Real-time | - | Supabase Realtime, Socket.io |
37
- | File storage | - | Cloudinary, S3 |
38
- | Payment | Stripe | LemonSqueezy, Paddle |
39
- | Email | - | Resend, SendGrid |
40
- | Search | - | Algolia, Typesense |
@@ -1,39 +0,0 @@
1
- ---
2
- name: templates
3
- description: Project scaffolding templates for new applications. Use when creating new projects from scratch. Contains 12 templates for various tech stacks.
4
- allowed-tools: Read, Glob, Grep
5
- ---
6
-
7
- # Project Templates
8
-
9
- > Quick-start templates for scaffolding new projects.
10
-
11
- ---
12
-
13
- ## 🎯 Selective Reading Rule
14
-
15
- **Read ONLY the template matching user's project type!**
16
-
17
- | Template | Tech Stack | When to Use |
18
- |----------|------------|-------------|
19
- | [nextjs-fullstack](nextjs-fullstack/TEMPLATE.md) | Next.js + Prisma | Full-stack web app |
20
- | [nextjs-saas](nextjs-saas/TEMPLATE.md) | Next.js + Stripe | SaaS product |
21
- | [nextjs-static](nextjs-static/TEMPLATE.md) | Next.js + Framer | Landing page |
22
- | [express-api](express-api/TEMPLATE.md) | Express + JWT | REST API |
23
- | [python-fastapi](python-fastapi/TEMPLATE.md) | FastAPI | Python API |
24
- | [react-native-app](react-native-app/TEMPLATE.md) | Expo + Zustand | Mobile app |
25
- | [flutter-app](flutter-app/TEMPLATE.md) | Flutter + Riverpod | Cross-platform |
26
- | [electron-desktop](electron-desktop/TEMPLATE.md) | Electron + React | Desktop app |
27
- | [chrome-extension](chrome-extension/TEMPLATE.md) | Chrome MV3 | Browser extension |
28
- | [cli-tool](cli-tool/TEMPLATE.md) | Node.js + Commander | CLI app |
29
- | [monorepo-turborepo](monorepo-turborepo/TEMPLATE.md) | Turborepo + pnpm | Monorepo |
30
- | [astro-static](astro-static/TEMPLATE.md) | Astro + MDX | Blog / Docs |
31
-
32
- ---
33
-
34
- ## Usage
35
-
36
- 1. User says "create [type] app"
37
- 2. Match to appropriate template
38
- 3. Read ONLY that template's TEMPLATE.md
39
- 4. Follow its tech stack and structure
@@ -1,76 +0,0 @@
1
- ---
2
- name: astro-static
3
- description: Astro static site template principles. Content-focused websites, blogs, documentation.
4
- ---
5
-
6
- # Astro Static Site Template
7
-
8
- ## Tech Stack
9
-
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Framework | Astro 4.x |
13
- | Content | MDX + Content Collections |
14
- | Styling | Tailwind CSS |
15
- | Integrations | Sitemap, RSS, SEO |
16
- | Output | Static/SSG |
17
-
18
- ---
19
-
20
- ## Directory Structure
21
-
22
- ```
23
- project-name/
24
- ├── src/
25
- │ ├── components/ # .astro components
26
- │ ├── content/ # MDX content
27
- │ │ ├── blog/
28
- │ │ └── config.ts # Collection schemas
29
- │ ├── layouts/ # Page layouts
30
- │ ├── pages/ # File-based routing
31
- │ └── styles/
32
- ├── public/ # Static assets
33
- ├── astro.config.mjs
34
- └── package.json
35
- ```
36
-
37
- ---
38
-
39
- ## Key Concepts
40
-
41
- | Concept | Description |
42
- |---------|-------------|
43
- | Content Collections | Type-safe content with Zod schemas |
44
- | Islands Architecture | Partial hydration for interactivity |
45
- | Zero JS by default | Static HTML unless needed |
46
- | MDX Support | Markdown with components |
47
-
48
- ---
49
-
50
- ## Setup Steps
51
-
52
- 1. `npm create astro@latest {{name}}`
53
- 2. Add integrations: `npx astro add mdx tailwind sitemap`
54
- 3. Configure `astro.config.mjs`
55
- 4. Create content collections
56
- 5. `npm run dev`
57
-
58
- ---
59
-
60
- ## Deployment
61
-
62
- | Platform | Method |
63
- |----------|--------|
64
- | Vercel | Auto-detected |
65
- | Netlify | Auto-detected |
66
- | Cloudflare Pages | Auto-detected |
67
- | GitHub Pages | Build + deploy action |
68
-
69
- ---
70
-
71
- ## Best Practices
72
-
73
- - Use Content Collections for type safety
74
- - Leverage static generation
75
- - Add islands only where needed
76
- - Optimize images with Astro Image
@@ -1,92 +0,0 @@
1
- ---
2
- name: chrome-extension
3
- description: Chrome Extension template principles. Manifest V3, React, TypeScript.
4
- ---
5
-
6
- # Chrome Extension Template
7
-
8
- ## Tech Stack
9
-
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Manifest | V3 |
13
- | UI | React 18 |
14
- | Language | TypeScript |
15
- | Styling | Tailwind CSS |
16
- | Bundler | Vite |
17
- | Storage | Chrome Storage API |
18
-
19
- ---
20
-
21
- ## Directory Structure
22
-
23
- ```
24
- project-name/
25
- ├── src/
26
- │ ├── popup/ # Extension popup
27
- │ ├── options/ # Options page
28
- │ ├── background/ # Service worker
29
- │ ├── content/ # Content scripts
30
- │ ├── components/
31
- │ ├── hooks/
32
- │ └── lib/
33
- │ ├── storage.ts # Chrome storage helpers
34
- │ └── messaging.ts # Message passing
35
- ├── public/
36
- │ ├── icons/
37
- │ └── manifest.json
38
- └── package.json
39
- ```
40
-
41
- ---
42
-
43
- ## Manifest V3 Concepts
44
-
45
- | Component | Purpose |
46
- |-----------|---------|
47
- | Service Worker | Background processing |
48
- | Content Scripts | Page injection |
49
- | Popup | User interface |
50
- | Options Page | Settings |
51
-
52
- ---
53
-
54
- ## Permissions
55
-
56
- | Permission | Use |
57
- |------------|-----|
58
- | storage | Save user data |
59
- | activeTab | Current tab access |
60
- | scripting | Inject scripts |
61
- | host_permissions | Site access |
62
-
63
- ---
64
-
65
- ## Setup Steps
66
-
67
- 1. `npm create vite {{name}} -- --template react-ts`
68
- 2. Add Chrome types: `npm install -D @types/chrome`
69
- 3. Configure Vite for multi-entry
70
- 4. Create manifest.json
71
- 5. `npm run dev` (watch mode)
72
- 6. Load in Chrome: `chrome://extensions` → Load unpacked
73
-
74
- ---
75
-
76
- ## Development Tips
77
-
78
- | Task | Method |
79
- |------|--------|
80
- | Debug Popup | Right-click icon → Inspect |
81
- | Debug Background | Extensions page → Service worker |
82
- | Debug Content | DevTools console on page |
83
- | Hot Reload | `npm run dev` with watch |
84
-
85
- ---
86
-
87
- ## Best Practices
88
-
89
- - Use type-safe messaging
90
- - Wrap Chrome APIs in promises
91
- - Minimize permissions
92
- - Handle offline gracefully
@@ -1,88 +0,0 @@
1
- ---
2
- name: cli-tool
3
- description: Node.js CLI tool template principles. Commander.js, interactive prompts.
4
- ---
5
-
6
- # CLI Tool Template
7
-
8
- ## Tech Stack
9
-
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Runtime | Node.js 20+ |
13
- | Language | TypeScript |
14
- | CLI Framework | Commander.js |
15
- | Prompts | Inquirer.js |
16
- | Output | chalk + ora |
17
- | Config | cosmiconfig |
18
-
19
- ---
20
-
21
- ## Directory Structure
22
-
23
- ```
24
- project-name/
25
- ├── src/
26
- │ ├── index.ts # Entry point
27
- │ ├── cli.ts # CLI setup
28
- │ ├── commands/ # Command handlers
29
- │ ├── lib/
30
- │ │ ├── config.ts # Config loader
31
- │ │ └── logger.ts # Styled output
32
- │ └── types/
33
- ├── bin/
34
- │ └── cli.js # Executable
35
- └── package.json
36
- ```
37
-
38
- ---
39
-
40
- ## CLI Design Principles
41
-
42
- | Principle | Description |
43
- |-----------|-------------|
44
- | Subcommands | Group related actions |
45
- | Options | Flags with defaults |
46
- | Interactive | Prompts when needed |
47
- | Non-interactive | Support --yes flags |
48
-
49
- ---
50
-
51
- ## Key Components
52
-
53
- | Component | Purpose |
54
- |-----------|---------|
55
- | Commander | Command parsing |
56
- | Inquirer | Interactive prompts |
57
- | Chalk | Colored output |
58
- | Ora | Spinners/loading |
59
- | Cosmiconfig | Config file discovery |
60
-
61
- ---
62
-
63
- ## Setup Steps
64
-
65
- 1. Create project directory
66
- 2. `npm init -y`
67
- 3. Install deps: `npm install commander @inquirer/prompts chalk ora cosmiconfig`
68
- 4. Configure bin in package.json
69
- 5. `npm link` for local testing
70
-
71
- ---
72
-
73
- ## Publishing
74
-
75
- ```bash
76
- npm login
77
- npm publish
78
- ```
79
-
80
- ---
81
-
82
- ## Best Practices
83
-
84
- - Provide helpful error messages
85
- - Support both interactive and non-interactive modes
86
- - Use consistent output styling
87
- - Validate inputs with Zod
88
- - Exit with proper codes (0 success, 1 error)
@@ -1,88 +0,0 @@
1
- ---
2
- name: electron-desktop
3
- description: Electron desktop app template principles. Cross-platform, React, TypeScript.
4
- ---
5
-
6
- # Electron Desktop App Template
7
-
8
- ## Tech Stack
9
-
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Framework | Electron 28+ |
13
- | UI | React 18 |
14
- | Language | TypeScript |
15
- | Styling | Tailwind CSS |
16
- | Bundler | Vite + electron-builder |
17
- | IPC | Type-safe communication |
18
-
19
- ---
20
-
21
- ## Directory Structure
22
-
23
- ```
24
- project-name/
25
- ├── electron/
26
- │ ├── main.ts # Main process
27
- │ ├── preload.ts # Preload script
28
- │ └── ipc/ # IPC handlers
29
- ├── src/
30
- │ ├── App.tsx
31
- │ ├── components/
32
- │ │ ├── TitleBar.tsx # Custom title bar
33
- │ │ └── ...
34
- │ └── hooks/
35
- ├── public/
36
- └── package.json
37
- ```
38
-
39
- ---
40
-
41
- ## Process Model
42
-
43
- | Process | Role |
44
- |---------|------|
45
- | Main | Node.js, system access |
46
- | Renderer | Chromium, React UI |
47
- | Preload | Bridge, context isolation |
48
-
49
- ---
50
-
51
- ## Key Concepts
52
-
53
- | Concept | Purpose |
54
- |---------|---------|
55
- | contextBridge | Safe API exposure |
56
- | ipcMain/ipcRenderer | Process communication |
57
- | nodeIntegration: false | Security |
58
- | contextIsolation: true | Security |
59
-
60
- ---
61
-
62
- ## Setup Steps
63
-
64
- 1. `npm create vite {{name}} -- --template react-ts`
65
- 2. Install: `npm install -D electron electron-builder vite-plugin-electron`
66
- 3. Create electron/ directory
67
- 4. Configure main process
68
- 5. `npm run electron:dev`
69
-
70
- ---
71
-
72
- ## Build Targets
73
-
74
- | Platform | Output |
75
- |----------|--------|
76
- | Windows | NSIS, Portable |
77
- | macOS | DMG, ZIP |
78
- | Linux | AppImage, DEB |
79
-
80
- ---
81
-
82
- ## Best Practices
83
-
84
- - Use preload script for main/renderer bridge
85
- - Type-safe IPC with typed handlers
86
- - Custom title bar for native feel
87
- - Handle window state (maximize, minimize)
88
- - Auto-updates with electron-updater
@@ -1,83 +0,0 @@
1
- ---
2
- name: express-api
3
- description: Express.js REST API template principles. TypeScript, Prisma, JWT.
4
- ---
5
-
6
- # Express.js API Template
7
-
8
- ## Tech Stack
9
-
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Runtime | Node.js 20+ |
13
- | Framework | Express.js |
14
- | Language | TypeScript |
15
- | Database | PostgreSQL + Prisma |
16
- | Validation | Zod |
17
- | Auth | JWT + bcrypt |
18
-
19
- ---
20
-
21
- ## Directory Structure
22
-
23
- ```
24
- project-name/
25
- ├── prisma/
26
- │ └── schema.prisma
27
- ├── src/
28
- │ ├── app.ts # Express setup
29
- │ ├── config/ # Environment
30
- │ ├── routes/ # Route handlers
31
- │ ├── controllers/ # Business logic
32
- │ ├── services/ # Data access
33
- │ ├── middleware/
34
- │ │ ├── auth.ts # JWT verify
35
- │ │ ├── error.ts # Error handler
36
- │ │ └── validate.ts # Zod validation
37
- │ ├── schemas/ # Zod schemas
38
- │ └── utils/
39
- └── package.json
40
- ```
41
-
42
- ---
43
-
44
- ## Middleware Stack
45
-
46
- | Order | Middleware |
47
- |-------|------------|
48
- | 1 | helmet (security) |
49
- | 2 | cors |
50
- | 3 | morgan (logging) |
51
- | 4 | body parsing |
52
- | 5 | routes |
53
- | 6 | error handler |
54
-
55
- ---
56
-
57
- ## API Response Format
58
-
59
- | Type | Structure |
60
- |------|-----------|
61
- | Success | `{ success: true, data: {...} }` |
62
- | Error | `{ error: "message", details: [...] }` |
63
-
64
- ---
65
-
66
- ## Setup Steps
67
-
68
- 1. Create project directory
69
- 2. `npm init -y`
70
- 3. Install deps: `npm install express prisma zod bcrypt jsonwebtoken`
71
- 4. Configure Prisma
72
- 5. `npm run db:push`
73
- 6. `npm run dev`
74
-
75
- ---
76
-
77
- ## Best Practices
78
-
79
- - Layer architecture (routes → controllers → services)
80
- - Validate all inputs with Zod
81
- - Centralized error handling
82
- - Environment-based config
83
- - Use Prisma for type-safe DB access
@@ -1,90 +0,0 @@
1
- ---
2
- name: flutter-app
3
- description: Flutter mobile app template principles. Riverpod, Go Router, clean architecture.
4
- ---
5
-
6
- # Flutter App Template
7
-
8
- ## Tech Stack
9
-
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Framework | Flutter 3.x |
13
- | Language | Dart 3.x |
14
- | State | Riverpod 2.0 |
15
- | Navigation | Go Router |
16
- | HTTP | Dio |
17
- | Storage | Hive |
18
-
19
- ---
20
-
21
- ## Directory Structure
22
-
23
- ```
24
- project_name/
25
- ├── lib/
26
- │ ├── main.dart
27
- │ ├── app.dart
28
- │ ├── core/
29
- │ │ ├── constants/
30
- │ │ ├── theme/
31
- │ │ ├── router/
32
- │ │ └── utils/
33
- │ ├── features/
34
- │ │ ├── auth/
35
- │ │ │ ├── data/
36
- │ │ │ ├── domain/
37
- │ │ │ └── presentation/
38
- │ │ └── home/
39
- │ ├── shared/
40
- │ │ ├── widgets/
41
- │ │ └── providers/
42
- │ └── services/
43
- │ ├── api/
44
- │ └── storage/
45
- ├── test/
46
- └── pubspec.yaml
47
- ```
48
-
49
- ---
50
-
51
- ## Architecture Layers
52
-
53
- | Layer | Contents |
54
- |-------|----------|
55
- | Presentation | Screens, Widgets, Providers |
56
- | Domain | Entities, Use Cases |
57
- | Data | Repositories, Models |
58
-
59
- ---
60
-
61
- ## Key Packages
62
-
63
- | Package | Purpose |
64
- |---------|---------|
65
- | flutter_riverpod | State management |
66
- | riverpod_annotation | Code generation |
67
- | go_router | Navigation |
68
- | dio | HTTP client |
69
- | freezed | Immutable models |
70
- | hive | Local storage |
71
-
72
- ---
73
-
74
- ## Setup Steps
75
-
76
- 1. `flutter create {{name}} --org com.{{bundle}}`
77
- 2. Update `pubspec.yaml`
78
- 3. `flutter pub get`
79
- 4. Run code generation: `dart run build_runner build`
80
- 5. `flutter run`
81
-
82
- ---
83
-
84
- ## Best Practices
85
-
86
- - Feature-first folder structure
87
- - Riverpod for state, React Query pattern for server state
88
- - Freezed for immutable data classes
89
- - Go Router for declarative navigation
90
- - Material 3 theming