tribunal-kit 3.0.0 → 4.0.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 (233) hide show
  1. package/.agent/ARCHITECTURE.md +99 -99
  2. package/.agent/GEMINI.md +52 -52
  3. package/.agent/agents/accessibility-reviewer.md +187 -220
  4. package/.agent/agents/ai-code-reviewer.md +199 -233
  5. package/.agent/agents/backend-specialist.md +215 -238
  6. package/.agent/agents/code-archaeologist.md +161 -181
  7. package/.agent/agents/database-architect.md +184 -207
  8. package/.agent/agents/debugger.md +191 -218
  9. package/.agent/agents/dependency-reviewer.md +103 -136
  10. package/.agent/agents/devops-engineer.md +218 -238
  11. package/.agent/agents/documentation-writer.md +201 -221
  12. package/.agent/agents/explorer-agent.md +160 -180
  13. package/.agent/agents/frontend-reviewer.md +160 -194
  14. package/.agent/agents/frontend-specialist.md +248 -237
  15. package/.agent/agents/game-developer.md +48 -52
  16. package/.agent/agents/logic-reviewer.md +116 -149
  17. package/.agent/agents/mobile-developer.md +200 -223
  18. package/.agent/agents/mobile-reviewer.md +162 -195
  19. package/.agent/agents/orchestrator.md +181 -211
  20. package/.agent/agents/penetration-tester.md +157 -174
  21. package/.agent/agents/performance-optimizer.md +183 -203
  22. package/.agent/agents/performance-reviewer.md +178 -211
  23. package/.agent/agents/precedence-reviewer.md +213 -0
  24. package/.agent/agents/product-manager.md +142 -162
  25. package/.agent/agents/product-owner.md +6 -25
  26. package/.agent/agents/project-planner.md +142 -162
  27. package/.agent/agents/qa-automation-engineer.md +225 -242
  28. package/.agent/agents/security-auditor.md +174 -194
  29. package/.agent/agents/seo-specialist.md +193 -213
  30. package/.agent/agents/sql-reviewer.md +161 -194
  31. package/.agent/agents/supervisor-agent.md +184 -203
  32. package/.agent/agents/swarm-worker-contracts.md +17 -17
  33. package/.agent/agents/swarm-worker-registry.md +46 -46
  34. package/.agent/agents/test-coverage-reviewer.md +160 -193
  35. package/.agent/agents/test-engineer.md +0 -21
  36. package/.agent/agents/type-safety-reviewer.md +175 -208
  37. package/.agent/patterns/generator.md +9 -9
  38. package/.agent/patterns/inversion.md +12 -12
  39. package/.agent/patterns/pipeline.md +9 -9
  40. package/.agent/patterns/reviewer.md +13 -13
  41. package/.agent/patterns/tool-wrapper.md +9 -9
  42. package/.agent/rules/GEMINI.md +63 -63
  43. package/.agent/scripts/append_flow.js +72 -0
  44. package/.agent/scripts/case_law_manager.py +525 -0
  45. package/.agent/scripts/compress_skills.py +167 -0
  46. package/.agent/scripts/consolidate_skills.py +173 -0
  47. package/.agent/scripts/deep_compress.py +202 -0
  48. package/.agent/scripts/minify_context.py +80 -0
  49. package/.agent/scripts/security_scan.py +1 -1
  50. package/.agent/scripts/skill_evolution.py +563 -0
  51. package/.agent/scripts/strip_tribunal.py +41 -0
  52. package/.agent/skills/agent-organizer/SKILL.md +100 -126
  53. package/.agent/skills/agentic-patterns/SKILL.md +0 -70
  54. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +134 -160
  55. package/.agent/skills/api-patterns/SKILL.md +123 -215
  56. package/.agent/skills/api-security-auditor/SKILL.md +143 -177
  57. package/.agent/skills/app-builder/SKILL.md +334 -50
  58. package/.agent/skills/app-builder/templates/SKILL.md +13 -15
  59. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +16 -16
  60. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +22 -22
  61. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +18 -18
  62. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +20 -20
  63. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +17 -17
  64. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +18 -18
  65. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +21 -21
  66. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +19 -19
  67. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +26 -26
  68. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +26 -26
  69. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +19 -19
  70. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +18 -18
  71. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +20 -20
  72. package/.agent/skills/appflow-wireframe/SKILL.md +95 -121
  73. package/.agent/skills/architecture/SKILL.md +169 -331
  74. package/.agent/skills/authentication-best-practices/SKILL.md +139 -173
  75. package/.agent/skills/bash-linux/SKILL.md +129 -154
  76. package/.agent/skills/behavioral-modes/SKILL.md +8 -69
  77. package/.agent/skills/brainstorming/SKILL.md +436 -104
  78. package/.agent/skills/building-native-ui/SKILL.md +152 -174
  79. package/.agent/skills/clean-code/SKILL.md +331 -360
  80. package/.agent/skills/code-review-checklist/SKILL.md +0 -62
  81. package/.agent/skills/config-validator/SKILL.md +115 -141
  82. package/.agent/skills/csharp-developer/SKILL.md +468 -528
  83. package/.agent/skills/database-design/SKILL.md +104 -369
  84. package/.agent/skills/deployment-procedures/SKILL.md +119 -145
  85. package/.agent/skills/devops-engineer/SKILL.md +295 -332
  86. package/.agent/skills/devops-incident-responder/SKILL.md +87 -113
  87. package/.agent/skills/doc.md +5 -5
  88. package/.agent/skills/documentation-templates/SKILL.md +27 -63
  89. package/.agent/skills/edge-computing/SKILL.md +131 -157
  90. package/.agent/skills/extract-design-system/SKILL.md +108 -134
  91. package/.agent/skills/framer-motion-expert/SKILL.md +111 -855
  92. package/.agent/skills/frontend-design/SKILL.md +151 -499
  93. package/.agent/skills/game-design-expert/SKILL.md +79 -105
  94. package/.agent/skills/game-engineering-expert/SKILL.md +96 -122
  95. package/.agent/skills/geo-fundamentals/SKILL.md +97 -124
  96. package/.agent/skills/github-operations/SKILL.md +279 -314
  97. package/.agent/skills/gsap-expert/SKILL.md +119 -826
  98. package/.agent/skills/i18n-localization/SKILL.md +113 -138
  99. package/.agent/skills/intelligent-routing/SKILL.md +167 -127
  100. package/.agent/skills/lint-and-validate/SKILL.md +16 -52
  101. package/.agent/skills/llm-engineering/SKILL.md +344 -357
  102. package/.agent/skills/local-first/SKILL.md +128 -154
  103. package/.agent/skills/mcp-builder/SKILL.md +92 -118
  104. package/.agent/skills/mobile-design/SKILL.md +213 -219
  105. package/.agent/skills/motion-engineering/SKILL.md +184 -0
  106. package/.agent/skills/nextjs-react-expert/SKILL.md +99 -698
  107. package/.agent/skills/nodejs-best-practices/SKILL.md +498 -559
  108. package/.agent/skills/observability/SKILL.md +293 -330
  109. package/.agent/skills/parallel-agents/SKILL.md +96 -122
  110. package/.agent/skills/performance-profiling/SKILL.md +217 -254
  111. package/.agent/skills/plan-writing/SKILL.md +92 -118
  112. package/.agent/skills/platform-engineer/SKILL.md +97 -123
  113. package/.agent/skills/playwright-best-practices/SKILL.md +137 -162
  114. package/.agent/skills/powershell-windows/SKILL.md +112 -146
  115. package/.agent/skills/project-idioms/SKILL.md +87 -0
  116. package/.agent/skills/python-patterns/SKILL.md +15 -35
  117. package/.agent/skills/python-pro/SKILL.md +148 -754
  118. package/.agent/skills/react-specialist/SKILL.md +123 -827
  119. package/.agent/skills/readme-builder/SKILL.md +23 -85
  120. package/.agent/skills/realtime-patterns/SKILL.md +269 -304
  121. package/.agent/skills/red-team-tactics/SKILL.md +18 -51
  122. package/.agent/skills/rust-pro/SKILL.md +623 -701
  123. package/.agent/skills/seo-fundamentals/SKILL.md +129 -154
  124. package/.agent/skills/server-management/SKILL.md +164 -190
  125. package/.agent/skills/shadcn-ui-expert/SKILL.md +181 -206
  126. package/.agent/skills/skill-creator/SKILL.md +24 -56
  127. package/.agent/skills/sql-pro/SKILL.md +579 -633
  128. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +35 -66
  129. package/.agent/skills/swiftui-expert/SKILL.md +151 -176
  130. package/.agent/skills/systematic-debugging/SKILL.md +92 -118
  131. package/.agent/skills/tailwind-patterns/SKILL.md +516 -576
  132. package/.agent/skills/tdd-workflow/SKILL.md +111 -137
  133. package/.agent/skills/test-result-analyzer/SKILL.md +33 -73
  134. package/.agent/skills/testing-patterns/SKILL.md +512 -573
  135. package/.agent/skills/trend-researcher/SKILL.md +30 -71
  136. package/.agent/skills/ui-ux-pro-max/SKILL.md +8 -41
  137. package/.agent/skills/ui-ux-researcher/SKILL.md +51 -91
  138. package/.agent/skills/vue-expert/SKILL.md +127 -866
  139. package/.agent/skills/vulnerability-scanner/SKILL.md +354 -269
  140. package/.agent/skills/web-accessibility-auditor/SKILL.md +168 -193
  141. package/.agent/skills/web-design-guidelines/SKILL.md +25 -61
  142. package/.agent/skills/webapp-testing/SKILL.md +119 -145
  143. package/.agent/skills/whimsy-injector/SKILL.md +58 -132
  144. package/.agent/skills/workflow-optimizer/SKILL.md +28 -68
  145. package/.agent/workflows/api-tester.md +151 -151
  146. package/.agent/workflows/audit.md +127 -138
  147. package/.agent/workflows/brainstorm.md +110 -110
  148. package/.agent/workflows/changelog.md +112 -112
  149. package/.agent/workflows/create.md +124 -124
  150. package/.agent/workflows/debug.md +165 -189
  151. package/.agent/workflows/deploy.md +180 -189
  152. package/.agent/workflows/enhance.md +128 -151
  153. package/.agent/workflows/fix.md +114 -135
  154. package/.agent/workflows/generate.md +13 -4
  155. package/.agent/workflows/migrate.md +160 -160
  156. package/.agent/workflows/orchestrate.md +168 -168
  157. package/.agent/workflows/performance-benchmarker.md +114 -123
  158. package/.agent/workflows/plan.md +173 -173
  159. package/.agent/workflows/preview.md +80 -80
  160. package/.agent/workflows/refactor.md +161 -183
  161. package/.agent/workflows/review-ai.md +101 -129
  162. package/.agent/workflows/review.md +116 -116
  163. package/.agent/workflows/session.md +94 -94
  164. package/.agent/workflows/status.md +79 -79
  165. package/.agent/workflows/strengthen-skills.md +138 -139
  166. package/.agent/workflows/swarm.md +179 -179
  167. package/.agent/workflows/test.md +189 -211
  168. package/.agent/workflows/tribunal-backend.md +94 -113
  169. package/.agent/workflows/tribunal-database.md +95 -115
  170. package/.agent/workflows/tribunal-frontend.md +96 -118
  171. package/.agent/workflows/tribunal-full.md +93 -133
  172. package/.agent/workflows/tribunal-mobile.md +95 -119
  173. package/.agent/workflows/tribunal-performance.md +110 -133
  174. package/.agent/workflows/ui-ux-pro-max.md +122 -143
  175. package/README.md +30 -1
  176. package/bin/tribunal-kit.js +175 -12
  177. package/package.json +25 -4
  178. package/.agent/skills/api-patterns/api-style.md +0 -42
  179. package/.agent/skills/api-patterns/auth.md +0 -24
  180. package/.agent/skills/api-patterns/documentation.md +0 -26
  181. package/.agent/skills/api-patterns/graphql.md +0 -41
  182. package/.agent/skills/api-patterns/rate-limiting.md +0 -31
  183. package/.agent/skills/api-patterns/response.md +0 -37
  184. package/.agent/skills/api-patterns/rest.md +0 -40
  185. package/.agent/skills/api-patterns/security-testing.md +0 -122
  186. package/.agent/skills/api-patterns/trpc.md +0 -41
  187. package/.agent/skills/api-patterns/versioning.md +0 -22
  188. package/.agent/skills/app-builder/agent-coordination.md +0 -71
  189. package/.agent/skills/app-builder/feature-building.md +0 -53
  190. package/.agent/skills/app-builder/project-detection.md +0 -34
  191. package/.agent/skills/app-builder/scaffolding.md +0 -118
  192. package/.agent/skills/app-builder/tech-stack.md +0 -40
  193. package/.agent/skills/architecture/context-discovery.md +0 -43
  194. package/.agent/skills/architecture/examples.md +0 -94
  195. package/.agent/skills/architecture/pattern-selection.md +0 -68
  196. package/.agent/skills/architecture/patterns-reference.md +0 -50
  197. package/.agent/skills/architecture/trade-off-analysis.md +0 -77
  198. package/.agent/skills/brainstorming/dynamic-questioning.md +0 -360
  199. package/.agent/skills/database-design/database-selection.md +0 -43
  200. package/.agent/skills/database-design/indexing.md +0 -39
  201. package/.agent/skills/database-design/migrations.md +0 -48
  202. package/.agent/skills/database-design/optimization.md +0 -36
  203. package/.agent/skills/database-design/orm-selection.md +0 -30
  204. package/.agent/skills/database-design/schema-design.md +0 -56
  205. package/.agent/skills/frontend-design/animation-guide.md +0 -331
  206. package/.agent/skills/frontend-design/color-system.md +0 -329
  207. package/.agent/skills/frontend-design/decision-trees.md +0 -418
  208. package/.agent/skills/frontend-design/motion-graphics.md +0 -306
  209. package/.agent/skills/frontend-design/typography-system.md +0 -363
  210. package/.agent/skills/frontend-design/ux-psychology.md +0 -1116
  211. package/.agent/skills/frontend-design/visual-effects.md +0 -383
  212. package/.agent/skills/intelligent-routing/router-manifest.md +0 -65
  213. package/.agent/skills/mobile-design/decision-trees.md +0 -516
  214. package/.agent/skills/mobile-design/mobile-backend.md +0 -491
  215. package/.agent/skills/mobile-design/mobile-color-system.md +0 -420
  216. package/.agent/skills/mobile-design/mobile-debugging.md +0 -122
  217. package/.agent/skills/mobile-design/mobile-design-thinking.md +0 -357
  218. package/.agent/skills/mobile-design/mobile-navigation.md +0 -458
  219. package/.agent/skills/mobile-design/mobile-performance.md +0 -767
  220. package/.agent/skills/mobile-design/mobile-testing.md +0 -356
  221. package/.agent/skills/mobile-design/mobile-typography.md +0 -433
  222. package/.agent/skills/mobile-design/platform-android.md +0 -666
  223. package/.agent/skills/mobile-design/platform-ios.md +0 -561
  224. package/.agent/skills/mobile-design/touch-psychology.md +0 -537
  225. package/.agent/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +0 -312
  226. package/.agent/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +0 -240
  227. package/.agent/skills/nextjs-react-expert/3-server-server-side-performance.md +0 -490
  228. package/.agent/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +0 -264
  229. package/.agent/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +0 -581
  230. package/.agent/skills/nextjs-react-expert/6-rendering-rendering-performance.md +0 -432
  231. package/.agent/skills/nextjs-react-expert/7-js-javascript-performance.md +0 -684
  232. package/.agent/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +0 -150
  233. package/.agent/skills/vulnerability-scanner/checklists.md +0 -121
