tribunal-kit 8.0.0 → 9.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 (258) hide show
  1. package/.agent/ARCHITECTURE.md +2 -2
  2. package/.agent/config/plugin.json +4 -4
  3. package/.agent/config/system-prompt.md +54 -1
  4. package/.agent/routing_index.json +2 -2
  5. package/.agent/skills/12-principles-of-animation/SKILL.md +19 -16
  6. package/.agent/skills/60fps-animation/SKILL.md +47 -21
  7. package/.agent/skills/accessible-animation/SKILL.md +19 -16
  8. package/.agent/skills/adapt/SKILL.md +19 -16
  9. package/.agent/skills/advanced-rag-pipelines/SKILL.md +41 -40
  10. package/.agent/skills/agent-organizer/SKILL.md +9 -59
  11. package/.agent/skills/agentic-patterns/SKILL.md +9 -57
  12. package/.agent/skills/agentic-workflows-2026/SKILL.md +45 -8
  13. package/.agent/skills/ai-app-hardening/SKILL.md +31 -5
  14. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +28 -66
  15. package/.agent/skills/animation-on-scroll/SKILL.md +19 -16
  16. package/.agent/skills/animation-systems/SKILL.md +19 -15
  17. package/.agent/skills/antfu-conventions/SKILL.md +19 -18
  18. package/.agent/skills/api-patterns/SKILL.md +8 -58
  19. package/.agent/skills/api-security-auditor/SKILL.md +8 -58
  20. package/.agent/skills/app-builder/SKILL.md +9 -59
  21. package/.agent/skills/appflow-wireframe/SKILL.md +13 -57
  22. package/.agent/skills/apple-design/SKILL.md +22 -14
  23. package/.agent/skills/architecture/SKILL.md +9 -59
  24. package/.agent/skills/audit-and-fix/SKILL.md +19 -16
  25. package/.agent/skills/authentication-best-practices/SKILL.md +8 -58
  26. package/.agent/skills/backend-security-expert/SKILL.md +32 -65
  27. package/.agent/skills/baseline-ui/SKILL.md +22 -14
  28. package/.agent/skills/bash-linux/SKILL.md +9 -59
  29. package/.agent/skills/behavioral-modes/SKILL.md +9 -57
  30. package/.agent/skills/better-colors/SKILL.md +22 -14
  31. package/.agent/skills/better-typography/SKILL.md +26 -14
  32. package/.agent/skills/better-ui/SKILL.md +54 -19
  33. package/.agent/skills/bolder/SKILL.md +19 -16
  34. package/.agent/skills/brainstorming/SKILL.md +9 -57
  35. package/.agent/skills/browser-native-ai/SKILL.md +9 -28
  36. package/.agent/skills/build-primitive/SKILL.md +19 -16
  37. package/.agent/skills/building-native-ui/SKILL.md +9 -59
  38. package/.agent/skills/cicd-pro/SKILL.md +21 -28
  39. package/.agent/skills/clarify/SKILL.md +19 -16
  40. package/.agent/skills/clean-code/SKILL.md +18 -61
  41. package/.agent/skills/cloud-architect/SKILL.md +21 -28
  42. package/.agent/skills/cobejs/SKILL.md +19 -15
  43. package/.agent/skills/code-review-checklist/SKILL.md +8 -58
  44. package/.agent/skills/codebase-design/SKILL.md +33 -22
  45. package/.agent/skills/colorize/SKILL.md +19 -16
  46. package/.agent/skills/compact-landing/SKILL.md +19 -16
  47. package/.agent/skills/company-logos/SKILL.md +19 -16
  48. package/.agent/skills/config-validator/SKILL.md +9 -59
  49. package/.agent/skills/containerization-pro/SKILL.md +21 -28
  50. package/.agent/skills/context-engineering-pro/SKILL.md +31 -5
  51. package/.agent/skills/create-design-md/SKILL.md +22 -14
  52. package/.agent/skills/critique/SKILL.md +20 -11
  53. package/.agent/skills/csharp-developer/SKILL.md +8 -58
  54. package/.agent/skills/data-validation-schemas/SKILL.md +9 -59
  55. package/.agent/skills/database-design/SKILL.md +27 -67
  56. package/.agent/skills/delight/SKILL.md +19 -16
  57. package/.agent/skills/deployment-procedures/SKILL.md +9 -59
  58. package/.agent/skills/design-lab/SKILL.md +19 -16
  59. package/.agent/skills/devops-engineer/SKILL.md +8 -58
  60. package/.agent/skills/devops-incident-responder/SKILL.md +9 -59
  61. package/.agent/skills/diagnosing-bugs/SKILL.md +20 -21
  62. package/.agent/skills/distill/SKILL.md +19 -16
  63. package/.agent/skills/documentation-templates/SKILL.md +9 -59
  64. package/.agent/skills/domain-modeling/SKILL.md +19 -18
  65. package/.agent/skills/duckdb-analytical-sql/SKILL.md +31 -5
  66. package/.agent/skills/edge-ai-mobile/SKILL.md +31 -5
  67. package/.agent/skills/edge-computing/SKILL.md +9 -59
  68. package/.agent/skills/emil-design-eng/SKILL.md +21 -24
  69. package/.agent/skills/error-resilience/SKILL.md +31 -66
  70. package/.agent/skills/expo-router-v4/SKILL.md +31 -5
  71. package/.agent/skills/extract-design-system/SKILL.md +9 -59
  72. package/.agent/skills/fabel-protocol/SKILL.md +26 -8
  73. package/.agent/skills/fixing-accessibility/SKILL.md +22 -14
  74. package/.agent/skills/fixing-metadata/SKILL.md +19 -16
  75. package/.agent/skills/fixing-motion-performance/SKILL.md +22 -14
  76. package/.agent/skills/framer-motion-expert/SKILL.md +9 -57
  77. package/.agent/skills/frontend-design/SKILL.md +27 -7
  78. package/.agent/skills/frontend-security-expert/SKILL.md +8 -58
  79. package/.agent/skills/game-design-expert/SKILL.md +9 -59
  80. package/.agent/skills/game-engineering-expert/SKILL.md +9 -59
  81. package/.agent/skills/generative-ui-expert/SKILL.md +9 -28
  82. package/.agent/skills/geo-fundamentals/SKILL.md +9 -59
  83. package/.agent/skills/git-pro/SKILL.md +19 -30
  84. package/.agent/skills/github-operations/SKILL.md +8 -58
  85. package/.agent/skills/gpt-taste/SKILL.md +19 -16
  86. package/.agent/skills/gsap-core/SKILL.md +8 -78
  87. package/.agent/skills/gsap-frameworks/SKILL.md +8 -78
  88. package/.agent/skills/gsap-performance/SKILL.md +9 -77
  89. package/.agent/skills/gsap-plugins/SKILL.md +9 -77
  90. package/.agent/skills/gsap-react/SKILL.md +9 -21
  91. package/.agent/skills/gsap-scrolltrigger/SKILL.md +8 -78
  92. package/.agent/skills/gsap-timeline/SKILL.md +9 -77
  93. package/.agent/skills/gsap-utils/SKILL.md +9 -77
  94. package/.agent/skills/harden/SKILL.md +19 -16
  95. package/.agent/skills/harness-protocol/SKILL.md +9 -21
  96. package/.agent/skills/i18n-localization/SKILL.md +9 -59
  97. package/.agent/skills/impeccable/SKILL.md +19 -18
  98. package/.agent/skills/improve-codebase-architecture/SKILL.md +19 -17
  99. package/.agent/skills/improve-ui/SKILL.md +22 -14
  100. package/.agent/skills/intelligent-routing/SKILL.md +9 -23
  101. package/.agent/skills/knowledge-graph/SKILL.md +9 -21
  102. package/.agent/skills/landing-page/SKILL.md +19 -16
  103. package/.agent/skills/lint-and-validate/SKILL.md +9 -59
  104. package/.agent/skills/llm-engineering/SKILL.md +8 -58
  105. package/.agent/skills/local-first/SKILL.md +9 -59
  106. package/.agent/skills/local-first-architecture/SKILL.md +37 -20
  107. package/.agent/skills/lottie-animation/SKILL.md +19 -15
  108. package/.agent/skills/marquee-loop/SKILL.md +19 -16
  109. package/.agent/skills/masked-reveal/SKILL.md +19 -15
  110. package/.agent/skills/mcp-builder/SKILL.md +9 -59
  111. package/.agent/skills/micro-interaction/SKILL.md +19 -16
  112. package/.agent/skills/mobile-design/SKILL.md +8 -58
  113. package/.agent/skills/monorepo-management/SKILL.md +9 -59
  114. package/.agent/skills/morphing-icons/SKILL.md +19 -15
  115. package/.agent/skills/motion-engineering/SKILL.md +22 -15
  116. package/.agent/skills/nextjs-react-expert/SKILL.md +35 -67
  117. package/.agent/skills/nodejs-best-practices/SKILL.md +34 -61
  118. package/.agent/skills/observability/SKILL.md +8 -58
  119. package/.agent/skills/opentelemetry-observability/SKILL.md +31 -5
  120. package/.agent/skills/page-transition-animation/SKILL.md +19 -16
  121. package/.agent/skills/parallel-agents/SKILL.md +9 -59
  122. package/.agent/skills/performance-profiling/SKILL.md +8 -58
  123. package/.agent/skills/plan-writing/SKILL.md +36 -69
  124. package/.agent/skills/platform-engineer/SKILL.md +9 -59
  125. package/.agent/skills/platform-engineering-opentofu/SKILL.md +31 -5
  126. package/.agent/skills/playwright-ai-e2e/SKILL.md +31 -5
  127. package/.agent/skills/playwright-best-practices/SKILL.md +9 -59
  128. package/.agent/skills/polish/SKILL.md +19 -16
  129. package/.agent/skills/powershell-windows/SKILL.md +8 -58
  130. package/.agent/skills/pricing-page/SKILL.md +19 -16
  131. package/.agent/skills/product-aware-heuristics/SKILL.md +27 -8
  132. package/.agent/skills/progressive-blur/SKILL.md +19 -16
  133. package/.agent/skills/project-idioms/SKILL.md +9 -59
  134. package/.agent/skills/property-based-testing/SKILL.md +31 -5
  135. package/.agent/skills/python-patterns/SKILL.md +9 -59
  136. package/.agent/skills/python-pro/SKILL.md +35 -67
  137. package/.agent/skills/quieter/SKILL.md +19 -16
  138. package/.agent/skills/react-doctor/SKILL.md +19 -16
  139. package/.agent/skills/react-specialist/SKILL.md +26 -65
  140. package/.agent/skills/readme-builder/SKILL.md +9 -59
  141. package/.agent/skills/realtime-patterns/SKILL.md +8 -58
  142. package/.agent/skills/red-team-tactics/SKILL.md +9 -59
  143. package/.agent/skills/redesign-skill/SKILL.md +19 -16
  144. package/.agent/skills/review-animations/SKILL.md +21 -25
  145. package/.agent/skills/rust-pro/SKILL.md +30 -61
  146. package/.agent/skills/seo-fundamentals/SKILL.md +9 -59
  147. package/.agent/skills/server-management/SKILL.md +9 -59
  148. package/.agent/skills/shadcn-ui-expert/SKILL.md +9 -59
  149. package/.agent/skills/shape/SKILL.md +19 -16
  150. package/.agent/skills/skill-creator/SKILL.md +36 -86
  151. package/.agent/skills/soft-skill/SKILL.md +19 -16
  152. package/.agent/skills/sounds-on-the-web/SKILL.md +19 -16
  153. package/.agent/skills/sql-pro/SKILL.md +47 -62
  154. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +9 -59
  155. package/.agent/skills/svg-animation/SKILL.md +19 -15
  156. package/.agent/skills/swiftui-expert/SKILL.md +9 -59
  157. package/.agent/skills/swiss-design/SKILL.md +19 -16
  158. package/.agent/skills/system-design-pro/SKILL.md +21 -26
  159. package/.agent/skills/systematic-debugging/SKILL.md +19 -60
  160. package/.agent/skills/systematic-debugging/condition-based-waiting.md +115 -0
  161. package/.agent/skills/systematic-debugging/defense-in-depth.md +122 -0
  162. package/.agent/skills/systematic-debugging/root-cause-tracing.md +169 -0
  163. package/.agent/skills/tailwind-patterns/SKILL.md +8 -58
  164. package/.agent/skills/taste-skill/SKILL.md +19 -16
  165. package/.agent/skills/tdd-workflow/SKILL.md +65 -25
  166. package/.agent/skills/test-result-analyzer/SKILL.md +9 -59
  167. package/.agent/skills/testing-patterns/SKILL.md +8 -58
  168. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +19 -18
  169. package/.agent/skills/thinking-protocol/SKILL.md +33 -2
  170. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +19 -15
  171. package/.agent/skills/transitions-dev/SKILL.md +19 -15
  172. package/.agent/skills/trend-researcher/SKILL.md +9 -59
  173. package/.agent/skills/typescript-advanced/SKILL.md +21 -64
  174. package/.agent/skills/typeset/SKILL.md +19 -16
  175. package/.agent/skills/ui-reasoning-engine/SKILL.md +27 -8
  176. package/.agent/skills/ui-skill-packs/SKILL.md +26 -16
  177. package/.agent/skills/ui-skills-root/SKILL.md +22 -14
  178. package/.agent/skills/ui-ux-pro-max/SKILL.md +38 -12
  179. package/.agent/skills/ui-ux-researcher/SKILL.md +9 -59
  180. package/.agent/skills/vector-search-pgvector/SKILL.md +31 -5
  181. package/.agent/skills/verification-before-completion/SKILL.md +125 -0
  182. package/.agent/skills/vue-expert/SKILL.md +9 -57
  183. package/.agent/skills/vulnerability-scanner/SKILL.md +8 -58
  184. package/.agent/skills/web-accessibility-auditor/SKILL.md +9 -59
  185. package/.agent/skills/web-design-guidelines/SKILL.md +27 -7
  186. package/.agent/skills/web-quality-audit/SKILL.md +19 -16
  187. package/.agent/skills/webapp-testing/SKILL.md +9 -59
  188. package/.agent/skills/webgpu-performance/SKILL.md +9 -28
  189. package/.agent/skills/whimsy-injector/SKILL.md +9 -57
  190. package/.agent/skills/workflow-optimizer/SKILL.md +9 -57
  191. package/.agent/skills/zero-trust-passkeys/SKILL.md +31 -5
  192. package/.agent/templates/DESIGN.md +680 -160
  193. package/.agent/templates/sdd/implementer-prompt.md +53 -0
  194. package/.agent/templates/sdd/re-review-prompt.md +28 -0
  195. package/.agent/templates/sdd/task-reviewer-prompt.md +59 -0
  196. package/.agent/workflows/acf.md +4 -0
  197. package/.agent/workflows/api-tester.md +5 -0
  198. package/.agent/workflows/audit.md +5 -0
  199. package/.agent/workflows/brainstorm.md +17 -1
  200. package/.agent/workflows/changelog.md +5 -0
  201. package/.agent/workflows/contract.md +19 -0
  202. package/.agent/workflows/create.md +6 -1
  203. package/.agent/workflows/debug.md +5 -0
  204. package/.agent/workflows/deploy.md +6 -1
  205. package/.agent/workflows/enhance.md +6 -1
  206. package/.agent/workflows/fix-ci.md +5 -0
  207. package/.agent/workflows/fix.md +5 -0
  208. package/.agent/workflows/generate.md +5 -0
  209. package/.agent/workflows/marathon.md +6 -1
  210. package/.agent/workflows/migrate.md +5 -0
  211. package/.agent/workflows/minimal.md +4 -0
  212. package/.agent/workflows/orchestrate.md +6 -1
  213. package/.agent/workflows/performance-benchmarker.md +6 -1
  214. package/.agent/workflows/pipeline.md +5 -0
  215. package/.agent/workflows/plan.md +6 -1
  216. package/.agent/workflows/preview.md +6 -1
  217. package/.agent/workflows/refactor.md +6 -0
  218. package/.agent/workflows/review-ai.md +5 -0
  219. package/.agent/workflows/review.md +5 -0
  220. package/.agent/workflows/sdd.md +122 -0
  221. package/.agent/workflows/session.md +5 -0
  222. package/.agent/workflows/status.md +4 -0
  223. package/.agent/workflows/super-prompt.md +4 -0
  224. package/.agent/workflows/swarm.md +6 -1
  225. package/.agent/workflows/test.md +6 -1
  226. package/.agent/workflows/tribunal-backend.md +5 -0
  227. package/.agent/workflows/tribunal-cicd.md +5 -0
  228. package/.agent/workflows/tribunal-database.md +5 -0
  229. package/.agent/workflows/tribunal-full.md +8 -0
  230. package/.agent/workflows/tribunal-mobile.md +5 -0
  231. package/.agent/workflows/tribunal-performance.md +5 -0
  232. package/.agent/workflows/tribunal-speed.md +5 -0
  233. package/.agent/workflows/tribunal-ui.md +7 -0
  234. package/.agents/plugins/marketplace.json +20 -0
  235. package/.claude-plugin/marketplace.json +17 -0
  236. package/.claude-plugin/plugin.json +26 -0
  237. package/.codex-plugin/plugin.json +45 -0
  238. package/.cursor-plugin/plugin.json +26 -0
  239. package/.devin-plugin/plugin.json +14 -0
  240. package/.hermes-plugin/__init__.py +102 -0
  241. package/.hermes-plugin/plugin.yaml +6 -0
  242. package/.kimi-plugin/plugin.json +38 -0
  243. package/.opencode/INSTALL.md +41 -0
  244. package/.opencode/plugins/tribunal.js +101 -0
  245. package/.pi/extensions/tribunal.ts +133 -0
  246. package/CONTRIBUTING.md +1 -1
  247. package/README.md +246 -221
  248. package/bin/wrapper.js +1 -0
  249. package/dist/cli.js +355 -355
  250. package/dist/esm/index.mjs +142 -142
  251. package/dist/index.d.ts +349 -343
  252. package/gemini-extension.json +6 -0
  253. package/hooks/hooks-cursor.json +16 -0
  254. package/hooks/hooks.json +16 -0
  255. package/hooks/session-start.js +77 -0
  256. package/package.json +165 -146
  257. package/scripts/audit_skill_sdo.js +87 -0
  258. package/scripts/modernize_skills.js +254 -0
