@mrtrinhvn/ag-kit 1.0.11 → 1.1.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 (219) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +1 -0
  3. package/bin/cli.js +62 -0
  4. package/package.json +7 -1
  5. package/template/.agent/rules/GEMINI.md +1 -1
  6. package/template/.agent/skills/regent-orchestrator/SKILL.md +31 -0
  7. package/template/.agent/skills/telegram-bridge/SKILL.md +30 -0
  8. package/.agent/.shared/ui-ux-pro-max/data/charts.csv +0 -26
  9. package/.agent/.shared/ui-ux-pro-max/data/colors.csv +0 -97
  10. package/.agent/.shared/ui-ux-pro-max/data/icons.csv +0 -101
  11. package/.agent/.shared/ui-ux-pro-max/data/landing.csv +0 -31
  12. package/.agent/.shared/ui-ux-pro-max/data/products.csv +0 -97
  13. package/.agent/.shared/ui-ux-pro-max/data/prompts.csv +0 -24
  14. package/.agent/.shared/ui-ux-pro-max/data/react-performance.csv +0 -45
  15. package/.agent/.shared/ui-ux-pro-max/data/stacks/flutter.csv +0 -53
  16. package/.agent/.shared/ui-ux-pro-max/data/stacks/html-tailwind.csv +0 -56
  17. package/.agent/.shared/ui-ux-pro-max/data/stacks/jetpack-compose.csv +0 -53
  18. package/.agent/.shared/ui-ux-pro-max/data/stacks/nextjs.csv +0 -53
  19. package/.agent/.shared/ui-ux-pro-max/data/stacks/nuxt-ui.csv +0 -51
  20. package/.agent/.shared/ui-ux-pro-max/data/stacks/nuxtjs.csv +0 -59
  21. package/.agent/.shared/ui-ux-pro-max/data/stacks/react-native.csv +0 -52
  22. package/.agent/.shared/ui-ux-pro-max/data/stacks/react.csv +0 -54
  23. package/.agent/.shared/ui-ux-pro-max/data/stacks/shadcn.csv +0 -61
  24. package/.agent/.shared/ui-ux-pro-max/data/stacks/svelte.csv +0 -54
  25. package/.agent/.shared/ui-ux-pro-max/data/stacks/swiftui.csv +0 -51
  26. package/.agent/.shared/ui-ux-pro-max/data/stacks/vue.csv +0 -50
  27. package/.agent/.shared/ui-ux-pro-max/data/styles.csv +0 -59
  28. package/.agent/.shared/ui-ux-pro-max/data/typography.csv +0 -58
  29. package/.agent/.shared/ui-ux-pro-max/data/ui-reasoning.csv +0 -101
  30. package/.agent/.shared/ui-ux-pro-max/data/ux-guidelines.csv +0 -100
  31. package/.agent/.shared/ui-ux-pro-max/data/web-interface.csv +0 -31
  32. package/.agent/.shared/ui-ux-pro-max/scripts/__pycache__/core.cpython-313.pyc +0 -0
  33. package/.agent/.shared/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-313.pyc +0 -0
  34. package/.agent/.shared/ui-ux-pro-max/scripts/core.py +0 -258
  35. package/.agent/.shared/ui-ux-pro-max/scripts/design_system.py +0 -1067
  36. package/.agent/.shared/ui-ux-pro-max/scripts/search.py +0 -106
  37. package/.agent/ARCHITECTURE.md +0 -288
  38. package/.agent/agents/backend-specialist.md +0 -263
  39. package/.agent/agents/code-archaeologist.md +0 -106
  40. package/.agent/agents/database-architect.md +0 -226
  41. package/.agent/agents/debugger.md +0 -225
  42. package/.agent/agents/devops-engineer.md +0 -242
  43. package/.agent/agents/documentation-writer.md +0 -104
  44. package/.agent/agents/explorer-agent.md +0 -73
  45. package/.agent/agents/frontend-specialist.md +0 -556
  46. package/.agent/agents/game-developer.md +0 -162
  47. package/.agent/agents/mobile-developer.md +0 -377
  48. package/.agent/agents/orchestrator.md +0 -416
  49. package/.agent/agents/penetration-tester.md +0 -188
  50. package/.agent/agents/performance-optimizer.md +0 -187
  51. package/.agent/agents/product-manager.md +0 -112
  52. package/.agent/agents/product-owner.md +0 -95
  53. package/.agent/agents/project-planner.md +0 -406
  54. package/.agent/agents/qa-automation-engineer.md +0 -103
  55. package/.agent/agents/quant-architect.md +0 -31
  56. package/.agent/agents/security-auditor.md +0 -170
  57. package/.agent/agents/seo-specialist.md +0 -111
  58. package/.agent/agents/test-engineer.md +0 -158
  59. package/.agent/mcp_config.json +0 -24
  60. package/.agent/rules/GEMINI.md +0 -280
  61. package/.agent/scripts/auto_preview.py +0 -148
  62. package/.agent/scripts/checklist.py +0 -217
  63. package/.agent/scripts/session_manager.py +0 -120
  64. package/.agent/scripts/verify_all.py +0 -327
  65. package/.agent/skills/api-patterns/SKILL.md +0 -81
  66. package/.agent/skills/api-patterns/api-style.md +0 -42
  67. package/.agent/skills/api-patterns/auth.md +0 -24
  68. package/.agent/skills/api-patterns/documentation.md +0 -26
  69. package/.agent/skills/api-patterns/graphql.md +0 -41
  70. package/.agent/skills/api-patterns/rate-limiting.md +0 -31
  71. package/.agent/skills/api-patterns/response.md +0 -37
  72. package/.agent/skills/api-patterns/rest.md +0 -40
  73. package/.agent/skills/api-patterns/scripts/api_validator.py +0 -211
  74. package/.agent/skills/api-patterns/security-testing.md +0 -122
  75. package/.agent/skills/api-patterns/trpc.md +0 -41
  76. package/.agent/skills/api-patterns/versioning.md +0 -22
  77. package/.agent/skills/app-builder/SKILL.md +0 -75
  78. package/.agent/skills/app-builder/agent-coordination.md +0 -71
  79. package/.agent/skills/app-builder/feature-building.md +0 -53
  80. package/.agent/skills/app-builder/project-detection.md +0 -34
  81. package/.agent/skills/app-builder/scaffolding.md +0 -118
  82. package/.agent/skills/app-builder/tech-stack.md +0 -40
  83. package/.agent/skills/app-builder/templates/SKILL.md +0 -39
  84. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +0 -76
  85. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +0 -92
  86. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +0 -88
  87. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +0 -88
  88. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +0 -83
  89. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +0 -90
  90. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +0 -90
  91. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +0 -82
  92. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +0 -100
  93. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +0 -106
  94. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +0 -101
  95. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +0 -83
  96. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +0 -93
  97. package/.agent/skills/architecture/SKILL.md +0 -55
  98. package/.agent/skills/architecture/context-discovery.md +0 -43
  99. package/.agent/skills/architecture/examples.md +0 -94
  100. package/.agent/skills/architecture/pattern-selection.md +0 -68
  101. package/.agent/skills/architecture/patterns-reference.md +0 -50
  102. package/.agent/skills/architecture/trade-off-analysis.md +0 -77
  103. package/.agent/skills/bash-linux/SKILL.md +0 -199
  104. package/.agent/skills/behavioral-modes/SKILL.md +0 -242
  105. package/.agent/skills/brainstorming/SKILL.md +0 -168
  106. package/.agent/skills/brainstorming/dynamic-questioning.md +0 -350
  107. package/.agent/skills/business-ops/SKILL.md +0 -26
  108. package/.agent/skills/clean-code/SKILL.md +0 -202
  109. package/.agent/skills/cli-generator/SKILL.md +0 -48
  110. package/.agent/skills/code-review-checklist/SKILL.md +0 -109
  111. package/.agent/skills/cognitive-session/SKILL.md +0 -28
  112. package/.agent/skills/data-science/SKILL.md +0 -28
  113. package/.agent/skills/database-design/SKILL.md +0 -52
  114. package/.agent/skills/database-design/database-selection.md +0 -43
  115. package/.agent/skills/database-design/indexing.md +0 -39
  116. package/.agent/skills/database-design/migrations.md +0 -48
  117. package/.agent/skills/database-design/optimization.md +0 -36
  118. package/.agent/skills/database-design/orm-selection.md +0 -30
  119. package/.agent/skills/database-design/schema-design.md +0 -56
  120. package/.agent/skills/database-design/scripts/schema_validator.py +0 -172
  121. package/.agent/skills/deployment-procedures/SKILL.md +0 -241
  122. package/.agent/skills/doc.md +0 -177
  123. package/.agent/skills/documentation-templates/SKILL.md +0 -194
  124. package/.agent/skills/frontend-design/SKILL.md +0 -418
  125. package/.agent/skills/frontend-design/animation-guide.md +0 -331
  126. package/.agent/skills/frontend-design/color-system.md +0 -311
  127. package/.agent/skills/frontend-design/decision-trees.md +0 -418
  128. package/.agent/skills/frontend-design/motion-graphics.md +0 -306
  129. package/.agent/skills/frontend-design/scripts/accessibility_checker.py +0 -183
  130. package/.agent/skills/frontend-design/scripts/ux_audit.py +0 -722
  131. package/.agent/skills/frontend-design/typography-system.md +0 -345
  132. package/.agent/skills/frontend-design/ux-psychology.md +0 -541
  133. package/.agent/skills/frontend-design/visual-effects.md +0 -383
  134. package/.agent/skills/game-development/2d-games/SKILL.md +0 -119
  135. package/.agent/skills/game-development/3d-games/SKILL.md +0 -135
  136. package/.agent/skills/game-development/SKILL.md +0 -167
  137. package/.agent/skills/game-development/game-art/SKILL.md +0 -185
  138. package/.agent/skills/game-development/game-audio/SKILL.md +0 -190
  139. package/.agent/skills/game-development/game-design/SKILL.md +0 -129
  140. package/.agent/skills/game-development/mobile-games/SKILL.md +0 -108
  141. package/.agent/skills/game-development/multiplayer/SKILL.md +0 -132
  142. package/.agent/skills/game-development/pc-games/SKILL.md +0 -144
  143. package/.agent/skills/game-development/vr-ar/SKILL.md +0 -123
  144. package/.agent/skills/game-development/web-games/SKILL.md +0 -150
  145. package/.agent/skills/geo-fundamentals/SKILL.md +0 -156
  146. package/.agent/skills/geo-fundamentals/scripts/geo_checker.py +0 -289
  147. package/.agent/skills/i18n-localization/SKILL.md +0 -154
  148. package/.agent/skills/i18n-localization/scripts/i18n_checker.py +0 -241
  149. package/.agent/skills/intelligent-routing/SKILL.md +0 -335
  150. package/.agent/skills/knowledge-management/SKILL.md +0 -66
  151. package/.agent/skills/lint-and-validate/SKILL.md +0 -45
  152. package/.agent/skills/lint-and-validate/scripts/lint_runner.py +0 -172
  153. package/.agent/skills/lint-and-validate/scripts/type_coverage.py +0 -173
  154. package/.agent/skills/llm-routing-quirks/SKILL.md +0 -41
  155. package/.agent/skills/mcp-builder/SKILL.md +0 -176
  156. package/.agent/skills/memory-architecture/SKILL.md +0 -107
  157. package/.agent/skills/mini-antigravity-injection/SKILL.md +0 -66
  158. package/.agent/skills/mobile-design/SKILL.md +0 -394
  159. package/.agent/skills/mobile-design/decision-trees.md +0 -516
  160. package/.agent/skills/mobile-design/mobile-backend.md +0 -491
  161. package/.agent/skills/mobile-design/mobile-color-system.md +0 -420
  162. package/.agent/skills/mobile-design/mobile-debugging.md +0 -122
  163. package/.agent/skills/mobile-design/mobile-design-thinking.md +0 -357
  164. package/.agent/skills/mobile-design/mobile-navigation.md +0 -458
  165. package/.agent/skills/mobile-design/mobile-performance.md +0 -767
  166. package/.agent/skills/mobile-design/mobile-testing.md +0 -356
  167. package/.agent/skills/mobile-design/mobile-typography.md +0 -433
  168. package/.agent/skills/mobile-design/platform-android.md +0 -666
  169. package/.agent/skills/mobile-design/platform-ios.md +0 -561
  170. package/.agent/skills/mobile-design/scripts/mobile_audit.py +0 -670
  171. package/.agent/skills/mobile-design/touch-psychology.md +0 -537
  172. package/.agent/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +0 -312
  173. package/.agent/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +0 -240
  174. package/.agent/skills/nextjs-react-expert/3-server-server-side-performance.md +0 -490
  175. package/.agent/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +0 -264
  176. package/.agent/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +0 -581
  177. package/.agent/skills/nextjs-react-expert/6-rendering-rendering-performance.md +0 -432
  178. package/.agent/skills/nextjs-react-expert/7-js-javascript-performance.md +0 -684
  179. package/.agent/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +0 -150
  180. package/.agent/skills/nextjs-react-expert/9-cache-components.md +0 -103
  181. package/.agent/skills/nextjs-react-expert/SKILL.md +0 -267
  182. package/.agent/skills/nextjs-react-expert/scripts/convert_rules.py +0 -222
  183. package/.agent/skills/nextjs-react-expert/scripts/react_performance_checker.py +0 -252
  184. package/.agent/skills/nodejs-best-practices/SKILL.md +0 -333
  185. package/.agent/skills/parallel-agents/SKILL.md +0 -175
  186. package/.agent/skills/performance-profiling/SKILL.md +0 -143
  187. package/.agent/skills/performance-profiling/scripts/lighthouse_audit.py +0 -76
  188. package/.agent/skills/plan-writing/SKILL.md +0 -153
  189. package/.agent/skills/powershell-windows/SKILL.md +0 -167
  190. package/.agent/skills/product-management/SKILL.md +0 -30
  191. package/.agent/skills/python-patterns/SKILL.md +0 -441
  192. package/.agent/skills/red-team-tactics/SKILL.md +0 -199
  193. package/.agent/skills/rust-pro/SKILL.md +0 -176
  194. package/.agent/skills/seo-fundamentals/SKILL.md +0 -129
  195. package/.agent/skills/seo-fundamentals/scripts/seo_checker.py +0 -219
  196. package/.agent/skills/server-management/SKILL.md +0 -161
  197. package/.agent/skills/systematic-debugging/SKILL.md +0 -120
  198. package/.agent/skills/tailwind-patterns/SKILL.md +0 -269
  199. package/.agent/skills/tdd-workflow/SKILL.md +0 -148
  200. package/.agent/skills/telegram-agentic-gateway/SKILL.md +0 -80
  201. package/.agent/skills/testing-patterns/SKILL.md +0 -178
  202. package/.agent/skills/testing-patterns/scripts/test_runner.py +0 -219
  203. package/.agent/skills/vulnerability-scanner/SKILL.md +0 -276
  204. package/.agent/skills/vulnerability-scanner/checklists.md +0 -121
  205. package/.agent/skills/vulnerability-scanner/scripts/security_scan.py +0 -458
  206. package/.agent/skills/web-design-guidelines/SKILL.md +0 -57
  207. package/.agent/skills/webapp-testing/SKILL.md +0 -187
  208. package/.agent/skills/webapp-testing/scripts/playwright_runner.py +0 -173
  209. package/.agent/workflows/brainstorm.md +0 -113
  210. package/.agent/workflows/create.md +0 -59
  211. package/.agent/workflows/debug.md +0 -103
  212. package/.agent/workflows/deploy.md +0 -176
  213. package/.agent/workflows/enhance.md +0 -63
  214. package/.agent/workflows/orchestrate.md +0 -237
  215. package/.agent/workflows/plan.md +0 -89
  216. package/.agent/workflows/preview.md +0 -81
  217. package/.agent/workflows/status.md +0 -86
  218. package/.agent/workflows/test.md +0 -144
  219. package/.agent/workflows/ui-ux-pro-max.md +0 -296