@@ -7,14 +7,14 @@ description: Electron desktop app template principles. Cross-platform, React, Ty
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology |
10
+ |Component|Technology|
11
11
  |-----------|------------|
12
- | Framework | Electron 28+ |
13
- | UI | React 19 |
14
- | Language | TypeScript |
15
- | Styling | Tailwind CSS |
16
- | Bundler | Vite + electron-builder |
17
- | IPC | Type-safe communication |
12
+ |Framework|Electron 28+|
13
+ |UI|React 19|
14
+ |Language|TypeScript|
15
+ |Styling|Tailwind CSS|
16
+ |Bundler|Vite + electron-builder|
17
+ |IPC|Type-safe communication|
18
18
 
19
19
  ---
20
20
 
@@ -40,22 +40,22 @@ project-name/
40
40
 
41
41
  ## Process Model
42
42
 
43
- | Process | Role |
43
+ |Process|Role|
44
44
  |---------|------|
45
- | Main | Node.js, system access |
46
- | Renderer | Chromium, React UI |
47
- | Preload | Bridge, context isolation |
45
+ |Main|Node.js, system access|
46
+ |Renderer|Chromium, React UI|
47
+ |Preload|Bridge, context isolation|
48
48
 
49
49
  ---
50
50
 
51
51
  ## Key Concepts