@@ -2,8 +2,8 @@
2
2
  name: opentelemetry-observability
3
3
  description: Full-stack distributed tracing, metrics, OpenTelemetry (OTel), Prometheus, Grafana Tempo, and zero-overhead observability instrumentation.
4
4
  tools: Read, Grep, Glob, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-08-05
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  script: .agent/scripts/test_runner.js
8
8
  scripts-binding:
9
9
  - .agent/scripts/test_runner.js
@@ -23,6 +23,12 @@ Before instrumenting applications:
23
23
  2. Trace Propagation → Propagate `traceparent` W3C headers across HTTP and message queues
24
24
  3. Sampling Policy → Implement head/tail sampling to reduce telemetry storage costs by 80%
25
25
 
26
+
27
+ ## Activation Boundaries
28
+
29
+ - **Activate when:** Operating in tasks requiring Full-stack distributed tracing, metrics, OpenTelemetry (OTel), Prometheus, Grafana Tempo, and zero-overhead observability instrumentation..
30
+ - **DO NOT activate when:** The task falls strictly outside opentelemetry-observability domain or belongs to a different dedicated specialist.
31
+
26
32
  ## Custom Trace & Meter Instrumentation (TypeScript)
27
33
 
28
34
  ```typescript
@@ -53,7 +59,27 @@ export async function handleLogin(userId: string) {
53
59
  }
54
60
  ```