@@ -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
@@ -1,90 +0,0 @@
1
- ---
2
- name: monorepo-turborepo
3
- description: Turborepo monorepo template principles. pnpm workspaces, shared packages.
4
- ---
5
-
6
- # Turborepo Monorepo Template
7
-
8
- ## Tech Stack
9
-
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Build System | Turborepo |
13
- | Package Manager | pnpm |
14
- | Apps | Next.js, Express |
15
- | Packages | Shared UI, Config, Types |
16
- | Language | TypeScript |
17
-
18
- ---
19
-
20
- ## Directory Structure
21
-
22
- ```
23
- project-name/
24
- ├── apps/
25
- │ ├── web/ # Next.js app
26
- │ ├── api/ # Express API
27
- │ └── docs/ # Documentation
28
- ├── packages/
29
- │ ├── ui/ # Shared components
30
- │ ├── config/ # ESLint, TS, Tailwind
31
- │ ├── types/ # Shared types
32
- │ └── utils/ # Shared utilities
33
- ├── turbo.json
34
- ├── pnpm-workspace.yaml
35
- └── package.json
36
- ```
37
-
38
- ---
39
-
40
- ## Key Concepts
41
-
42
- | Concept | Description |
43
- |---------|-------------|
44
- | Workspaces | pnpm-workspace.yaml |
45
- | Pipeline | turbo.json task graph |
46
- | Caching | Remote/local task caching |
47
- | Dependencies | `workspace:*` protocol |
48
-
49
- ---
50
-
51
- ## Turbo Pipeline
52
-
53
- | Task | Depends On |
54
- |------|------------|
55
- | build | ^build (dependencies first) |
56
- | dev | cache: false, persistent |
57
- | lint | ^build |
58
- | test | ^build |
59
-
60
- ---
61
-
62
- ## Setup Steps
63
-
64
- 1. Create root directory
65
- 2. `pnpm init`
66
- 3. Create pnpm-workspace.yaml
67
- 4. Create turbo.json
68
- 5. Add apps and packages
69
- 6. `pnpm install`
70
- 7. `pnpm dev`
71
-
72
- ---
73
-
74
- ## Common Commands
75
-
76
- | Command | Description |
77
- |---------|-------------|
78
- | `pnpm dev` | Run all apps |
79
- | `pnpm build` | Build all |
80
- | `pnpm --filter @name/web dev` | Run specific app |
81
- | `pnpm --filter @name/web add axios` | Add dep to app |
82
-
83
- ---
84
-
85
- ## Best Practices
86
-
87
- - Shared configs in packages/config
88
- - Shared types in packages/types
89
- - Internal packages with `workspace:*`
90
- - Use Turbo remote caching for CI
@@ -1,82 +0,0 @@
1
- ---
2
- name: nextjs-fullstack
3
- description: Next.js full-stack template principles. App Router, Prisma, Tailwind.
4
- ---
5
-
6
- # Next.js Full-Stack Template
7
-
8
- ## Tech Stack
9
-
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Framework | Next.js 14 (App Router) |
13
- | Language | TypeScript |
14
- | Database | PostgreSQL + Prisma |
15
- | Styling | Tailwind CSS |
16
- | Auth | Clerk (optional) |
17
- | Validation | Zod |
18
-
19
- ---
20
-
21
- ## Directory Structure
22
-
23
- ```
24
- project-name/
25
- ├── prisma/
26
- │ └── schema.prisma
27
- ├── src/
28
- │ ├── app/
29
- │ │ ├── layout.tsx
30
- │ │ ├── page.tsx
31
- │ │ ├── globals.css
32
- │ │ └── api/
33
- │ ├── components/
34
- │ │ └── ui/
35
- │ ├── lib/
36
- │ │ ├── db.ts # Prisma client
37
- │ │ └── utils.ts
38
- │ └── types/
39
- ├── .env.example
40
- └── package.json
41
- ```
42
-
43
- ---
44
-
45
- ## Key Concepts
46
-
47
- | Concept | Description |
48
- |---------|-------------|
49
- | Server Components | Default, fetch data |
50
- | Server Actions | Form mutations |
51
- | Route Handlers | API endpoints |
52
- | Prisma | Type-safe ORM |
53
-
54
- ---
55
-
56
- ## Environment Variables
57
-
58
- | Variable | Purpose |
59
- |----------|---------|
60
- | DATABASE_URL | Prisma connection |
61
- | NEXT_PUBLIC_APP_URL | Public URL |
62
-
63
- ---
64
-
65
- ## Setup Steps
66
-
67
- 1. `npx create-next-app {{name}} --typescript --tailwind --app`
68
- 2. `npm install prisma @prisma/client zod`
69
- 3. `npx prisma init`
70
- 4. Configure schema
71
- 5. `npm run db:push`
72
- 6. `npm run dev`
73
-
74
- ---
75
-
76
- ## Best Practices
77
-
78
- - Server Components by default
79
- - Server Actions for mutations
80
- - Prisma for type-safe DB
81
- - Zod for validation
82
- - Edge runtime where possible
@@ -1,100 +0,0 @@
1
- ---
2
- name: nextjs-saas
3
- description: Next.js SaaS template principles. Auth, payments, email.
4
- ---
5
-
6
- # Next.js SaaS Template
7
-
8
- ## Tech Stack
9
-
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Framework | Next.js 14 (App Router) |
13
- | Auth | NextAuth.js v5 |
14
- | Payments | Stripe |
15
- | Database | PostgreSQL + Prisma |
16
- | Email | Resend |
17
- | UI | Tailwind (ASK USER: shadcn/Headless UI/Custom?) |
18
-
19
- ---
20
-
21
- ## Directory Structure
22
-
23
- ```
24
- project-name/
25
- ├── prisma/
26
- ├── src/
27
- │ ├── app/
28
- │ │ ├── (auth)/ # Login, register
29
- │ │ ├── (dashboard)/ # Protected routes
30
- │ │ ├── (marketing)/ # Landing, pricing
31
- │ │ └── api/
32
- │ │ ├── auth/[...nextauth]/
33
- │ │ └── webhooks/stripe/
34
- │ ├── components/
35
- │ │ ├── auth/
36
- │ │ ├── billing/
37
- │ │ └── dashboard/
38
- │ ├── lib/
39
- │ │ ├── auth.ts # NextAuth config
40
- │ │ ├── stripe.ts # Stripe client
41
- │ │ └── email.ts # Resend client
42
- │ └── config/
43
- │ └── subscriptions.ts
44
- └── package.json
45
- ```
46
-
47
- ---
48
-
49
- ## SaaS Features
50
-
51
- | Feature | Implementation |
52
- |---------|---------------|
53
- | Auth | NextAuth + OAuth |
54
- | Subscriptions | Stripe Checkout |
55
- | Billing Portal | Stripe Portal |
56
- | Webhooks | Stripe events |
57
- | Email | Transactional via Resend |
58
-
59
- ---
60
-
61
- ## Database Schema
62
-
63
- | Model | Fields |
64
- |-------|--------|
65
- | User | id, email, stripeCustomerId, subscriptionId |
66
- | Account | OAuth provider data |
67
- | Session | User sessions |
68
-
69
- ---
70
-
71
- ## Environment Variables
72
-
73
- | Variable | Purpose |
74
- |----------|---------|
75
- | DATABASE_URL | Prisma |
76
- | NEXTAUTH_SECRET | Auth |
77
- | STRIPE_SECRET_KEY | Payments |
78
- | STRIPE_WEBHOOK_SECRET | Webhooks |
79
- | RESEND_API_KEY | Email |
80
-
81
- ---
82
-
83
- ## Setup Steps
84
-
85
- 1. `npx create-next-app {{name}} --typescript --tailwind --app`
86
- 2. Install: `npm install next-auth @auth/prisma-adapter stripe resend`
87
- 3. Setup Stripe products/prices
88
- 4. Configure environment
89
- 5. `npm run db:push`
90
- 6. `npm run stripe:listen` (webhooks)
91
- 7. `npm run dev`
92
-
93
- ---
94
-
95
- ## Best Practices
96
-
97
- - Route groups for layout separation
98
- - Stripe webhooks for subscription sync
99
- - NextAuth with Prisma adapter
100
- - Email templates with React Email
@@ -1,106 +0,0 @@
1
- ---
2
- name: nextjs-static
3
- description: Next.js static site template principles. Landing pages, portfolios, marketing.
4
- ---
5
-
6
- # Next.js Static Site Template
7
-
8
- ## Tech Stack
9
-
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Framework | Next.js 14 (Static Export) |
13
- | Language | TypeScript |
14
- | Styling | Tailwind CSS |
15
- | Animations | Framer Motion |
16
- | Icons | Lucide React |
17
- | SEO | Next SEO |
18
-
19
- ---
20
-
21
- ## Directory Structure
22
-
23
- ```
24
- project-name/
25
- ├── src/
26
- │ ├── app/
27
- │ │ ├── layout.tsx
28
- │ │ ├── page.tsx # Landing
29
- │ │ ├── about/
30
- │ │ ├── contact/
31
- │ │ └── blog/
32
- │ ├── components/
33
- │ │ ├── layout/ # Header, Footer
34
- │ │ ├── sections/ # Hero, Features, CTA
35
- │ │ └── ui/
36
- │ └── lib/
37
- ├── content/ # Markdown content
38
- ├── public/
39
- └── next.config.js
40
- ```
41
-
42
- ---
43
-
44
- ## Static Export Config
45
-
46
- ```javascript
47
- // next.config.js
48
- const nextConfig = {
49
- output: 'export',
50
- images: { unoptimized: true },
51
- trailingSlash: true,
52
- };
53
- ```
54
-
55
- ---
56
-
57
- ## Landing Page Sections
58
-
59
- | Section | Purpose |
60
- |---------|---------|
61
- | Hero | Main headline, CTA |
62
- | Features | Product benefits |
63
- | Testimonials | Social proof |
64
- | Pricing | Plans |
65
- | CTA | Final conversion |
66
-
67
- ---
68
-
69
- ## Animation Patterns
70
-
71
- | Pattern | Use |
72
- |---------|-----|
73
- | Fade up | Content entry |
74
- | Stagger | List items |
75
- | Scroll reveal | On viewport |
76
- | Hover | Interactive feedback |
77
-
78
- ---
79
-
80
- ## Setup Steps
81
-
82
- 1. `npx create-next-app {{name}} --typescript --tailwind --app`
83
- 2. Install: `npm install framer-motion lucide-react next-seo`
84
- 3. Configure static export
85
- 4. Create sections
86
- 5. `npm run dev`
87
-
88
- ---
89
-
90
- ## Deployment
91
-
92
- | Platform | Method |
93
- |----------|--------|
94
- | Vercel | Auto |
95
- | Netlify | Auto |
96
- | GitHub Pages | gh-pages branch |
97
- | Any host | Upload `out` folder |
98
-
99
- ---
100
-
101
- ## Best Practices
102
-
103
- - Static export for maximum performance
104
- - Framer Motion for premium animations
105
- - Responsive mobile-first design
106
- - SEO metadata on every page
@@ -1,101 +0,0 @@
1
- ---
2
- name: nuxt-app
3
- description: Nuxt 3 full-stack template. Vue 3, Pinia, Tailwind, Prisma.
4
- ---
5
-
6
- # Nuxt 3 Full-Stack Template
7
-
8
- ## Tech Stack
9
-
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Framework | Nuxt 3 |
13
- | Language | TypeScript |
14
- | UI | Vue 3 (Composition API) |
15
- | State | Pinia |
16
- | Database | PostgreSQL + Prisma |
17
- | Styling | Tailwind CSS |
18
- | Validation | Zod |
19
-
20
- ---
21
-
22
- ## Directory Structure
23
-
24
- ```
25
- project-name/
26
- ├── prisma/
27
- │ └── schema.prisma
28
- ├── server/
29
- │ ├── api/
30
- │ │ └── [resource]/
31
- │ │ └── index.ts
32
- │ └── utils/
33
- │ └── db.ts # Prisma client
34
- ├── composables/
35
- │ └── useAuth.ts
36
- ├── stores/
37
- │ └── user.ts # Pinia store
38
- ├── components/
39
- │ └── ui/
40
- ├── pages/
41
- │ ├── index.vue
42
- │ └── [...slug].vue
43
- ├── layouts/
44
- │ └── default.vue
45
- ├── assets/
46
- │ └── css/
47
- │ └── main.css
48
- ├── .env.example
49
- ├── nuxt.config.ts
50
- └── package.json
51
- ```
52
-
53
- ---
54
-
55
- ## Key Concepts
56
-
57
- | Concept | Description |
58
- |---------|-------------|
59
- | Auto-imports | Components, composables, utils |
60
- | File-based routing | pages/ → routes |
61
- | Server Routes | server/api/ → API endpoints |
62
- | Composables | Reusable reactive logic |
63
- | Pinia | State management |
64
-
65
- ---
66
-
67
- ## Environment Variables
68
-
69
- | Variable | Purpose |
70
- |----------|---------|
71
- | DATABASE_URL | Prisma connection |
72
- | NUXT_PUBLIC_APP_URL | Public URL |
73
-
74
- ---
75
-
76
- ## Setup Steps
77
-
78
- 1. `npx nuxi@latest init {{name}}`
79
- 2. `cd {{name}}`
80
- 3. `npm install @pinia/nuxt @prisma/client prisma zod`
81
- 4. `npm install -D @nuxtjs/tailwindcss`
82
- 5. Add modules to `nuxt.config.ts`:
83
- ```ts
84
- modules: ['@pinia/nuxt', '@nuxtjs/tailwindcss']
85
- ```
86
- 6. `npx prisma init`
87
- 7. Configure schema
88
- 8. `npx prisma db push`
89
- 9. `npm run dev`
90
-
91
- ---
92
-
93
- ## Best Practices
94
-
95
- - Use `<script setup>` for components
96
- - Composables for reusable logic
97
- - Pinia stores in `stores/` folder
98
- - Server routes for API logic
99
- - Auto-import for clean code
100
- - TypeScript for type safety
101
- - See `@[skills/vue-expert]` for Vue patterns
@@ -1,83 +0,0 @@
1
- ---
2
- name: python-fastapi
3
- description: FastAPI REST API template principles. SQLAlchemy, Pydantic, Alembic.
4
- ---
5
-
6
- # FastAPI API Template
7
-
8
- ## Tech Stack
9
-
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Framework | FastAPI |
13
- | Language | Python 3.11+ |
14
- | ORM | SQLAlchemy 2.0 |
15
- | Validation | Pydantic v2 |
16
- | Migrations | Alembic |
17
- | Auth | JWT + passlib |
18
-
19
- ---
20
-
21
- ## Directory Structure
22
-
23
- ```
24
- project-name/
25
- ├── alembic/ # Migrations
26
- ├── app/
27
- │ ├── main.py # FastAPI app
28
- │ ├── config.py # Settings
29
- │ ├── database.py # DB connection
30
- │ ├── models/ # SQLAlchemy models
31
- │ ├── schemas/ # Pydantic schemas
32
- │ ├── routers/ # API routes
33
- │ ├── services/ # Business logic
34
- │ ├── dependencies/ # DI
35
- │ └── utils/
36
- ├── tests/
37
- ├── .env.example
38
- └── requirements.txt
39
- ```
40
-
41
- ---
42
-
43
- ## Key Concepts
44
-
45
- | Concept | Description |
46
- |---------|-------------|
47
- | Async | async/await throughout |
48
- | Dependency Injection | FastAPI Depends |
49
- | Pydantic v2 | Validation + serialization |
50
- | SQLAlchemy 2.0 | Async sessions |
51
-
52
- ---
53
-
54
- ## API Structure
55
-
56
- | Layer | Responsibility |
57
- |-------|---------------|
58
- | Routers | HTTP handling |
59
- | Dependencies | Auth, validation |
60
- | Services | Business logic |
61
- | Models | Database entities |
62
- | Schemas | Request/response |
63
-
64
- ---
65
-
66
- ## Setup Steps
67
-
68
- 1. `python -m venv venv`
69
- 2. `source venv/bin/activate`
70
- 3. `pip install fastapi uvicorn sqlalchemy alembic pydantic`
71
- 4. Create `.env`
72
- 5. `alembic upgrade head`
73
- 6. `uvicorn app.main:app --reload`
74
-
75
- ---
76
-
77
- ## Best Practices
78
-
79
- - Use async everywhere
80
- - Pydantic v2 for validation
81
- - SQLAlchemy 2.0 async sessions
82
- - Alembic for migrations
83
- - pytest-asyncio for tests