52
52
 
53
- | Concept | Purpose |
53
+ |Concept|Purpose|
54
54
  |---------|---------|
55
- | contextBridge | Safe API exposure |
56
- | ipcMain/ipcRenderer | Process communication |
57
- | nodeIntegration: false | Security |
58
- | contextIsolation: true | Security |
55
+ |contextBridge|Safe API exposure|
56
+ |ipcMain/ipcRenderer|Process communication|
57
+ |nodeIntegration: false|Security|
58
+ |contextIsolation: true|Security|
59
59
 
60
60
  ---
61
61
 
@@ -71,11 +71,11 @@ project-name/
71
71
 
72
72
  ## Build Targets
73
73
 
74
- | Platform | Output |
74
+ |Platform|Output|
75
75
  |----------|--------|
76
- | Windows | NSIS, Portable |
77
- | macOS | DMG, ZIP |
78
- | Linux | AppImage, DEB |
76
+ |Windows|NSIS, Portable|
77
+ |macOS|DMG, ZIP|
78
+ |Linux|AppImage, DEB|
79
79
 
80
80
  ---
81
81
 
@@ -7,14 +7,14 @@ description: Express.js REST API template principles. TypeScript, Prisma, JWT.
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology |
10
+ |Component|Technology|
11
11
  |-----------|------------|