55
61
 
56
- ## 🛑 Verification-Before-Completion (VBC) Protocol
62
+ ---
63
+
64
+ ## 🏛️ Tribunal Verification & Guardrails
65
+
66
+ **Slash command: `/review` or `/tribunal-full`**
67
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
68
+
69
+ ### ❌ Forbidden AI Tropes
70
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
71
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
72
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
73
+
74
+ ### ✅ Pre-Flight Self-Audit
75
+ ```
76
+ ✅ Did I rely ONLY on real, verified tools and methods?
77
+ ✅ Is this solution appropriately scoped to the user's constraints?
78
+ ✅ Did I handle potential failure modes and edge cases?
79
+ ✅ Have I avoided generic boilerplate that doesn't add value?
80
+ ```
57
81
 
58
- - Verify traces connect seamlessly from frontend click to DB query.
59
- - Confirm telemetry exporter overhead adds < 1ms latency to HTTP handlers.
82
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
83
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
84
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
85
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: page-transition-animation
3
3
  description: Page and route transition patterns using the native View Transitions API, Framer Motion AnimatePresence, and Next.js App Router exit animations.
4
- version: 3.0.0
5
- last-updated: 2026-07-30
4
+ version: 4.0.0
5
+ last-updated: 2026-09-07
6
6
  skills:
7
7
  - framer-motion-expert
8
8
  - 60fps-animation
@@ -27,6 +27,12 @@ Before engineering route or page transitions, you MUST inspect:
27
27
 
28
28
  Architect smooth, seamless page and route transitions without layout jumps or frozen exit states.
29
29
 
30
+
31
+ ## Activation Boundaries
32
+
33
+ - **Activate when:** Operating in tasks requiring Page and route transition patterns using the native View Transitions API, Framer Motion AnimatePresence, and Next.js App Router exit animations..
34
+ - **DO NOT activate when:** The task falls strictly outside page-transition-animation domain or belongs to a different dedicated specialist.
35
+
30
36
  ---
31
37
 
32
38
  ## 3 Page Transition Architectures
@@ -93,28 +99,25 @@ export function RouteLayoutWrapper({ children }: { children: React.ReactNode })
93
99
 
94
100
  ---
95
101
 
96
- ## 🤖 LLM-Specific Traps
102
+ ## 🏛️ Tribunal Verification & Guardrails
97
103
 
98
- 1. **Broken Next.js App Router Exits**: Forgetting to set a unique `key={pathname}` on `AnimatePresence` children, causing exit animations to be skipped entirely.
99
- 2. **Excessive Vertical Displacement**: Animating pages from `y: 100px` down, causing jarring vertical scroll shifts. Keep route shifts under `12px`.
100
-
101
- ---
104
+ **Slash command: `/review` or `/tribunal-full`**
105
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
102
106
 
