tribunal-kit 4.5.0 → 4.6.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 (217) hide show
  1. package/.agent/.shared/ui-ux-pro-max/README.md +4 -4
  2. package/.agent/ARCHITECTURE.md +279 -277
  3. package/.agent/GEMINI.md +127 -121
  4. package/.agent/agents/accessibility-reviewer.md +187 -187
  5. package/.agent/agents/ai-code-reviewer.md +199 -199
  6. package/.agent/agents/api-architect.md +71 -66
  7. package/.agent/agents/backend-specialist.md +219 -215
  8. package/.agent/agents/cloud-engineer.md +98 -0
  9. package/.agent/agents/code-archaeologist.md +168 -161
  10. package/.agent/agents/database-architect.md +184 -184
  11. package/.agent/agents/db-latency-auditor.md +213 -216
  12. package/.agent/agents/debugger.md +198 -191
  13. package/.agent/agents/dependency-reviewer.md +106 -103
  14. package/.agent/agents/devops-engineer.md +218 -218
  15. package/.agent/agents/documentation-writer.md +209 -201
  16. package/.agent/agents/explorer-agent.md +167 -160
  17. package/.agent/agents/frontend-reviewer.md +162 -160
  18. package/.agent/agents/frontend-specialist.md +257 -248
  19. package/.agent/agents/game-developer.md +48 -48
  20. package/.agent/agents/logic-reviewer.md +118 -116
  21. package/.agent/agents/mobile-developer.md +197 -200
  22. package/.agent/agents/mobile-reviewer.md +159 -162
  23. package/.agent/agents/orchestrator.md +187 -181
  24. package/.agent/agents/penetration-tester.md +160 -157
  25. package/.agent/agents/performance-optimizer.md +183 -183
  26. package/.agent/agents/performance-reviewer.md +178 -178
  27. package/.agent/agents/precedence-reviewer.md +251 -250
  28. package/.agent/agents/product-manager.md +149 -142
  29. package/.agent/agents/product-owner.md +81 -80
  30. package/.agent/agents/project-planner.md +152 -142
  31. package/.agent/agents/qa-automation-engineer.md +216 -225
  32. package/.agent/agents/resilience-reviewer.md +88 -88
  33. package/.agent/agents/schema-reviewer.md +67 -67
  34. package/.agent/agents/security-auditor.md +180 -174
  35. package/.agent/agents/seo-specialist.md +188 -193
  36. package/.agent/agents/sql-reviewer.md +159 -161
  37. package/.agent/agents/supervisor-agent.md +173 -184
  38. package/.agent/agents/swarm-worker-contracts.md +170 -166
  39. package/.agent/agents/swarm-worker-registry.md +92 -92
  40. package/.agent/agents/system-architect.md +85 -0
  41. package/.agent/agents/test-coverage-reviewer.md +158 -160
  42. package/.agent/agents/test-engineer.md +118 -118
  43. package/.agent/agents/throughput-optimizer.md +291 -299
  44. package/.agent/agents/type-safety-reviewer.md +182 -175
  45. package/.agent/agents/ui-ux-auditor.md +300 -292
  46. package/.agent/agents/vitals-reviewer.md +223 -223
  47. package/.agent/mcp_config.json +37 -40
  48. package/.agent/patterns/generator.md +11 -9
  49. package/.agent/patterns/inversion.md +14 -12
  50. package/.agent/patterns/pipeline.md +11 -9
  51. package/.agent/patterns/reviewer.md +15 -13
  52. package/.agent/patterns/tool-wrapper.md +11 -9
  53. package/.agent/routing_index.json +654 -0
  54. package/.agent/rules/GEMINI.md +358 -352
  55. package/.agent/scripts/compile_router.py +112 -0
  56. package/.agent/scripts/migrate_skills_frontmatter.py +64 -0
  57. package/.agent/scripts/strengthen_skills.js +1 -1
  58. package/.agent/skills/advanced-rag-pipelines/SKILL.md +56 -0
  59. package/.agent/skills/agent-organizer/SKILL.md +156 -150
  60. package/.agent/skills/agentic-patterns/SKILL.md +313 -315
  61. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +190 -184
  62. package/.agent/skills/api-patterns/SKILL.md +253 -247
  63. package/.agent/skills/api-security-auditor/SKILL.md +195 -193
  64. package/.agent/skills/app-builder/SKILL.md +573 -572
  65. package/.agent/skills/app-builder/templates/SKILL.md +108 -115
  66. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  67. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  68. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  69. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  70. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  71. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  72. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  73. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -122
  74. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -122
  75. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -169
  76. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -134
  77. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  78. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -119
  79. package/.agent/skills/appflow-wireframe/SKILL.md +146 -145
  80. package/.agent/skills/architecture/SKILL.md +226 -219
  81. package/.agent/skills/authentication-best-practices/SKILL.md +197 -189
  82. package/.agent/skills/backend-security-expert/SKILL.md +16 -2
  83. package/.agent/skills/bash-linux/SKILL.md +179 -179
  84. package/.agent/skills/behavioral-modes/SKILL.md +239 -223
  85. package/.agent/skills/brainstorming/SKILL.md +498 -486
  86. package/.agent/skills/browser-native-ai/SKILL.md +57 -4
  87. package/.agent/skills/building-native-ui/SKILL.md +202 -202
  88. package/.agent/skills/cicd-pro/SKILL.md +442 -0
  89. package/.agent/skills/clean-code/SKILL.md +400 -381
  90. package/.agent/skills/cloud-architect/SKILL.md +439 -0
  91. package/.agent/skills/code-review-checklist/SKILL.md +203 -194
  92. package/.agent/skills/config-validator/SKILL.md +165 -165
  93. package/.agent/skills/containerization-pro/SKILL.md +452 -0
  94. package/.agent/skills/csharp-developer/SKILL.md +518 -518
  95. package/.agent/skills/data-validation-schemas/SKILL.md +333 -328
  96. package/.agent/skills/database-design/SKILL.md +247 -240
  97. package/.agent/skills/deployment-procedures/SKILL.md +172 -169
  98. package/.agent/skills/devops-engineer/SKILL.md +345 -345
  99. package/.agent/skills/devops-incident-responder/SKILL.md +143 -137
  100. package/.agent/skills/doc.md +209 -177
  101. package/.agent/skills/documentation-templates/SKILL.md +291 -279
  102. package/.agent/skills/edge-computing/SKILL.md +183 -181
  103. package/.agent/skills/error-resilience/SKILL.md +411 -428
  104. package/.agent/skills/extract-design-system/SKILL.md +160 -158
  105. package/.agent/skills/framer-motion-expert/SKILL.md +253 -244
  106. package/.agent/skills/frontend-design/SKILL.md +208 -201
  107. package/.agent/skills/frontend-security-expert/SKILL.md +16 -3
  108. package/.agent/skills/game-design-expert/SKILL.md +132 -129
  109. package/.agent/skills/game-engineering-expert/SKILL.md +148 -146
  110. package/.agent/skills/generative-ui-expert/SKILL.md +57 -1
  111. package/.agent/skills/geo-fundamentals/SKILL.md +148 -147
  112. package/.agent/skills/git-pro/SKILL.md +435 -0
  113. package/.agent/skills/github-operations/SKILL.md +335 -329
  114. package/.agent/skills/gsap-core/SKILL.md +319 -308
  115. package/.agent/skills/gsap-frameworks/SKILL.md +213 -207
  116. package/.agent/skills/gsap-performance/SKILL.md +139 -133
  117. package/.agent/skills/gsap-plugins/SKILL.md +486 -480
  118. package/.agent/skills/gsap-react/SKILL.md +202 -189
  119. package/.agent/skills/gsap-scrolltrigger/SKILL.md +357 -350
  120. package/.agent/skills/gsap-timeline/SKILL.md +165 -161
  121. package/.agent/skills/gsap-utils/SKILL.md +344 -338
  122. package/.agent/skills/harness-protocol/SKILL.md +48 -0
  123. package/.agent/skills/i18n-localization/SKILL.md +174 -163
  124. package/.agent/skills/intelligent-routing/SKILL.md +202 -246
  125. package/.agent/skills/knowledge-graph/SKILL.md +60 -52
  126. package/.agent/skills/lint-and-validate/SKILL.md +261 -261
  127. package/.agent/skills/llm-engineering/SKILL.md +400 -394
  128. package/.agent/skills/local-first/SKILL.md +178 -178
  129. package/.agent/skills/mcp-builder/SKILL.md +143 -142
  130. package/.agent/skills/mobile-design/SKILL.md +272 -263
  131. package/.agent/skills/monorepo-management/SKILL.md +335 -334
  132. package/.agent/skills/motion-engineering/SKILL.md +266 -234
  133. package/.agent/skills/nextjs-react-expert/SKILL.md +236 -234
  134. package/.agent/skills/nodejs-best-practices/SKILL.md +547 -548
  135. package/.agent/skills/observability/SKILL.md +343 -343
  136. package/.agent/skills/parallel-agents/SKILL.md +143 -146
  137. package/.agent/skills/performance-profiling/SKILL.md +259 -267
  138. package/.agent/skills/plan-writing/SKILL.md +150 -142
  139. package/.agent/skills/platform-engineer/SKILL.md +148 -147
  140. package/.agent/skills/playwright-best-practices/SKILL.md +188 -187
  141. package/.agent/skills/powershell-windows/SKILL.md +162 -162
  142. package/.agent/skills/project-idioms/SKILL.md +137 -137
  143. package/.agent/skills/python-patterns/SKILL.md +260 -259
  144. package/.agent/skills/python-pro/SKILL.md +324 -323
  145. package/.agent/skills/react-specialist/SKILL.md +305 -277
  146. package/.agent/skills/readme-builder/SKILL.md +310 -300
  147. package/.agent/skills/realtime-patterns/SKILL.md +323 -319
  148. package/.agent/skills/red-team-tactics/SKILL.md +231 -218
  149. package/.agent/skills/rust-pro/SKILL.md +671 -673
  150. package/.agent/skills/seo-fundamentals/SKILL.md +179 -179
  151. package/.agent/skills/server-management/SKILL.md +218 -214
  152. package/.agent/skills/shadcn-ui-expert/SKILL.md +231 -231
  153. package/.agent/skills/skill-creator/SKILL.md +87 -86
  154. package/.agent/skills/sql-pro/SKILL.md +629 -629
  155. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +97 -97
  156. package/.agent/skills/swiftui-expert/SKILL.md +204 -201
  157. package/.agent/skills/system-design-pro/SKILL.md +345 -0
  158. package/.agent/skills/systematic-debugging/SKILL.md +153 -142
  159. package/.agent/skills/tailwind-patterns/SKILL.md +610 -566
  160. package/.agent/skills/tdd-workflow/SKILL.md +169 -161
  161. package/.agent/skills/test-result-analyzer/SKILL.md +313 -309
  162. package/.agent/skills/testing-patterns/SKILL.md +566 -579
  163. package/.agent/skills/trend-researcher/SKILL.md +243 -237
  164. package/.agent/skills/typescript-advanced/SKILL.md +336 -335
  165. package/.agent/skills/ui-ux-pro-max/SKILL.md +590 -562
  166. package/.agent/skills/ui-ux-researcher/SKILL.md +244 -244
  167. package/.agent/skills/vue-expert/SKILL.md +294 -275
  168. package/.agent/skills/vulnerability-scanner/SKILL.md +416 -404
  169. package/.agent/skills/web-accessibility-auditor/SKILL.md +219 -218
  170. package/.agent/skills/web-design-guidelines/SKILL.md +192 -186
  171. package/.agent/skills/webapp-testing/SKILL.md +167 -169
  172. package/.agent/skills/webgpu-performance/SKILL.md +56 -2
  173. package/.agent/skills/whimsy-injector/SKILL.md +346 -325
  174. package/.agent/skills/workflow-optimizer/SKILL.md +231 -229
  175. package/.agent/workflows/acf.md +141 -0
  176. package/.agent/workflows/api-tester.md +176 -151
  177. package/.agent/workflows/audit.md +150 -127
  178. package/.agent/workflows/brainstorm.md +134 -110
  179. package/.agent/workflows/changelog.md +140 -112
  180. package/.agent/workflows/create.md +168 -124
  181. package/.agent/workflows/debug.md +190 -165
  182. package/.agent/workflows/deploy.md +201 -180
  183. package/.agent/workflows/enhance.md +154 -128
  184. package/.agent/workflows/fix.md +136 -114
  185. package/.agent/workflows/generate.md +198 -183
  186. package/.agent/workflows/marathon.md +37 -11
  187. package/.agent/workflows/migrate.md +184 -160
  188. package/.agent/workflows/orchestrate.md +192 -168
  189. package/.agent/workflows/performance-benchmarker.md +135 -114
  190. package/.agent/workflows/plan.md +196 -173
  191. package/.agent/workflows/preview.md +103 -80
  192. package/.agent/workflows/refactor.md +192 -161
  193. package/.agent/workflows/review-ai.md +125 -101
  194. package/.agent/workflows/review.md +141 -116
  195. package/.agent/workflows/session.md +122 -94
  196. package/.agent/workflows/status.md +101 -79
  197. package/.agent/workflows/strengthen-skills.md +164 -138
  198. package/.agent/workflows/super-prompt.md +24 -0
  199. package/.agent/workflows/swarm.md +193 -179
  200. package/.agent/workflows/test.md +211 -189
  201. package/.agent/workflows/tribunal-backend.md +136 -105
  202. package/.agent/workflows/tribunal-database.md +122 -95
  203. package/.agent/workflows/tribunal-frontend.md +221 -96
  204. package/.agent/workflows/tribunal-full.md +129 -100
  205. package/.agent/workflows/tribunal-mobile.md +122 -95
  206. package/.agent/workflows/tribunal-performance.md +136 -110
  207. package/.agent/workflows/tribunal-speed.md +209 -183
  208. package/.agent/workflows/ui-ux-pro-max.md +145 -122
  209. package/README.md +107 -55
  210. package/bin/mcp-server.js +159 -0
  211. package/bin/tribunal-kit.js +105 -29
  212. package/bin/wrapper.js +16 -7
  213. package/mcp_config.json +9 -0
  214. package/package.json +94 -86
  215. package/scripts/changelog.js +4 -3
  216. package/scripts/validate-payload.js +6 -1
  217. package/scripts/postinstall.js +0 -127