12
- | Runtime | Node.js 20+ |
13
- | Framework | Express.js |
14
- | Language | TypeScript |
15
- | Database | PostgreSQL + Prisma |
16
- | Validation | Zod |
17
- | Auth | JWT + bcrypt |
12
+ |Runtime|Node.js 20+|
13
+ |Framework|Express.js|
14
+ |Language|TypeScript|
15
+ |Database|PostgreSQL + Prisma|
16
+ |Validation|Zod|
17
+ |Auth|JWT + bcrypt|
18
18
 
19
19
  ---
20
20
 
@@ -43,23 +43,23 @@ project-name/
43
43
 
44
44
  ## Middleware Stack
45
45
 
46
- | Order | Middleware |
46
+ |Order|Middleware|
47
47
  |-------|------------|
48
- | 1 | helmet (security) |
49
- | 2 | cors |
50
- | 3 | morgan (logging) |
51
- | 4 | body parsing |
52
- | 5 | routes |
53
- | 6 | error handler |
48
+ |1|helmet (security)|
49
+ |2|cors|
50
+ |3|morgan (logging)|
51
+ |4|body parsing|
52
+ |5|routes|
53
+ |6|error handler|
54
54
 
55
55
  ---
56
56
 
57
57
  ## API Response Format
58
58
 
59
- | Type | Structure |
59
+ |Type|Structure|
60
60
  |------|-----------|
61
- | Success | `{ success: true, data: {...} }` |
62
- | Error | `{ error: "message", details: [...] }` |
61
+ |Success|`{ success: true, data: {...} }`|
62
+ |Error|`{ error: "message", details: [...] }`|
63
63
 
64
64
  ---
65
65
 
@@ -7,14 +7,14 @@ description: Flutter mobile app template principles. Riverpod, Go Router, clean
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology |
10
+ |Component|Technology|
11
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 |
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
18
 
19
19
  ---
20
20
 
@@ -50,24 +50,24 @@ project_name/
50
50
 
51
51
  ## Architecture Layers
52
52
 