103
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
104
-
105
- **Active reviewers: `motion-reviewer` · `frontend-reviewer`**
107
+ ### Forbidden AI Tropes
108
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
109
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
110
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
106
111
 
107
112
  ### ✅ Pre-Flight Self-Audit
108
-
109
113
  ```
110
- Is `document.startViewTransition` feature-detected with fallback for older browsers?
111
- ✅ Is `mode="wait"` set on `AnimatePresence` to prevent double-page DOM stacking?
112
- Is vertical page movement subtle ($\le 12\text{px}$) during transitions?
114
+ Did I rely ONLY on real, verified tools and methods?
115
+ ✅ Is this solution appropriately scoped to the user's constraints?
116
+ Did I handle potential failure modes and edge cases?
117
+ ✅ Have I avoided generic boilerplate that doesn't add value?
113
118
  ```
114
119
 
115
120
  ### 🛑 Verification-Before-Completion (VBC) Protocol
116
-
117
121
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
118
-
119
122
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
120
123
  - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: parallel-agents
3
3
  description: Parallel processing coordination for multi-agent swarms. Asynchronous dispatches, merging divergent logic streams, race conditions in autonomous agents, avoiding Git conflicts in concurrent generation, and fan-out/fan-in processing patterns. Use when orchestrating multiple agents simultaneously.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - agent-organizer
9
9
  - fabel-protocol
@@ -25,6 +25,12 @@ Before executing parallel agent dispatches, you MUST inspect:
25
25
  2. `Promise.allSettled()` error handling (Section 77) → Handle partial worker failures gracefully without crashing the pipeline
26
26
  3. Context Window Budget → Keep total context across all parallel workers under 80,000 tokens
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Parallel processing coordination for multi-agent swarms. Asynchronous dispatches, merging divergent logic streams, race conditions in autonomous agents, avoiding Git conflicts in concurrent generation, and fan-out/fan-in processing patterns. Use when orchestrating multiple agents simultaneously..
32
+ - **DO NOT activate when:** The task falls strictly outside parallel-agents domain or belongs to a different dedicated specialist.
33
+
28
34
  ---
29
35
 
30
36
  ## Hallucination Traps (Read First)
@@ -35,8 +41,6 @@ Before executing parallel agent dispatches, you MUST inspect:
35
41
 
36
42
  ---
37
43
 
38
- # Parallel Agents — Concurrent Orchestration Mastery
39
-
40
44
  ---
41
45
 
42
46
  ## 1. Fan-Out / Fan-In Pattern
@@ -128,69 +132,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
128
132
 
129
133
  ---
130
134
 
131
- **Slash command: `/review` or `/tribunal-full`**
132
- **Active reviewers: `logic-reviewer` · `security-auditor`**
133
-
134
- ### ❌ Forbidden AI Tropes
135
-
136
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
137
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
138
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
139
-
140
- Review these questions before confirming output:
141
-
142
- ```
143
- ✅ Did I rely ONLY on real, verified tools and methods?
144
- ✅ Is this solution appropriately scoped to the user's constraints?
145
- ✅ Did I handle potential failure modes and edge cases?
146
- ✅ Have I avoided generic boilerplate that doesn't add value?
147
- ```
148
-
149
- ### 🛑 Verification-Before-Completion (VBC) Protocol
150
-
151
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
152
-
153
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
154
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
155
-
156
- ## Pre-Flight Checklist
157
-
158
- - [ ] Have I reviewed the user's specific constraints and requests?
159
- - [ ] Have I checked the environment for relevant existing implementations?
160
-
161
- ## VBC Protocol (Verification-Before-Completion)
162
-
163
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
164
-
165
- ---
166
-
167
- ## 🤖 LLM-Specific Traps
168
-
169
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
170
-
171
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
172
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
173
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
174
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
175
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
176
-
177
- ---
178
-
179
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
135
+ ## 🏛️ Tribunal Verification & Guardrails
180
136
 
181
137
  **Slash command: `/review` or `/tribunal-full`**
182
138
  **Active reviewers: `logic-reviewer` · `security-auditor`**
183
139
 
184
140
  ### ❌ Forbidden AI Tropes
185
-
186
141
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
187
142
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
188
143
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
189
144
 
190
145
  ### ✅ Pre-Flight Self-Audit
191
-
192
- Review these questions before confirming output:
193
-
194
146
  ```
195
147
  ✅ Did I rely ONLY on real, verified tools and methods?
196
148
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -199,8 +151,6 @@ Review these questions before confirming output:
199
151
  ```
200
152
 
201
153
  ### 🛑 Verification-Before-Completion (VBC) Protocol
202
-
203
154
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
204
-
205
155
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
206
156
  - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: performance-profiling
3
3
  description: Performance profiling mastery. Core Web Vitals (LCP, CLS, INP), Lighthouse auditing, JavaScript profiling, React rendering optimization, bundle analysis, memory leak detection, database query profiling (EXPLAIN ANALYZE), load testing, and performance budgets. Use when optimizing performance, debugging slow pages, or establishing performance standards.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - 60fps-animation
9
9
  - gsap-performance
@@ -25,7 +25,11 @@ Before optimizing performance or auditing benchmarks, you MUST inspect:
25
25
  2. Bundle Size Limits & Import Tree-Shaking (Section 55) → Enforce total gzipped JS $<200\text{KB}$; use deep imports (`lodash/debounce`) instead of full barrel imports