@@ -1,115 +1,108 @@
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
- ---
10
-
11
- ## 🎯 Selective Reading Rule
12
-
13
- **Read ONLY the template matching user's project type!**
14
-
15
- |Template|Tech Stack|When to Use|
16
- |----------|------------|-------------|
17
- |[nextjs-fullstack](nextjs-fullstack/TEMPLATE.md)|Next.js + Prisma|Full-stack web app|
18
- |[nextjs-saas](nextjs-saas/TEMPLATE.md)|Next.js + Stripe|SaaS product|
19
- |[nextjs-static](nextjs-static/TEMPLATE.md)|Next.js + Framer|Landing page|
20
- |[express-api](express-api/TEMPLATE.md)|Express + JWT|REST API|
21
- |[python-fastapi](python-fastapi/TEMPLATE.md)|FastAPI|Python API|
22
- |[react-native-app](react-native-app/TEMPLATE.md)|Expo + Zustand|Mobile app|
23
- |[flutter-app](flutter-app/TEMPLATE.md)|Flutter + Riverpod|Cross-platform|
24
- |[electron-desktop](electron-desktop/TEMPLATE.md)|Electron + React|Desktop app|
25
- |[chrome-extension](chrome-extension/TEMPLATE.md)|Chrome MV3|Browser extension|
26
- |[cli-tool](cli-tool/TEMPLATE.md)|Node.js + Commander|CLI app|
27
- |[monorepo-turborepo](monorepo-turborepo/TEMPLATE.md)|Turborepo + pnpm|Monorepo|
28
- |[astro-static](astro-static/TEMPLATE.md)|Astro + MDX|Blog / Docs|
29
-
30
- ---
31
-
32
- ## Usage
33
-
34
- 1. User says "create [type] app"
35
- 2. Match to appropriate template
36
- 3. Read ONLY that template's TEMPLATE.md
37
- 4. Follow its tech stack and structure
38
-
39
- ---
40
-
41
- ## 🚨 LLM Trap Table
42
-
43
- |Pattern|What AI Does Wrong|What Is Actually Correct|
44
- |:---|:---|:---|
45
- |[domain-specific trap 1]|[hallucination]|[correct behavior]|
46
- |[domain-specific trap 2]|[hallucination]|[correct behavior]|
47
- |[domain-specific trap 3]|[hallucination]|[correct behavior]|
48
-
49
- ---
50
-
51
- ## ✅ Pre-Flight Self-Audit
52
-
53
- Before producing any output, verify:
54
- ``
55
- ✅ Did I read the actual files before making claims about them?
56
- ✅ Did I verify all method names against official documentation?
57
- ✅ Did I add // VERIFY: on any uncertain API calls?
58
- ✅ Are all imports from packages that actually exist in package.json?
59
- ✅ Did I test my logic with edge cases (null, empty, 0, max)?
60
- ✅ Did I avoid generating code for more than one module at a time?
61
- ✅ Am I working from evidence, not assumption?
62
- ``
63
-
64
- ---
65
-
66
- ## 🔁 VBC Protocol (Verify → Build → Confirm)
67
-
68
- ``
69
- VERIFY: Read the actual codebase before writing anything
70
- BUILD: Generate the smallest meaningful unit of code
71
- CONFIRM: Verify the output is correct before presenting
72
- ``
73
-
74
- ---
75
-
76
- ## 🚨 LLM Trap Table
77
-
78
- |Pattern|What AI Does Wrong|What Is Actually Correct|
79
- |:---|:---|:---|
80
- |[domain-specific trap 1]|[hallucination]|[correct behavior]|
81
- |[domain-specific trap 2]|[hallucination]|[correct behavior]|
82
- |[domain-specific trap 3]|[hallucination]|[correct behavior]|
83
-
84
- ---
85
-
86
- ## ✅ Pre-Flight Self-Audit
87
-
88
- Before producing any output, verify:
89
- ``
90
- ✅ Did I read the actual files before making claims about them?
91
- ✅ Did I verify all method names against official documentation?
92
- ✅ Did I add // VERIFY: on any uncertain API calls?
93
- ✅ Are all imports from packages that actually exist in package.json?
94
- ✅ Did I test my logic with edge cases (null, empty, 0, max)?
95
- ✅ Did I avoid generating code for more than one module at a time?
96
- ✅ Am I working from evidence, not assumption?
97
- ``
98
-
99
- ---
100
-
101
- ## 🔁 VBC Protocol (Verify → Build → Confirm)
102
-
103
- ``
104
- VERIFY: Read the actual codebase before writing anything
105
- BUILD: Generate the smallest meaningful unit of code
106
- CONFIRM: Verify the output is correct before presenting
107
- ``
108
-
109
-
110
- ## Pre-Flight Checklist
111
- - [ ] Have I reviewed the user's specific constraints and requests?
112
- - [ ] Have I checked the environment for relevant existing implementations?
113
-
114
- ## VBC Protocol (Verification-Before-Completion)
115
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
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
+ ---
10
+
11
+ ## 🎯 Selective Reading Rule
12
+
13
+ **Read ONLY the template matching user's project type!**
14
+
15
+ | Template | Tech Stack | When to Use |
16
+ | ---------------------------------------------------- | ------------------- | ------------------ |
17
+ | [nextjs-fullstack](nextjs-fullstack/TEMPLATE.md) | Next.js + Prisma | Full-stack web app |
18
+ | [nextjs-saas](nextjs-saas/TEMPLATE.md) | Next.js + Stripe | SaaS product |
19
+ | [nextjs-static](nextjs-static/TEMPLATE.md) | Next.js + Framer | Landing page |
20
+ | [express-api](express-api/TEMPLATE.md) | Express + JWT | REST API |
21
+ | [python-fastapi](python-fastapi/TEMPLATE.md) | FastAPI | Python API |
22
+ | [react-native-app](react-native-app/TEMPLATE.md) | Expo + Zustand | Mobile app |
23
+ | [flutter-app](flutter-app/TEMPLATE.md) | Flutter + Riverpod | Cross-platform |
24
+ | [electron-desktop](electron-desktop/TEMPLATE.md) | Electron + React | Desktop app |
25
+ | [chrome-extension](chrome-extension/TEMPLATE.md) | Chrome MV3 | Browser extension |
26
+ | [cli-tool](cli-tool/TEMPLATE.md) | Node.js + Commander | CLI app |
27
+ | [monorepo-turborepo](monorepo-turborepo/TEMPLATE.md) | Turborepo + pnpm | Monorepo |
28
+ | [astro-static](astro-static/TEMPLATE.md) | Astro + MDX | Blog / Docs |
29
+
30
+ ---
31
+
32
+ ## Usage
33
+
34
+ 1. User says "create [type] app"
35
+ 2. Match to appropriate template
36
+ 3. Read ONLY that template's TEMPLATE.md
37
+ 4. Follow its tech stack and structure
38
+
39
+ ---
40
+
41
+ ## 🚨 LLM Trap Table
42
+
43
+ | Pattern | What AI Does Wrong | What Is Actually Correct |
44
+ | :----------------------- | :----------------- | :----------------------- |
45
+ | [domain-specific trap 1] | [hallucination] | [correct behavior] |
46
+ | [domain-specific trap 2] | [hallucination] | [correct behavior] |
47
+ | [domain-specific trap 3] | [hallucination] | [correct behavior] |
48
+
49
+ ---
50
+
51
+ ## ✅ Pre-Flight Self-Audit
52
+
53
+ Before producing any output, verify:
54
+ `✅ Did I read the actual files before making claims about them?
55
+ ✅ Did I verify all method names against official documentation?
56
+ ✅ Did I add // VERIFY: on any uncertain API calls?
57
+ ✅ Are all imports from packages that actually exist in package.json?
58
+ ✅ Did I test my logic with edge cases (null, empty, 0, max)?
59
+ ✅ Did I avoid generating code for more than one module at a time?
60
+ ✅ Am I working from evidence, not assumption?`
61
+
62
+ ---
63
+
64
+ ## 🔁 VBC Protocol (Verify → Build → Confirm)
65
+
66
+ `VERIFY: Read the actual codebase before writing anything
67
+ BUILD: Generate the smallest meaningful unit of code
68
+ CONFIRM: Verify the output is correct before presenting`
69
+
70
+ ---
71
+
72
+ ## 🚨 LLM Trap Table
73
+
74
+ | Pattern | What AI Does Wrong | What Is Actually Correct |
75
+ | :----------------------- | :----------------- | :----------------------- |
76
+ | [domain-specific trap 1] | [hallucination] | [correct behavior] |
77
+ | [domain-specific trap 2] | [hallucination] | [correct behavior] |
78
+ | [domain-specific trap 3] | [hallucination] | [correct behavior] |
79
+
80
+ ---
81
+
82
+ ## ✅ Pre-Flight Self-Audit
83
+
84
+ Before producing any output, verify:
85
+ `✅ Did I read the actual files before making claims about them?
86
+ ✅ Did I verify all method names against official documentation?
87
+ ✅ Did I add // VERIFY: on any uncertain API calls?
88
+ ✅ Are all imports from packages that actually exist in package.json?
89
+ ✅ Did I test my logic with edge cases (null, empty, 0, max)?
90
+ ✅ Did I avoid generating code for more than one module at a time?
91
+ ✅ Am I working from evidence, not assumption?`
92
+
93
+ ---
94
+
95
+ ## 🔁 VBC Protocol (Verify → Build → Confirm)
96
+
97
+ `VERIFY: Read the actual codebase before writing anything
98
+ BUILD: Generate the smallest meaningful unit of code
99
+ CONFIRM: Verify the output is correct before presenting`
100
+
101
+ ## Pre-Flight Checklist
102
+
103
+ - [ ] Have I reviewed the user's specific constraints and requests?
104
+ - [ ] Have I checked the environment for relevant existing implementations?
105
+
106
+ ## VBC Protocol (Verification-Before-Completion)
107
+
108
+ You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
@@ -1,76 +1,76 @@
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
+ ---
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 +1,92 @@
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 19|
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
+ ---
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 19 |
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