53
- | Layer | Contents |
53
+ |Layer|Contents|
54
54
  |-------|----------|
55
- | Presentation | Screens, Widgets, Providers |
56
- | Domain | Entities, Use Cases |
57
- | Data | Repositories, Models |
55
+ |Presentation|Screens, Widgets, Providers|
56
+ |Domain|Entities, Use Cases|
57
+ |Data|Repositories, Models|
58
58
 
59
59
  ---
60
60
 
61
61
  ## Key Packages
62
62
 
63
- | Package | Purpose |
63
+ |Package|Purpose|
64
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 |
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
71
 
72
72
  ---
73
73
 
@@ -7,13 +7,13 @@ description: Turborepo monorepo template principles. pnpm workspaces, shared pac
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology |
10
+ |Component|Technology|
11
11
  |-----------|------------|
12
- | Build System | Turborepo |
13
- | Package Manager | pnpm |
14
- | Apps | Next.js, Express |
15
- | Packages | Shared UI, Config, Types |
16
- | Language | TypeScript |
12
+ |Build System|Turborepo|
13
+ |Package Manager|pnpm|
14
+ |Apps|Next.js, Express|
15
+ |Packages|Shared UI, Config, Types|
16
+ |Language|TypeScript|
17
17
 
18
18
  ---
19
19
 
@@ -39,23 +39,23 @@ project-name/
39
39
 
40
40
  ## Key Concepts
41
41
 
42
- | Concept | Description |
42
+ |Concept|Description|
43
43
  |---------|-------------|
44
- | Workspaces | pnpm-workspace.yaml |
45
- | Pipeline | turbo.json task graph |
46
- | Caching | Remote/local task caching |
47
- | Dependencies | `workspace:*` protocol |
44
+ |Workspaces|pnpm-workspace.yaml|
45
+ |Pipeline|turbo.json task graph|
46
+ |Caching|Remote/local task caching|
47
+ |Dependencies|`workspace:*` protocol|
48
48
 
49
49
  ---
50
50
 
51
51
  ## Turbo Pipeline
52
52
 
53
- | Task | Depends On |
53
+ |Task|Depends On|
54
54
  |------|------------|
55
- | build | ^build (dependencies first) |
56
- | dev | cache: false, persistent |
57
- | lint | ^build |
58
- | test | ^build |
55
+ |build|^build (dependencies first)|
56
+ |dev|cache: false, persistent|
57
+ |lint|^build|
58
+ |test|^build|
59
59
 
60
60
  ---
61
61
 
@@ -73,12 +73,12 @@ project-name/
73
73
 
74
74
  ## Common Commands
75
75
 
76
- | Command | Description |
76
+ |Command|Description|
77
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 |
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
82
 
83
83
  ---
84
84
 
@@ -7,15 +7,15 @@ description: Next.js full-stack template principles. App Router, Prisma, Tailwin
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology | Version / Notes |
10
+ |Component|Technology|Version / Notes|
11
11
  |-----------|------------|-----------------|
12
- | Framework | Next.js | v16+ (App Router, Turbopack) |
13
- | Language | TypeScript | v5+ (Strict Mode) |
14
- | Database | PostgreSQL | Prisma ORM (Serverless friendly) |
15
- | Styling | Tailwind CSS | v4.0 (Zero-config, CSS-first) |
16
- | Auth | Clerk / Better Auth | Middleware Protected Routes |
17
- | UI Logic | React 19 | Server Actions, useActionState |
18
- | Validation | Zod | Schema validation (API & Forms) |
12
+ |Framework|Next.js|v16+ (App Router, Turbopack)|
13
+ |Language|TypeScript|v5+ (Strict Mode)|
14
+ |Database|PostgreSQL|Prisma ORM (Serverless friendly)|
15
+ |Styling|Tailwind CSS|v4.0 (Zero-config, CSS-first)|
16
+ |Auth|Clerk / Better Auth|Middleware Protected Routes|
17
+ |UI Logic|React 19|Server Actions, useActionState|
18
+ |Validation|Zod|Schema validation (API & Forms)|
19
19
 
20
20
  ---
21
21
 
@@ -51,24 +51,24 @@ project-name/
51
51
 
52
52
  ## Key Concepts (Updated)
53
53
 
54
- | Concept | Description |
54
+ |Concept|Description|
55
55
  |---------|-------------|
56
- | Server Components | Render on server (default). Direct DB access (Prisma) without APIs. |
57
- | Server Actions | Handle Form mutations. Replaces traditional API Routes. Use in action={}. |
58
- | React 19 Hooks | Form state management: useActionState, useFormStatus, useOptimistic. |
59
- | Data Access Layer | Data security. Separation of DB logic (DTOs) for safe reuse. |
60
- | Tailwind v4 | Styling engine. No tailwind.config.js. Config directly in CSS. |
56
+ |Server Components|Render on server (default). Direct DB access (Prisma) without APIs.|
57
+ |Server Actions|Handle Form mutations. Replaces traditional API Routes. Use in action={}.|
58
+ |React 19 Hooks|Form state management: useActionState, useFormStatus, useOptimistic.|
59
+ |Data Access Layer|Data security. Separation of DB logic (DTOs) for safe reuse.|
60
+ |Tailwind v4|Styling engine. No tailwind.config.js. Config directly in CSS.|
61
61
 