26
26
  3. SQL EXPLAIN ANALYZE Requirement (Section 156) → Profile database queries with `EXPLAIN ANALYZE` before making index or query optimization changes
27
27
 
28
- # Performance Profiling — Measurement-Driven Optimization
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Performance profiling mastery. Core Web Vitals (LCP, CLS, INP), Lighthouse auditing, JavaScript profiling, React rendering optimization, bundle analysis, memory leak detection, database query profiling (EXPLAIN ANALYZE), load testing, and performance budgets. Use when optimizing performance, debugging slow pages, or establishing performance standards..
32
+ - **DO NOT activate when:** The task falls strictly outside performance-profiling domain or belongs to a different dedicated specialist.
29
33
 
30
34
  ---
31
35
 
@@ -248,69 +252,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
248
252
 
249
253
  ---
250
254
 
251
- **Slash command: `/review` or `/tribunal-full`**
252
- **Active reviewers: `logic-reviewer` · `security-auditor`**
253
-
254
- ### ❌ Forbidden AI Tropes
255
-
256
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
257
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
258
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
259
-
260
- Review these questions before confirming output:
261
-
262
- ```
263
- ✅ Did I rely ONLY on real, verified tools and methods?
264
- ✅ Is this solution appropriately scoped to the user's constraints?
265
- ✅ Did I handle potential failure modes and edge cases?
266
- ✅ Have I avoided generic boilerplate that doesn't add value?
267
- ```
268
-
269
- ### 🛑 Verification-Before-Completion (VBC) Protocol
270
-
271
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
272
-
273
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
274
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
275
-
276
- ## Pre-Flight Checklist
277
-
278
- - [ ] Have I reviewed the user's specific constraints and requests?
279
- - [ ] Have I checked the environment for relevant existing implementations?
280
-
281
- ## VBC Protocol (Verification-Before-Completion)
282
-
283
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
284
-
285
- ---
286
-
287
- ## 🤖 LLM-Specific Traps
288
-
289
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
290
-
291
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
292
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
293
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
294
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
295
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
296
-
297
- ---
298
-
299
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
255
+ ## 🏛️ Tribunal Verification & Guardrails
300
256
 
301
257
  **Slash command: `/review` or `/tribunal-full`**
302
258
  **Active reviewers: `logic-reviewer` · `security-auditor`**
303
259
 
304
260
  ### ❌ Forbidden AI Tropes
305
-
306
261
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
307
262
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
308
263
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
309
264
 
310
265
  ### ✅ Pre-Flight Self-Audit
311
-
312
- Review these questions before confirming output:
313
-
314
266
  ```
315
267
  ✅ Did I rely ONLY on real, verified tools and methods?
316
268
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -319,8 +271,6 @@ Review these questions before confirming output:
319
271
  ```
320
272
 
321
273
  ### 🛑 Verification-Before-Completion (VBC) Protocol
322
-
323
274
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
324
-
325
275
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
326
276
  - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: plan-writing
3
3
  description: Technical design and implementation planning mastery. Writing structured execution checklists, dependency mapping, establishing rollback protocols, segmenting monolithic tasks, writing ADRs (Architecture Decision Records), and defining verification criteria. Use when transitioning from ideation to coordinated execution.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - project-planner
9
9
  - brainstorming
@@ -21,19 +21,34 @@ scripts-binding:
21
21
 
22
22
  Before writing implementation plans or execution blueprints, you MUST inspect:
23
23
 
24
- 1. Verification Criteria Requirement (Section 15) Include explicit "How to verify" criteria for every wave; ban plan steps without verification
25
- 2. Phased Wave Segmentation (Section 41) Segment multi-file tasks into testable, independent waves (Wave 1: Data, Wave 2: API, Wave 3: UI)
26
- 3. Non-Destructive Defaults & Rollback Rules (Section 66) Define fallback feature toggles and database rollback procedures prior to execution
24
+ 1. The Task Contract Requirement → Formulate Objective, Inputs, Outputs, Hard Constraints, and Acceptance Criteria before outlining file edits
25
+ 2. Verification Criteria Requirement Include explicit "How to verify" commands (unit tests, curl, linter) for every execution step; ban unverified plan steps
26
+ 3. Phased Wave Segmentation → Segment multi-file tasks into testable, independent waves (Wave 1: Data, Wave 2: Logic/API, Wave 3: UI, Wave 4: Audit)
27
+ 4. Non-Destructive Defaults & Rollback Rules → Define fallback feature toggles and database migration rollback procedures prior to execution
27
28
 
28
- ## Hallucination Traps (Read First)
29
+ ## Activation Boundaries
29
30
 
30
- - Writing plans without verification criteria -> Every plan needs a 'How to verify this worked' section
31
- - Planning at the wrong granularity (too high or too low) -> Plans should be at the component/feature level, not line-by-line or system-wide
32
- - ❌ Skipping the 'What could go wrong' section -> ✅ Identifying failure modes before implementation prevents costly rework
31
+ - **Activate when:** Preparing complex multi-file architectural changes, writing implementation plans, establishing ADRs, segmenting large tasks into execution waves, and defining verification strategies.
32
+ - **DO NOT activate when:** Executing small single-file typo fixes, simple CSS tweaks, or answering conceptual questions without code changes.
33
33
 
34
- ---
34
+ ## 2026 Plan Writing & Task Contract Invariants
35
35
 
36
- # Plan Writing Execution Blueprints Mastery
36
+ 1. **The Strict Task Contract**:
37
+ Every plan must establish:
38
+ - **OBJECTIVE**: Precise outcome expected.
39
+ - **HARD CONSTRAINTS**: Unchangeable tech stack, performance budgets, backwards compatibility.
40
+ - **ACCEPTANCE CRITERIA**: Unambiguous, observable conditions proving success (e.g. `npm test exits 0`, `LCP < 1.2s`).
41
+ 2. **Chunking Limit (Max 5 Files Per Wave)**:
42
+ Never generate a single wave touching > 5 files. Break large epics into consecutive waves where each wave compiles and passes verification before proceeding.
43
+ 3. **Evidence-Based Closeout**:
44
+ Every wave ends with an automated command the agent or human must run to prove correctness before proceeding to the next wave.
45
+
46
+ ## Hallucination Traps (Read First)
47
+
48
+ - ❌ Writing plans without verification criteria → ✅ Every plan needs a 'How to verify this worked' section
49
+ - ❌ Planning at the wrong granularity (too high or too low) → ✅ Plans should be at the component/feature level
50
+ - ❌ Skipping the 'What could go wrong' section → ✅ Identifying failure modes before implementation prevents costly rework
51
+ - ❌ Multi-file mega plans without wave chunking → ✅ Break into independent, testable waves
37
52
 
38
53
  ---
39
54
 
@@ -45,9 +60,15 @@ Before altering multiple files or introducing a new system architecture, a rigid
45
60
 
46
61
  1. **Objective Context:** 2-sentence summary of the requested goal.
47
62
  2. **Architectural Handoff:** (What stack, what libraries, what constraints).
48
- 3. **Dependency Tree Execution Order:** (Cannot build frontend UI until backend API exists).
49
- 4. **File Blueprint:** Exact files expected to be touched (`[NEW] src/api/user.ts`, `[MODIFY] src/db/schema.prisma`).
50
- 5. **Verification Protocol:** Exactly how the agent/human will prove the task is completed successfully.
63
+ 3. **Task-Level Interface Contracts (Mandatory for Subagent Decoupling):**
64
+ Every task MUST declare:
65
+ - `Consumes:` Exact function signatures and types it imports from prior tasks.
66
+ - `Produces:` Exact function signatures and types it exports for subsequent tasks.
67
+ 4. **The Zero-Placeholder Invariant:**
68
+ Never write "TBD", "TODO", "implement later", "add validation", or "write tests for above". Every step must contain complete, exact code blocks and verification commands.
69
+ 5. **Dependency Tree Execution Order:** (Cannot build frontend UI until backend API exists).
70
+ 6. **File Blueprint:** Exact files expected to be touched (`[NEW] src/api/user.ts`, `[MODIFY] src/db/schema.prisma`).
71
+ 7. **Verification Protocol:** Exactly how the agent/human will prove the task is completed successfully.
51
72
 
52
73
  ---
53
74
 
@@ -129,69 +150,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
129
150
 
130
151
  ---
131
152
 
132
- **Slash command: `/review` or `/tribunal-full`**
133
- **Active reviewers: `logic-reviewer` · `security-auditor`**
134
-
135
- ### ❌ Forbidden AI Tropes
136
-
137
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
138
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
139
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
140
-
141
- Review these questions before confirming output:
142
-
143
- ```
144
- ✅ Did I rely ONLY on real, verified tools and methods?
145
- ✅ Is this solution appropriately scoped to the user's constraints?
146
- ✅ Did I handle potential failure modes and edge cases?
147
- ✅ Have I avoided generic boilerplate that doesn't add value?
148
- ```
149
-
150
- ### 🛑 Verification-Before-Completion (VBC) Protocol
151
-
152
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
153
-
154
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
155
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
156
-
157
- ## Pre-Flight Checklist
158
-
159
- - [ ] Have I reviewed the user's specific constraints and requests?
160
- - [ ] Have I checked the environment for relevant existing implementations?
161
-
162
- ## VBC Protocol (Verification-Before-Completion)
163
-
164
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
165
-
166
- ---
167
-
168
- ## 🤖 LLM-Specific Traps
169
-
170
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
171
-
172
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
173
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
174
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
175
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
176
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
177
-
178
- ---
179
-
180
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
153
+ ## 🏛️ Tribunal Verification & Guardrails
181
154
 
182
155
  **Slash command: `/review` or `/tribunal-full`**
183
156
  **Active reviewers: `logic-reviewer` · `security-auditor`**
184
157
 
185
158
  ### ❌ Forbidden AI Tropes
186
-
187
159
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
188
160
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
189
161
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
190
162
 
191
163
  ### ✅ Pre-Flight Self-Audit
192
-
193
- Review these questions before confirming output:
194
-
195
164
  ```
196
165
  ✅ Did I rely ONLY on real, verified tools and methods?
197
166
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -200,8 +169,6 @@ Review these questions before confirming output:
200
169
  ```
201
170
 
202
171
  ### 🛑 Verification-Before-Completion (VBC) Protocol
203
-
204
172
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
205
-
206
173
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
207
174
  - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: platform-engineer
3
3
  description: Platform Engineering and Internal Developer Portal (IDP) mastery. Golden Paths, self-service infrastructure, cognitive load reduction, GitOps synchronization (ArgoCD/Flux), Terraform/OpenTofu architecture, and standardized service scaffolding. Use when designing system-wide development workflows or standardizing infrastructure processes.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - cloud-architect
9
9
  - devops-engineer
@@ -25,6 +25,12 @@ Before designing developer platforms or GitOps manifests, you MUST inspect:
25
25
  2. GitOps Continuous Reconciliation (Section 48) → Enforce declarative GitOps (`selfHeal: true`) via ArgoCD/Flux; ban manual `kubectl apply` or console modifications