62
62
  ---
63
63
 
64
64
  ## Environment Variables
65
65
 
66
- | Variable | Purpose |
66
+ |Variable|Purpose|
67
67
  |----------|---------|
68
- | DATABASE_URL | PostgreSQL connection string (Prisma) |
69
- | NEXT_PUBLIC_APP_URL | Public application URL |
70
- | NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY | Auth (if using Clerk) |
71
- | CLERK_SECRET_KEY | Auth Secret (Server only) |
68
+ |DATABASE_URL|PostgreSQL connection string (Prisma)|
69
+ |NEXT_PUBLIC_APP_URL|Public application URL|
70
+ |NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY|Auth (if using Clerk)|
71
+ |CLERK_SECRET_KEY|Auth Secret (Server only)|
72
72
 
73
73
  ---
74
74
 
@@ -7,15 +7,15 @@ description: Next.js SaaS template principles (2026 Standards). React 19, Server
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology | Version / Notes |
10
+ |Component|Technology|Version / Notes|
11
11
  |-----------|------------|-----------------|
12
- | Framework | Next.js | v16+ (App Router, React Compiler) |
13
- | Runtime | Node.js | v24 (Krypton LTS) |
14
- | Auth | Auth.js | v6 (formerly NextAuth) |
15
- | Payments | Stripe API | Latest |
16
- | Database | PostgreSQL | Prisma v6 (Serverless Driver) |
17
- | Email | Resend | React Email |
18
- | UI | Tailwind CSS | v4 (Oxide Engine, no config file) |
12
+ |Framework|Next.js|v16+ (App Router, React Compiler)|
13
+ |Runtime|Node.js|v24 (Krypton LTS)|
14
+ |Auth|Auth.js|v6 (formerly NextAuth)|
15
+ |Payments|Stripe API|Latest|
16
+ |Database|PostgreSQL|Prisma v6 (Serverless Driver)|
17
+ |Email|Resend|React Email|
18
+ |UI|Tailwind CSS|v4 (Oxide Engine, no config file)|
19
19
 
20
20
  ---
21
21
 
@@ -53,37 +53,37 @@ project-name/
53
53
 
54
54
  ## SaaS Features
55
55
 
56
- | Feature | Implementation |
56
+ |Feature|Implementation|
57
57
  |---------|---------------|
58
- | Auth | Auth.js v6 + Passkeys + OAuth |
59
- | Data Mutation | Server Actions (No API routes) |
60
- | Subscriptions | Stripe Checkout & Customer Portal |
61
- | Webhooks | Asynchronous Stripe event handling |
62
- | Email | Transactional via Resend |
63
- | Validation | Zod (Server-side validation) |
58
+ |Auth|Auth.js v6 + Passkeys + OAuth|
59
+ |Data Mutation|Server Actions (No API routes)|
60
+ |Subscriptions|Stripe Checkout & Customer Portal|
61
+ |Webhooks|Asynchronous Stripe event handling|
62
+ |Email|Transactional via Resend|
63
+ |Validation|Zod (Server-side validation)|
64
64
 
65
65
  ---
66
66
 
67
67
  ## Database Schema
68
68
 
69
- | Model | Fields (Key fields) |
69
+ |Model|Fields (Key fields)|
70
70
  |-------|---------------------|
71
- | User | id, email, stripeCustomerId, subscriptionId, plan |
72
- | Account | OAuth provider data (Google, GitHub...) |
73
- | Session | User sessions (Database strategy) |
71
+ |User|id, email, stripeCustomerId, subscriptionId, plan|
72
+ |Account|OAuth provider data (Google, GitHub...)|
73
+ |Session|User sessions (Database strategy)|
74
74
 
75
75
  ---
76
76
 
77
77
  ## Environment Variables
78
78
 
79
- | Variable | Purpose |
79
+ |Variable|Purpose|
80
80
  |----------|---------|
81
- | DATABASE_URL | Prisma connection string (Postgres) |
82
- | AUTH_SECRET | Replaces NEXTAUTH_SECRET (Auth.js v6) |
83
- | STRIPE_SECRET_KEY | Payments (Server-side) |
84
- | STRIPE_WEBHOOK_SECRET | Webhook verification |
85
- | RESEND_API_KEY | Email sending |
86
- | NEXT_PUBLIC_APP_URL | Application Canonical URL |
81
+ |DATABASE_URL|Prisma connection string (Postgres)|
82
+ |AUTH_SECRET|Replaces NEXTAUTH_SECRET (Auth.js v6)|
83
+ |STRIPE_SECRET_KEY|Payments (Server-side)|
84
+ |STRIPE_WEBHOOK_SECRET|Webhook verification|
85
+ |RESEND_API_KEY|Email sending|
86
+ |NEXT_PUBLIC_APP_URL|Application Canonical URL|
87
87
 
88
88
  ---
89
89
 
@@ -7,15 +7,15 @@ description: Modern template for Next.js 16, React 19 & Tailwind v4. Optimized f
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology | Notes |
10
+ |Component|Technology|Notes|
11
11
  |-----------|------------|-------|