26
26
  3. Higher-Level Terraform Modules (Section 76) → Encapsulate complex IaC logic into simple interface modules (`capacity`, `needs_replica`) to reduce cognitive load
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Platform Engineering and Internal Developer Portal (IDP) mastery. Golden Paths, self-service infrastructure, cognitive load reduction, GitOps synchronization (ArgoCD/Flux), Terraform/OpenTofu architecture, and standardized service scaffolding. Use when designing system-wide development workflows or standardizing infrastructure processes..
32
+ - **DO NOT activate when:** The task falls strictly outside platform-engineer domain or belongs to a different dedicated specialist.
33
+
28
34
  ## Hallucination Traps (Read First)
29
35
 
30
36
  - ❌ Building internal platforms without talking to developers -> ✅ Platform engineering exists to reduce developer cognitive load; ask them what hurts
@@ -33,8 +39,6 @@ Before designing developer platforms or GitOps manifests, you MUST inspect:
33
39
 
34
40
  ---
35
41
 
36
- # Platform Engineering — Developer Experience Mastery
37
-
38
42
  ---
39
43
 
40
44
  ## 1. The "Golden Path" Architecture
@@ -127,69 +131,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
127
131
 
128
132
  ---
129
133
 
130
- **Slash command: `/review` or `/tribunal-full`**
131
- **Active reviewers: `logic-reviewer` · `security-auditor`**
132
-
133
- ### ❌ Forbidden AI Tropes
134
-
135
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
136
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
137
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
138
-
139
- Review these questions before confirming output:
140
-
141
- ```
142
- ✅ Did I rely ONLY on real, verified tools and methods?
143
- ✅ Is this solution appropriately scoped to the user's constraints?
144
- ✅ Did I handle potential failure modes and edge cases?
145
- ✅ Have I avoided generic boilerplate that doesn't add value?
146
- ```
147
-
148
- ### 🛑 Verification-Before-Completion (VBC) Protocol
149
-
150
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
151
-
152
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
153
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
154
-
155
- ## Pre-Flight Checklist
156
-
157
- - [ ] Have I reviewed the user's specific constraints and requests?
158
- - [ ] Have I checked the environment for relevant existing implementations?
159
-
160
- ## VBC Protocol (Verification-Before-Completion)
161
-
162
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
163
-
164
- ---
165
-
166
- ## 🤖 LLM-Specific Traps
167
-
168
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
169
-
170
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
171
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
172
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
173
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
174
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
175
-
176
- ---
177
-
178
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
134
+ ## 🏛️ Tribunal Verification & Guardrails
179
135
 
180
136
  **Slash command: `/review` or `/tribunal-full`**
181
137
  **Active reviewers: `logic-reviewer` · `security-auditor`**
182
138
 
183
139
  ### ❌ Forbidden AI Tropes
184
-
185
140
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
186
141
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
187
142
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
188
143
 
189
144
  ### ✅ Pre-Flight Self-Audit
190
-
191
- Review these questions before confirming output:
192
-
193
145
  ```
194
146
  ✅ Did I rely ONLY on real, verified tools and methods?
195
147
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -198,8 +150,6 @@ Review these questions before confirming output:
198
150
  ```
199
151
 
200
152
  ### 🛑 Verification-Before-Completion (VBC) Protocol
201
-
202
153
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
203
-
204
154
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
205
155
  - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: platform-engineering-opentofu
3
3
  description: Infrastructure as Code (IaC) with OpenTofu/Terraform/Pulumi, automated cloud provisioning, DevSecOps pipelines, and self-service platform engineering.
4
4
  tools: Read, Grep, Glob, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-08-05
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  script: .agent/scripts/verify_all.js
8
8
  scripts-binding:
9
9
  - .agent/scripts/security_scan.js
@@ -24,6 +24,12 @@ Before provisioning cloud infrastructure:
24
24
  2. Least Privilege IAM → Enforce strict role-based access control (RBAC) on all cloud resources
25
25
  3. Plan Validation → Run `tofu plan` and static security analysis (tfsec/checkov) before `tofu apply`
26
26
 
27
+
28
+ ## Activation Boundaries
29
+
30
+ - **Activate when:** Operating in tasks requiring Infrastructure as Code (IaC) with OpenTofu/Terraform/Pulumi, automated cloud provisioning, DevSecOps pipelines, and self-service platform engineering..
31
+ - **DO NOT activate when:** The task falls strictly outside platform-engineering-opentofu domain or belongs to a different dedicated specialist.
32
+
27
33
  ## Production AWS VPC & ECS Module Blueprint
28
34
 
29
35
  ```hcl
@@ -62,7 +68,27 @@ resource "aws_subnet" "public_a" {
62
68
  }
63
69
  ```
64
70
 
65
- ## 🛑 Verification-Before-Completion (VBC) Protocol
71
+ ---
72
+
73
+ ## 🏛️ Tribunal Verification & Guardrails
74
+
75
+ **Slash command: `/review` or `/tribunal-full`**
76
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
77
+
78
+ ### ❌ Forbidden AI Tropes
79
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
80
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
81
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
82
+
83
+ ### ✅ Pre-Flight Self-Audit
84
+ ```
85
+ ✅ Did I rely ONLY on real, verified tools and methods?
86
+ ✅ Is this solution appropriately scoped to the user's constraints?
87
+ ✅ Did I handle potential failure modes and edge cases?
88
+ ✅ Have I avoided generic boilerplate that doesn't add value?
89
+ ```
66
90
 
67
- - Run `tofu validate` and security scan before applying changes.
68
- - Ensure rollback plan is explicitly documented.
91
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
92
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
93
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
94
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.