12
- | Framework | Next.js 16+ | App Router, Turbopack, Static Exports |
13
- | Core | React 19 | Server Components, New Hooks, Compiler |
14
- | Language | TypeScript | Strict Mode |
15
- | Styling | Tailwind CSS v4 | CSS-first configuration (No js config), Oxide Engine |
16
- | Animations | Framer Motion | Layout animations & gestures |
17
- | Icons | Lucide React | Lightweight SVG icons |
18
- | SEO | Metadata API | Native Next.js API (Replaces next-seo) |
12
+ |Framework|Next.js 16+|App Router, Turbopack, Static Exports|
13
+ |Core|React 19|Server Components, New Hooks, Compiler|
14
+ |Language|TypeScript|Strict Mode|
15
+ |Styling|Tailwind CSS v4|CSS-first configuration (No js config), Oxide Engine|
16
+ |Animations|Framer Motion|Layout animations & gestures|
17
+ |Icons|Lucide React|Lightweight SVG icons|
18
+ |SEO|Metadata API|Native Next.js API (Replaces next-seo)|
19
19
 
20
20
  ---
21
21
 
@@ -95,26 +95,26 @@ export const metadata: Metadata = {
95
95
 
96
96
  ## Landing Page Sections
97
97
 
98
- | Section | Purpose | Suggested Component |
98
+ |Section|Purpose|Suggested Component|
99
99
  |---------|---------|---------------------|
100
- | Hero | First impression, H1 & Main CTA | `<HeroSection />` |
101
- | Features | Product benefits (Grid/Bento layout) | `<FeaturesGrid />` |
102
- | Social Proof | Partner logos, User numbers | `<LogoCloud />` |
103
- | Testimonials | Customer reviews | `<TestimonialCarousel />` |
104
- | Pricing | Service plans | `<PricingCards />` |
105
- | FAQ | Questions & Answers (Good for SEO) | `<Accordion />` |
106
- | CTA | Final conversion | `<CallToAction />` |
100
+ |Hero|First impression, H1 & Main CTA|`<HeroSection />`|
101
+ |Features|Product benefits (Grid/Bento layout)|`<FeaturesGrid />`|
102
+ |Social Proof|Partner logos, User numbers|`<LogoCloud />`|
103
+ |Testimonials|Customer reviews|`<TestimonialCarousel />`|
104
+ |Pricing|Service plans|`<PricingCards />`|
105
+ |FAQ|Questions & Answers (Good for SEO)|`<Accordion />`|
106
+ |CTA|Final conversion|`<CallToAction />`|
107
107
 
108
108
  ---
109
109
 
110
110
  ## Animation Patterns (Framer Motion)
111
111
 
112
- | Pattern | Usage | Implementation |
112
+ |Pattern|Usage|Implementation|
113
113
  |---------|-------|----------------|
114
- | Fade Up | Headlines, paragraphs | `initial={{ opacity: 0, y: 20 }} animate={{ opacity: 1, y: 0 }}` |
115
- | Stagger | Lists of Features/Cards | Use variants with `staggerChildren` |
116
- | Parallax | Background images or floating elements | `useScroll` & `useTransform` |
117
- | Micro-interactions | Hover buttons, click effects | `whileHover={{ scale: 1.05 }} whileTap={{ scale: 0.95 }}` |
114
+ |Fade Up|Headlines, paragraphs|`initial={{ opacity: 0, y: 20 }} animate={{ opacity: 1, y: 0 }}`|
115
+ |Stagger|Lists of Features/Cards|Use variants with `staggerChildren`|
116
+ |Parallax|Background images or floating elements|`useScroll` & `useTransform`|
117
+ |Micro-interactions|Hover buttons, click effects|`whileHover={{ scale: 1.05 }} whileTap={{ scale: 0.95 }}`|
118
118
 
119
119
  ---
120
120
 
@@ -152,12 +152,12 @@ export const metadata: Metadata = {
152
152
 
153
153
  ## Deployment
154
154
 
155
- | Platform | Method | Important Notes |
155
+ |Platform|Method|Important Notes|
156
156
  |----------|--------|-----------------|
157
- | Vercel | Git Push | Auto-detects Next.js. Best for performance. |
158
- | GitHub Pages | GitHub Actions | Need to set `basePath` in `next.config.ts` if not using a custom domain. |
159
- | AWS S3 / CloudFront | Upload out folder | Ensure Error Document is configured to `404.html`. |
160
- | Netlify | Git Push | Set build command to `npm run build`. |
157
+ |Vercel|Git Push|Auto-detects Next.js. Best for performance.|
158
+ |GitHub Pages|GitHub Actions|Need to set `basePath` in `next.config.ts` if not using a custom domain.|
159
+ |AWS S3 / CloudFront|Upload out folder|Ensure Error Document is configured to `404.html`.|
160
+ |Netlify|Git Push|Set build command to `npm run build`.|
161
161
 
162
162
  ---
163
163
 
@@ -9,16 +9,16 @@ Mẫu template Full-Stack hiện đại cho Nuxt 4, tối ưu hóa hiệu suất
9
9
 
10
10
  ## Tech Stack
11
11
 
12
- | Component | Technology | Version / Notes |
12
+ |Component|Technology|Version / Notes|
13
13
  |-----------|------------|-----------------|
14
- | Framework | Nuxt | v4.0+ (App Directory structure) |
15
- | UI Engine | Vue | v3.6+ (Vapor Mode enabled) |
16
- | Language | TypeScript | v5+ (Strict Mode) |
17
- | State | Pinia | v3+ (Store syntax) |
18
- | Database | PostgreSQL | Prisma ORM |
19
- | Styling | Tailwind CSS | v4.0 (Vite Plugin, Zero-config) |
20
- | UI Lib | Nuxt UI | v3 (Tailwind v4 native) |
21
- | Validation | Zod | Schema validation |
14
+ |Framework|Nuxt|v4.0+ (App Directory structure)|
15
+ |UI Engine|Vue|v3.6+ (Vapor Mode enabled)|
16
+ |Language|TypeScript|v5+ (Strict Mode)|
17
+ |State|Pinia|v3+ (Store syntax)|
18
+ |Database|PostgreSQL|Prisma ORM|
19
+ |Styling|Tailwind CSS|v4.0 (Vite Plugin, Zero-config)|
20
+ |UI Lib|Nuxt UI|v3 (Tailwind v4 native)|
21
+ |Validation|Zod|Schema validation|
22
22
 
23
23
  ---
24
24
 
@@ -53,23 +53,23 @@ project-name/
53
53
 
54
54
  ## Key Concepts (2026)
55
55
 
56
- | Concept | Description | Future Update |
56
+ |Concept|Description|Future Update|
57
57
  |---------|-------------|---------------|
58
- | **App Directory** | `app/` | Tách biệt mã nguồn ứng dụng và file cấu hình root. |
59
- | **Vapor Mode** | Opt-in performance | Render không cần Virtual DOM (như SolidJS). Bật trong `nuxt.config`. |
60
- | **Server Functions** | RPC-style calls | Gọi hàm server trực tiếp từ client (thay thế dần API routes thủ công). |
61
- | **Tailwind v4** | CSS-first | Cấu hình theme trực tiếp trong CSS, không cần `tailwind.config.js`. |
62
- | **Nuxt Islands** | Server Components | Render component cô lập trên server (`<NuxtIsland name="..." />`). |
58
+ |**App Directory**|`app/`|Tách biệt mã nguồn ứng dụng và file cấu hình root.|
59
+ |**Vapor Mode**|Opt-in performance|Render không cần Virtual DOM (như SolidJS). Bật trong `nuxt.config`.|
60
+ |**Server Functions**|RPC-style calls|Gọi hàm server trực tiếp từ client (thay thế dần API routes thủ công).|
61
+ |**Tailwind v4**|CSS-first|Cấu hình theme trực tiếp trong CSS, không cần `tailwind.config.js`.|
62
+ |**Nuxt Islands**|Server Components|Render component cô lập trên server (`<NuxtIsland name="..." />`).|
63
63
 
64
64
  ---
65
65
 
66
66
  ## Environment Variables
67
67
 
68
- | Variable | Purpose |
68
+ |Variable|Purpose|
69
69
  |----------|---------|
70
- | DATABASE_URL | Prisma connection string (PostgreSQL) |
71
- | NUXT_PUBLIC_APP_URL | Canonical URL |
72
- | NUXT_SESSION_PASSWORD | Session encryption key |
70
+ |DATABASE_URL|Prisma connection string (PostgreSQL)|
71
+ |NUXT_PUBLIC_APP_URL|Canonical URL|
72
+ |NUXT_SESSION_PASSWORD|Session encryption key|
73
73
 
74
74
  ---
75
75
 
@@ -7,14 +7,14 @@ description: FastAPI REST API template principles. SQLAlchemy, Pydantic, Alembic
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology |
10
+ |Component|Technology|
11
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 |
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
18
 
19
19
  ---
20
20
 
@@ -42,24 +42,24 @@ project-name/
42
42
 
43
43
  ## Key Concepts
44
44
 
45
- | Concept | Description |
45
+ |Concept|Description|
46
46
  |---------|-------------|
47
- | Async | async/await throughout |
48
- | Dependency Injection | FastAPI Depends |
49
- | Pydantic v2 | Validation + serialization |
50
- | SQLAlchemy 2.0 | Async sessions |
47
+ |Async|async/await throughout|
48
+ |Dependency Injection|FastAPI Depends|
49
+ |Pydantic v2|Validation + serialization|
50
+ |SQLAlchemy 2.0|Async sessions|
51
51
 
52
52
  ---
53
53
 
54
54
  ## API Structure
55
55
 
56
- | Layer | Responsibility |
56
+ |Layer|Responsibility|
57
57
  |-------|---------------|
58
- | Routers | HTTP handling |
59
- | Dependencies | Auth, validation |
60
- | Services | Business logic |
61
- | Models | Database entities |
62
- | Schemas | Request/response |
58
+ |Routers|HTTP handling|
59
+ |Dependencies|Auth, validation|
60
+ |Services|Business logic|
61
+ |Models|Database entities|
62
+ |Schemas|Request/response|
63
63
 
64
64
  ---
65
65