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.
- package/.agent/ARCHITECTURE.md +2 -2
- package/.agent/config/plugin.json +4 -4
- package/.agent/config/system-prompt.md +54 -1
- package/.agent/routing_index.json +2 -2
- package/.agent/skills/12-principles-of-animation/SKILL.md +19 -16
- package/.agent/skills/60fps-animation/SKILL.md +47 -21
- package/.agent/skills/accessible-animation/SKILL.md +19 -16
- package/.agent/skills/adapt/SKILL.md +19 -16
- package/.agent/skills/advanced-rag-pipelines/SKILL.md +41 -40
- package/.agent/skills/agent-organizer/SKILL.md +9 -59
- package/.agent/skills/agentic-patterns/SKILL.md +9 -57
- package/.agent/skills/agentic-workflows-2026/SKILL.md +45 -8
- package/.agent/skills/ai-app-hardening/SKILL.md +31 -5
- package/.agent/skills/ai-prompt-injection-defense/SKILL.md +28 -66
- package/.agent/skills/animation-on-scroll/SKILL.md +19 -16
- package/.agent/skills/animation-systems/SKILL.md +19 -15
- package/.agent/skills/antfu-conventions/SKILL.md +19 -18
- package/.agent/skills/api-patterns/SKILL.md +8 -58
- package/.agent/skills/api-security-auditor/SKILL.md +8 -58
- package/.agent/skills/app-builder/SKILL.md +9 -59
- package/.agent/skills/appflow-wireframe/SKILL.md +13 -57
- package/.agent/skills/apple-design/SKILL.md +22 -14
- package/.agent/skills/architecture/SKILL.md +9 -59
- package/.agent/skills/audit-and-fix/SKILL.md +19 -16
- package/.agent/skills/authentication-best-practices/SKILL.md +8 -58
- package/.agent/skills/backend-security-expert/SKILL.md +32 -65
- package/.agent/skills/baseline-ui/SKILL.md +22 -14
- package/.agent/skills/bash-linux/SKILL.md +9 -59
- package/.agent/skills/behavioral-modes/SKILL.md +9 -57
- package/.agent/skills/better-colors/SKILL.md +22 -14
- package/.agent/skills/better-typography/SKILL.md +26 -14
- package/.agent/skills/better-ui/SKILL.md +54 -19
- package/.agent/skills/bolder/SKILL.md +19 -16
- package/.agent/skills/brainstorming/SKILL.md +9 -57
- package/.agent/skills/browser-native-ai/SKILL.md +9 -28
- package/.agent/skills/build-primitive/SKILL.md +19 -16
- package/.agent/skills/building-native-ui/SKILL.md +9 -59
- package/.agent/skills/cicd-pro/SKILL.md +21 -28
- package/.agent/skills/clarify/SKILL.md +19 -16
- package/.agent/skills/clean-code/SKILL.md +18 -61
- package/.agent/skills/cloud-architect/SKILL.md +21 -28
- package/.agent/skills/cobejs/SKILL.md +19 -15
- package/.agent/skills/code-review-checklist/SKILL.md +8 -58
- package/.agent/skills/codebase-design/SKILL.md +33 -22
- package/.agent/skills/colorize/SKILL.md +19 -16
- package/.agent/skills/compact-landing/SKILL.md +19 -16
- package/.agent/skills/company-logos/SKILL.md +19 -16
- package/.agent/skills/config-validator/SKILL.md +9 -59
- package/.agent/skills/containerization-pro/SKILL.md +21 -28
- package/.agent/skills/context-engineering-pro/SKILL.md +31 -5
- package/.agent/skills/create-design-md/SKILL.md +22 -14
- package/.agent/skills/critique/SKILL.md +20 -11
- package/.agent/skills/csharp-developer/SKILL.md +8 -58
- package/.agent/skills/data-validation-schemas/SKILL.md +9 -59
- package/.agent/skills/database-design/SKILL.md +27 -67
- package/.agent/skills/delight/SKILL.md +19 -16
- package/.agent/skills/deployment-procedures/SKILL.md +9 -59
- package/.agent/skills/design-lab/SKILL.md +19 -16
- package/.agent/skills/devops-engineer/SKILL.md +8 -58
- package/.agent/skills/devops-incident-responder/SKILL.md +9 -59
- package/.agent/skills/diagnosing-bugs/SKILL.md +20 -21
- package/.agent/skills/distill/SKILL.md +19 -16
- package/.agent/skills/documentation-templates/SKILL.md +9 -59
- package/.agent/skills/domain-modeling/SKILL.md +19 -18
- package/.agent/skills/duckdb-analytical-sql/SKILL.md +31 -5
- package/.agent/skills/edge-ai-mobile/SKILL.md +31 -5
- package/.agent/skills/edge-computing/SKILL.md +9 -59
- package/.agent/skills/emil-design-eng/SKILL.md +21 -24
- package/.agent/skills/error-resilience/SKILL.md +31 -66
- package/.agent/skills/expo-router-v4/SKILL.md +31 -5
- package/.agent/skills/extract-design-system/SKILL.md +9 -59
- package/.agent/skills/fabel-protocol/SKILL.md +26 -8
- package/.agent/skills/fixing-accessibility/SKILL.md +22 -14
- package/.agent/skills/fixing-metadata/SKILL.md +19 -16
- package/.agent/skills/fixing-motion-performance/SKILL.md +22 -14
- package/.agent/skills/framer-motion-expert/SKILL.md +9 -57
- package/.agent/skills/frontend-design/SKILL.md +27 -7
- package/.agent/skills/frontend-security-expert/SKILL.md +8 -58
- package/.agent/skills/game-design-expert/SKILL.md +9 -59
- package/.agent/skills/game-engineering-expert/SKILL.md +9 -59
- package/.agent/skills/generative-ui-expert/SKILL.md +9 -28
- package/.agent/skills/geo-fundamentals/SKILL.md +9 -59
- package/.agent/skills/git-pro/SKILL.md +19 -30
- package/.agent/skills/github-operations/SKILL.md +8 -58
- package/.agent/skills/gpt-taste/SKILL.md +19 -16
- package/.agent/skills/gsap-core/SKILL.md +8 -78
- package/.agent/skills/gsap-frameworks/SKILL.md +8 -78
- package/.agent/skills/gsap-performance/SKILL.md +9 -77
- package/.agent/skills/gsap-plugins/SKILL.md +9 -77
- package/.agent/skills/gsap-react/SKILL.md +9 -21
- package/.agent/skills/gsap-scrolltrigger/SKILL.md +8 -78
- package/.agent/skills/gsap-timeline/SKILL.md +9 -77
- package/.agent/skills/gsap-utils/SKILL.md +9 -77
- package/.agent/skills/harden/SKILL.md +19 -16
- package/.agent/skills/harness-protocol/SKILL.md +9 -21
- package/.agent/skills/i18n-localization/SKILL.md +9 -59
- package/.agent/skills/impeccable/SKILL.md +19 -18
- package/.agent/skills/improve-codebase-architecture/SKILL.md +19 -17
- package/.agent/skills/improve-ui/SKILL.md +22 -14
- package/.agent/skills/intelligent-routing/SKILL.md +9 -23
- package/.agent/skills/knowledge-graph/SKILL.md +9 -21
- package/.agent/skills/landing-page/SKILL.md +19 -16
- package/.agent/skills/lint-and-validate/SKILL.md +9 -59
- package/.agent/skills/llm-engineering/SKILL.md +8 -58
- package/.agent/skills/local-first/SKILL.md +9 -59
- package/.agent/skills/local-first-architecture/SKILL.md +37 -20
- package/.agent/skills/lottie-animation/SKILL.md +19 -15
- package/.agent/skills/marquee-loop/SKILL.md +19 -16
- package/.agent/skills/masked-reveal/SKILL.md +19 -15
- package/.agent/skills/mcp-builder/SKILL.md +9 -59
- package/.agent/skills/micro-interaction/SKILL.md +19 -16
- package/.agent/skills/mobile-design/SKILL.md +8 -58
- package/.agent/skills/monorepo-management/SKILL.md +9 -59
- package/.agent/skills/morphing-icons/SKILL.md +19 -15
- package/.agent/skills/motion-engineering/SKILL.md +22 -15
- package/.agent/skills/nextjs-react-expert/SKILL.md +35 -67
- package/.agent/skills/nodejs-best-practices/SKILL.md +34 -61
- package/.agent/skills/observability/SKILL.md +8 -58
- package/.agent/skills/opentelemetry-observability/SKILL.md +31 -5
- package/.agent/skills/page-transition-animation/SKILL.md +19 -16
- package/.agent/skills/parallel-agents/SKILL.md +9 -59
- package/.agent/skills/performance-profiling/SKILL.md +8 -58
- package/.agent/skills/plan-writing/SKILL.md +36 -69
- package/.agent/skills/platform-engineer/SKILL.md +9 -59
- package/.agent/skills/platform-engineering-opentofu/SKILL.md +31 -5
- package/.agent/skills/playwright-ai-e2e/SKILL.md +31 -5
- package/.agent/skills/playwright-best-practices/SKILL.md +9 -59
- package/.agent/skills/polish/SKILL.md +19 -16
- package/.agent/skills/powershell-windows/SKILL.md +8 -58
- package/.agent/skills/pricing-page/SKILL.md +19 -16
- package/.agent/skills/product-aware-heuristics/SKILL.md +27 -8
- package/.agent/skills/progressive-blur/SKILL.md +19 -16
- package/.agent/skills/project-idioms/SKILL.md +9 -59
- package/.agent/skills/property-based-testing/SKILL.md +31 -5
- package/.agent/skills/python-patterns/SKILL.md +9 -59
- package/.agent/skills/python-pro/SKILL.md +35 -67
- package/.agent/skills/quieter/SKILL.md +19 -16
- package/.agent/skills/react-doctor/SKILL.md +19 -16
- package/.agent/skills/react-specialist/SKILL.md +26 -65
- package/.agent/skills/readme-builder/SKILL.md +9 -59
- package/.agent/skills/realtime-patterns/SKILL.md +8 -58
- package/.agent/skills/red-team-tactics/SKILL.md +9 -59
- package/.agent/skills/redesign-skill/SKILL.md +19 -16
- package/.agent/skills/review-animations/SKILL.md +21 -25
- package/.agent/skills/rust-pro/SKILL.md +30 -61
- package/.agent/skills/seo-fundamentals/SKILL.md +9 -59
- package/.agent/skills/server-management/SKILL.md +9 -59
- package/.agent/skills/shadcn-ui-expert/SKILL.md +9 -59
- package/.agent/skills/shape/SKILL.md +19 -16
- package/.agent/skills/skill-creator/SKILL.md +36 -86
- package/.agent/skills/soft-skill/SKILL.md +19 -16
- package/.agent/skills/sounds-on-the-web/SKILL.md +19 -16
- package/.agent/skills/sql-pro/SKILL.md +47 -62
- package/.agent/skills/supabase-postgres-best-practices/SKILL.md +9 -59
- package/.agent/skills/svg-animation/SKILL.md +19 -15
- package/.agent/skills/swiftui-expert/SKILL.md +9 -59
- package/.agent/skills/swiss-design/SKILL.md +19 -16
- package/.agent/skills/system-design-pro/SKILL.md +21 -26
- package/.agent/skills/systematic-debugging/SKILL.md +19 -60
- package/.agent/skills/systematic-debugging/condition-based-waiting.md +115 -0
- package/.agent/skills/systematic-debugging/defense-in-depth.md +122 -0
- package/.agent/skills/systematic-debugging/root-cause-tracing.md +169 -0
- package/.agent/skills/tailwind-patterns/SKILL.md +8 -58
- package/.agent/skills/taste-skill/SKILL.md +19 -16
- package/.agent/skills/tdd-workflow/SKILL.md +65 -25
- package/.agent/skills/test-result-analyzer/SKILL.md +9 -59
- package/.agent/skills/testing-patterns/SKILL.md +8 -58
- package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +19 -18
- package/.agent/skills/thinking-protocol/SKILL.md +33 -2
- package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +19 -15
- package/.agent/skills/transitions-dev/SKILL.md +19 -15
- package/.agent/skills/trend-researcher/SKILL.md +9 -59
- package/.agent/skills/typescript-advanced/SKILL.md +21 -64
- package/.agent/skills/typeset/SKILL.md +19 -16
- package/.agent/skills/ui-reasoning-engine/SKILL.md +27 -8
- package/.agent/skills/ui-skill-packs/SKILL.md +26 -16
- package/.agent/skills/ui-skills-root/SKILL.md +22 -14
- package/.agent/skills/ui-ux-pro-max/SKILL.md +38 -12
- package/.agent/skills/ui-ux-researcher/SKILL.md +9 -59
- package/.agent/skills/vector-search-pgvector/SKILL.md +31 -5
- package/.agent/skills/verification-before-completion/SKILL.md +125 -0
- package/.agent/skills/vue-expert/SKILL.md +9 -57
- package/.agent/skills/vulnerability-scanner/SKILL.md +8 -58
- package/.agent/skills/web-accessibility-auditor/SKILL.md +9 -59
- package/.agent/skills/web-design-guidelines/SKILL.md +27 -7
- package/.agent/skills/web-quality-audit/SKILL.md +19 -16
- package/.agent/skills/webapp-testing/SKILL.md +9 -59
- package/.agent/skills/webgpu-performance/SKILL.md +9 -28
- package/.agent/skills/whimsy-injector/SKILL.md +9 -57
- package/.agent/skills/workflow-optimizer/SKILL.md +9 -57
- package/.agent/skills/zero-trust-passkeys/SKILL.md +31 -5
- package/.agent/templates/DESIGN.md +680 -160
- package/.agent/templates/sdd/implementer-prompt.md +53 -0
- package/.agent/templates/sdd/re-review-prompt.md +28 -0
- package/.agent/templates/sdd/task-reviewer-prompt.md +59 -0
- package/.agent/workflows/acf.md +4 -0
- package/.agent/workflows/api-tester.md +5 -0
- package/.agent/workflows/audit.md +5 -0
- package/.agent/workflows/brainstorm.md +17 -1
- package/.agent/workflows/changelog.md +5 -0
- package/.agent/workflows/contract.md +19 -0
- package/.agent/workflows/create.md +6 -1
- package/.agent/workflows/debug.md +5 -0
- package/.agent/workflows/deploy.md +6 -1
- package/.agent/workflows/enhance.md +6 -1
- package/.agent/workflows/fix-ci.md +5 -0
- package/.agent/workflows/fix.md +5 -0
- package/.agent/workflows/generate.md +5 -0
- package/.agent/workflows/marathon.md +6 -1
- package/.agent/workflows/migrate.md +5 -0
- package/.agent/workflows/minimal.md +4 -0
- package/.agent/workflows/orchestrate.md +6 -1
- package/.agent/workflows/performance-benchmarker.md +6 -1
- package/.agent/workflows/pipeline.md +5 -0
- package/.agent/workflows/plan.md +6 -1
- package/.agent/workflows/preview.md +6 -1
- package/.agent/workflows/refactor.md +6 -0
- package/.agent/workflows/review-ai.md +5 -0
- package/.agent/workflows/review.md +5 -0
- package/.agent/workflows/sdd.md +122 -0
- package/.agent/workflows/session.md +5 -0
- package/.agent/workflows/status.md +4 -0
- package/.agent/workflows/super-prompt.md +4 -0
- package/.agent/workflows/swarm.md +6 -1
- package/.agent/workflows/test.md +6 -1
- package/.agent/workflows/tribunal-backend.md +5 -0
- package/.agent/workflows/tribunal-cicd.md +5 -0
- package/.agent/workflows/tribunal-database.md +5 -0
- package/.agent/workflows/tribunal-full.md +8 -0
- package/.agent/workflows/tribunal-mobile.md +5 -0
- package/.agent/workflows/tribunal-performance.md +5 -0
- package/.agent/workflows/tribunal-speed.md +5 -0
- package/.agent/workflows/tribunal-ui.md +7 -0
- package/.agents/plugins/marketplace.json +20 -0
- package/.claude-plugin/marketplace.json +17 -0
- package/.claude-plugin/plugin.json +26 -0
- package/.codex-plugin/plugin.json +45 -0
- package/.cursor-plugin/plugin.json +26 -0
- package/.devin-plugin/plugin.json +14 -0
- package/.hermes-plugin/__init__.py +102 -0
- package/.hermes-plugin/plugin.yaml +6 -0
- package/.kimi-plugin/plugin.json +38 -0
- package/.opencode/INSTALL.md +41 -0
- package/.opencode/plugins/tribunal.js +101 -0
- package/.pi/extensions/tribunal.ts +133 -0
- package/CONTRIBUTING.md +1 -1
- package/README.md +246 -221
- package/bin/wrapper.js +1 -0
- package/dist/cli.js +355 -355
- package/dist/esm/index.mjs +142 -142
- package/dist/index.d.ts +349 -343
- package/gemini-extension.json +6 -0
- package/hooks/hooks-cursor.json +16 -0
- package/hooks/hooks.json +16 -0
- package/hooks/session-start.js +77 -0
- package/package.json +165 -146
- package/scripts/audit_skill_sdo.js +87 -0
- package/scripts/modernize_skills.js +254 -0
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
name: readme-builder
|
|
3
3
|
description: Interactive README.md generation specialist. Creates professional, structured README files with badges, installation guides, usage examples, screenshots, and contribution guidelines. Use when asked to create, update, or improve a README file.
|
|
4
4
|
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
5
|
-
version:
|
|
6
|
-
last-updated: 2026-07
|
|
5
|
+
version: 4.0.0
|
|
6
|
+
last-updated: 2026-09-07
|
|
7
7
|
skills:
|
|
8
8
|
- documentation-templates
|
|
9
9
|
- geo-fundamentals
|
|
@@ -25,6 +25,12 @@ Before generating or updating a README file, you MUST inspect:
|
|
|
25
25
|
2. Zero Placeholder Rule (Section 28) → Ban template placeholders (`[insert here]`); generate copy-paste ready code examples from actual project code
|
|
26
26
|
3. Hero Section Lead-With-Value (Section 164) → Lead with a single-sentence value proposition and visual trust badges; ban starting with just the title
|
|
27
27
|
|
|
28
|
+
|
|
29
|
+
## Activation Boundaries
|
|
30
|
+
|
|
31
|
+
- **Activate when:** Operating in tasks requiring Interactive README.md generation specialist. Creates professional, structured README files with badges, installation guides, usage examples, screenshots, and contribution guidelines. Use when asked to create, update, or improve a README file..
|
|
32
|
+
- **DO NOT activate when:** The task falls strictly outside readme-builder domain or belongs to a different dedicated specialist.
|
|
33
|
+
|
|
28
34
|
## Hallucination Traps (Read First)
|
|
29
35
|
|
|
30
36
|
- ❌ Starting a README with the project name as the only heading -> ✅ Lead with what the project DOES, not just what it IS
|
|
@@ -33,8 +39,6 @@ Before generating or updating a README file, you MUST inspect:
|
|
|
33
39
|
|
|
34
40
|
---
|
|
35
41
|
|
|
36
|
-
# README Builder Skill
|
|
37
|
-
|
|
38
42
|
---
|
|
39
43
|
|
|
40
44
|
## Ground Rules
|
|
@@ -289,69 +293,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
289
293
|
|
|
290
294
|
---
|
|
291
295
|
|
|
292
|
-
|
|
293
|
-
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
294
|
-
|
|
295
|
-
### ❌ Forbidden AI Tropes
|
|
296
|
-
|
|
297
|
-
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
298
|
-
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
299
|
-
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
300
|
-
|
|
301
|
-
Review these questions before confirming output:
|
|
302
|
-
|
|
303
|
-
```
|
|
304
|
-
✅ Did I rely ONLY on real, verified tools and methods?
|
|
305
|
-
✅ Is this solution appropriately scoped to the user's constraints?
|
|
306
|
-
✅ Did I handle potential failure modes and edge cases?
|
|
307
|
-
✅ Have I avoided generic boilerplate that doesn't add value?
|
|
308
|
-
```
|
|
309
|
-
|
|
310
|
-
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
311
|
-
|
|
312
|
-
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
313
|
-
|
|
314
|
-
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
315
|
-
- ✅ **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.
|
|
316
|
-
|
|
317
|
-
## Pre-Flight Checklist
|
|
318
|
-
|
|
319
|
-
- [ ] Have I reviewed the user's specific constraints and requests?
|
|
320
|
-
- [ ] Have I checked the environment for relevant existing implementations?
|
|
321
|
-
|
|
322
|
-
## VBC Protocol (Verification-Before-Completion)
|
|
323
|
-
|
|
324
|
-
You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
|
|
325
|
-
|
|
326
|
-
---
|
|
327
|
-
|
|
328
|
-
## 🤖 LLM-Specific Traps
|
|
329
|
-
|
|
330
|
-
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
331
|
-
|
|
332
|
-
1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
|
|
333
|
-
2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
|
|
334
|
-
3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
|
|
335
|
-
4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
336
|
-
5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
|
|
337
|
-
|
|
338
|
-
---
|
|
339
|
-
|
|
340
|
-
## 🏛️ Tribunal Integration (Anti-Hallucination)
|
|
296
|
+
## 🏛️ Tribunal Verification & Guardrails
|
|
341
297
|
|
|
342
298
|
**Slash command: `/review` or `/tribunal-full`**
|
|
343
299
|
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
344
300
|
|
|
345
301
|
### ❌ Forbidden AI Tropes
|
|
346
|
-
|
|
347
302
|
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
348
303
|
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
349
304
|
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
350
305
|
|
|
351
306
|
### ✅ Pre-Flight Self-Audit
|
|
352
|
-
|
|
353
|
-
Review these questions before confirming output:
|
|
354
|
-
|
|
355
307
|
```
|
|
356
308
|
✅ Did I rely ONLY on real, verified tools and methods?
|
|
357
309
|
✅ Is this solution appropriately scoped to the user's constraints?
|
|
@@ -360,8 +312,6 @@ Review these questions before confirming output:
|
|
|
360
312
|
```
|
|
361
313
|
|
|
362
314
|
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
363
|
-
|
|
364
315
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
365
|
-
|
|
366
316
|
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
367
317
|
- ✅ **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: realtime-patterns
|
|
3
3
|
description: Real-time application mastery. WebSockets, Server-Sent Events (SSE), CRDTs for conflict-free collaboration, presence systems, optimistic updates, live cursors, multiplayer state sync, reconnection strategies, and real-time database patterns (Supabase Realtime, Firebase). Use when building chat, live collaboration, dashboards, or multiplayer features.
|
|
4
4
|
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
5
|
-
version:
|
|
6
|
-
last-updated: 2026-07
|
|
5
|
+
version: 4.0.0
|
|
6
|
+
last-updated: 2026-09-07
|
|
7
7
|
skills:
|
|
8
8
|
- api-patterns
|
|
9
9
|
- backend-security-expert
|
|
@@ -25,7 +25,11 @@ Before architecting real-time streaming or WebSocket infrastructure, you MUST in
|
|
|
25
25
|
2. WebSocket Exponential Reconnection (Section 183) → Implement exponential backoff with random jitter for client reconnection loops to prevent thundering herd crashes
|
|
26
26
|
3. Optimistic UI Rollback Handler (Section 207) → Capture previous state before optimistic mutations and implement explicit onError rollback logic
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
|
|
29
|
+
## Activation Boundaries
|
|
30
|
+
|
|
31
|
+
- **Activate when:** Operating in tasks requiring Real-time application mastery. WebSockets, Server-Sent Events (SSE), CRDTs for conflict-free collaboration, presence systems, optimistic updates, live cursors, multiplayer state sync, reconnection strategies, and real-time database patterns (Supabase Realtime, Firebase). Use when building chat, live collaboration, dashboards, or multiplayer features..
|
|
32
|
+
- **DO NOT activate when:** The task falls strictly outside realtime-patterns domain or belongs to a different dedicated specialist.
|
|
29
33
|
|
|
30
34
|
---
|
|
31
35
|
|
|
@@ -302,69 +306,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
302
306
|
|
|
303
307
|
---
|
|
304
308
|
|
|
305
|
-
|
|
306
|
-
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
307
|
-
|
|
308
|
-
### ❌ Forbidden AI Tropes
|
|
309
|
-
|
|
310
|
-
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
311
|
-
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
312
|
-
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
313
|
-
|
|
314
|
-
Review these questions before confirming output:
|
|
315
|
-
|
|
316
|
-
```
|
|
317
|
-
✅ Did I rely ONLY on real, verified tools and methods?
|
|
318
|
-
✅ Is this solution appropriately scoped to the user's constraints?
|
|
319
|
-
✅ Did I handle potential failure modes and edge cases?
|
|
320
|
-
✅ Have I avoided generic boilerplate that doesn't add value?
|
|
321
|
-
```
|
|
322
|
-
|
|
323
|
-
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
324
|
-
|
|
325
|
-
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
326
|
-
|
|
327
|
-
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
328
|
-
- ✅ **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.
|
|
329
|
-
|
|
330
|
-
## Pre-Flight Checklist
|
|
331
|
-
|
|
332
|
-
- [ ] Have I reviewed the user's specific constraints and requests?
|
|
333
|
-
- [ ] Have I checked the environment for relevant existing implementations?
|
|
334
|
-
|
|
335
|
-
## VBC Protocol (Verification-Before-Completion)
|
|
336
|
-
|
|
337
|
-
You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
|
|
338
|
-
|
|
339
|
-
---
|
|
340
|
-
|
|
341
|
-
## 🤖 LLM-Specific Traps
|
|
342
|
-
|
|
343
|
-
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
344
|
-
|
|
345
|
-
1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
|
|
346
|
-
2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
|
|
347
|
-
3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
|
|
348
|
-
4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
349
|
-
5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
|
|
350
|
-
|
|
351
|
-
---
|
|
352
|
-
|
|
353
|
-
## 🏛️ Tribunal Integration (Anti-Hallucination)
|
|
309
|
+
## 🏛️ Tribunal Verification & Guardrails
|
|
354
310
|
|
|
355
311
|
**Slash command: `/review` or `/tribunal-full`**
|
|
356
312
|
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
357
313
|
|
|
358
314
|
### ❌ Forbidden AI Tropes
|
|
359
|
-
|
|
360
315
|
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
361
316
|
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
362
317
|
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
363
318
|
|
|
364
319
|
### ✅ Pre-Flight Self-Audit
|
|
365
|
-
|
|
366
|
-
Review these questions before confirming output:
|
|
367
|
-
|
|
368
320
|
```
|
|
369
321
|
✅ Did I rely ONLY on real, verified tools and methods?
|
|
370
322
|
✅ Is this solution appropriately scoped to the user's constraints?
|
|
@@ -373,8 +325,6 @@ Review these questions before confirming output:
|
|
|
373
325
|
```
|
|
374
326
|
|
|
375
327
|
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
376
|
-
|
|
377
328
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
378
|
-
|
|
379
329
|
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
380
330
|
- ✅ **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: red-team-tactics
|
|
3
3
|
description: Red team tactics principles based on MITRE ATT&CK. Attack phases, detection evasion, reporting.
|
|
4
4
|
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
5
|
-
version:
|
|
6
|
-
last-updated: 2026-07
|
|
5
|
+
version: 4.0.0
|
|
6
|
+
last-updated: 2026-09-07
|
|
7
7
|
skills:
|
|
8
8
|
- vulnerability-scanner
|
|
9
9
|
- backend-security-expert
|
|
@@ -25,6 +25,12 @@ Before performing red team assessments or security testing, you MUST inspect:
|
|
|
25
25
|
2. Reproducible PoC Rule (Section 16) → Include a reproducible Proof-of-Concept, CVSS risk score, and explicit remediation snippet for every finding
|
|
26
26
|
3. Breach Discovery Halt (Section 162) → Immediately halt security testing and report if evidence of an active real-world breach is discovered
|
|
27
27
|
|
|
28
|
+
|
|
29
|
+
## Activation Boundaries
|
|
30
|
+
|
|
31
|
+
- **Activate when:** Operating in tasks requiring Red team tactics principles based on MITRE ATT&CK. Attack phases, detection evasion, reporting..
|
|
32
|
+
- **DO NOT activate when:** The task falls strictly outside red-team-tactics domain or belongs to a different dedicated specialist.
|
|
33
|
+
|
|
28
34
|
## Hallucination Traps (Read First)
|
|
29
35
|
|
|
30
36
|
- ❌ Testing only happy-path authentication -> ✅ Red teaming must test token reuse, expired tokens, forged tokens, and privilege escalation
|
|
@@ -33,8 +39,6 @@ Before performing red team assessments or security testing, you MUST inspect:
|
|
|
33
39
|
|
|
34
40
|
---
|
|
35
41
|
|
|
36
|
-
# Red Team & Penetration Testing Principles
|
|
37
|
-
|
|
38
42
|
A red team engagement is a controlled attack.
|
|
39
43
|
The goal is to find what a real attacker would find — before they do.
|
|
40
44
|
|
|
@@ -210,69 +214,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
210
214
|
|
|
211
215
|
---
|
|
212
216
|
|
|
213
|
-
|
|
214
|
-
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
215
|
-
|
|
216
|
-
### ❌ Forbidden AI Tropes
|
|
217
|
-
|
|
218
|
-
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
219
|
-
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
220
|
-
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
221
|
-
|
|
222
|
-
Review these questions before confirming output:
|
|
223
|
-
|
|
224
|
-
```
|
|
225
|
-
✅ Did I rely ONLY on real, verified tools and methods?
|
|
226
|
-
✅ Is this solution appropriately scoped to the user's constraints?
|
|
227
|
-
✅ Did I handle potential failure modes and edge cases?
|
|
228
|
-
✅ Have I avoided generic boilerplate that doesn't add value?
|
|
229
|
-
```
|
|
230
|
-
|
|
231
|
-
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
232
|
-
|
|
233
|
-
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
234
|
-
|
|
235
|
-
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
236
|
-
- ✅ **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.
|
|
237
|
-
|
|
238
|
-
## Pre-Flight Checklist
|
|
239
|
-
|
|
240
|
-
- [ ] Have I reviewed the user's specific constraints and requests?
|
|
241
|
-
- [ ] Have I checked the environment for relevant existing implementations?
|
|
242
|
-
|
|
243
|
-
## VBC Protocol (Verification-Before-Completion)
|
|
244
|
-
|
|
245
|
-
You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
|
|
246
|
-
|
|
247
|
-
---
|
|
248
|
-
|
|
249
|
-
## 🤖 LLM-Specific Traps
|
|
250
|
-
|
|
251
|
-
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
252
|
-
|
|
253
|
-
1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
|
|
254
|
-
2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
|
|
255
|
-
3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
|
|
256
|
-
4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
257
|
-
5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
|
|
258
|
-
|
|
259
|
-
---
|
|
260
|
-
|
|
261
|
-
## 🏛️ Tribunal Integration (Anti-Hallucination)
|
|
217
|
+
## 🏛️ Tribunal Verification & Guardrails
|
|
262
218
|
|
|
263
219
|
**Slash command: `/review` or `/tribunal-full`**
|
|
264
220
|
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
265
221
|
|
|
266
222
|
### ❌ Forbidden AI Tropes
|
|
267
|
-
|
|
268
223
|
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
269
224
|
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
270
225
|
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
271
226
|
|
|
272
227
|
### ✅ Pre-Flight Self-Audit
|
|
273
|
-
|
|
274
|
-
Review these questions before confirming output:
|
|
275
|
-
|
|
276
228
|
```
|
|
277
229
|
✅ Did I rely ONLY on real, verified tools and methods?
|
|
278
230
|
✅ Is this solution appropriately scoped to the user's constraints?
|
|
@@ -281,8 +233,6 @@ Review these questions before confirming output:
|
|
|
281
233
|
```
|
|
282
234
|
|
|
283
235
|
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
284
|
-
|
|
285
236
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
286
|
-
|
|
287
237
|
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
288
238
|
- ✅ **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: redesign-skill
|
|
3
3
|
description: Audit and upgrade existing interfaces to premium visual quality while preserving product functionality and business logic.
|
|
4
|
-
version:
|
|
5
|
-
last-updated: 2026-07
|
|
4
|
+
version: 4.0.0
|
|
5
|
+
last-updated: 2026-09-07
|
|
6
6
|
skills:
|
|
7
7
|
- taste-skill
|
|
8
8
|
- better-ui
|
|
@@ -27,6 +27,12 @@ Before executing interface redesigns, you MUST inspect:
|
|
|
27
27
|
|
|
28
28
|
Audit legacy or unstyled user interfaces and transform them into modern, production-grade products without breaking underlying business logic.
|
|
29
29
|
|
|
30
|
+
|
|
31
|
+
## Activation Boundaries
|
|
32
|
+
|
|
33
|
+
- **Activate when:** Operating in tasks requiring Audit and upgrade existing interfaces to premium visual quality while preserving product functionality and business logic..
|
|
34
|
+
- **DO NOT activate when:** The task falls strictly outside redesign-skill domain or belongs to a different dedicated specialist.
|
|
35
|
+
|
|
30
36
|
---
|
|
31
37
|
|
|
32
38
|
## 4 Redesign Upgrade Steps
|
|
@@ -53,28 +59,25 @@ Before touching CSS or HTML layout:
|
|
|
53
59
|
|
|
54
60
|
---
|
|
55
61
|
|
|
56
|
-
##
|
|
62
|
+
## 🏛️ Tribunal Verification & Guardrails
|
|
57
63
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
---
|
|
64
|
+
**Slash command: `/review` or `/tribunal-full`**
|
|
65
|
+
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
62
66
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
**
|
|
67
|
+
### ❌ Forbidden AI Tropes
|
|
68
|
+
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
69
|
+
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
70
|
+
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
66
71
|
|
|
67
72
|
### ✅ Pre-Flight Self-Audit
|
|
68
|
-
|
|
69
73
|
```
|
|
70
|
-
✅
|
|
71
|
-
✅ Is
|
|
72
|
-
✅
|
|
74
|
+
✅ Did I rely ONLY on real, verified tools and methods?
|
|
75
|
+
✅ Is this solution appropriately scoped to the user's constraints?
|
|
76
|
+
✅ Did I handle potential failure modes and edge cases?
|
|
77
|
+
✅ Have I avoided generic boilerplate that doesn't add value?
|
|
73
78
|
```
|
|
74
79
|
|
|
75
80
|
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
76
|
-
|
|
77
81
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
78
|
-
|
|
79
82
|
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
80
83
|
- ✅ **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: review-animations
|
|
3
3
|
description: Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.
|
|
4
4
|
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
5
|
-
version:
|
|
6
|
-
last-updated: 2026-07
|
|
5
|
+
version: 4.0.0
|
|
6
|
+
last-updated: 2026-09-07
|
|
7
7
|
skills:
|
|
8
8
|
- emil-design-eng
|
|
9
9
|
- 60fps-animation
|
|
@@ -25,10 +25,14 @@ Before auditing animation code or reviewing motion diffs, you MUST inspect:
|
|
|
25
25
|
2. GPU-Only Property Constraint (Section 38) → Flag any animation of layout-heavy properties (`width`/`height`/`top`/`left`); require `transform` and `opacity`
|
|
26
26
|
3. Physical Correctness & Origin (Section 36) → Flag `scale(0)` entrances; require `scale(0.9–0.97)` with `opacity` and accurate `transform-origin`
|
|
27
27
|
|
|
28
|
-
# Reviewing Animations
|
|
29
|
-
|
|
30
28
|
A specialized review skill. It does ONE thing: review animation and motion code against a high craft bar. It does not write features, fix unrelated bugs, or review non-motion code. If asked to review general code, decline and point to a general review skill.
|
|
31
29
|
|
|
30
|
+
|
|
31
|
+
## Activation Boundaries
|
|
32
|
+
|
|
33
|
+
- **Activate when:** Operating in tasks requiring Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned..
|
|
34
|
+
- **DO NOT activate when:** The task falls strictly outside review-animations domain or belongs to a different dedicated specialist.
|
|
35
|
+
|
|
32
36
|
## Operating Posture
|
|
33
37
|
|
|
34
38
|
You are a senior motion-design reviewer with a brutal eye for craft. Your bias is toward **motion that feels right**, not motion that merely runs. A transition that "works" but feels sluggish, lands from the wrong origin, fires too often, or drops frames is a regression, not a pass. Default to flagging. Approval is earned, not assumed.
|
|
@@ -54,33 +58,25 @@ Every animation in the diff is measured against these. A violation is a finding.
|
|
|
54
58
|
|
|
55
59
|
---
|
|
56
60
|
|
|
57
|
-
##
|
|
58
|
-
|
|
59
|
-
1. **Passive Approval:** Approving animations just because the syntax is correct. You must evaluate the _feel_ and _performance_ against the Standards.
|
|
60
|
-
2. **Ignoring Physics:** Failing to flag elements appearing from nothing (`scale(0)`) or scaling from the wrong origin point.
|
|
61
|
-
3. **Overlooking Duration:** Missing sluggish transitions that exceed the 300ms budget for UI elements.
|
|
62
|
-
4. **Accepting Default Easings:** Approving `ease-in` or generic `ease` on entering UI elements instead of demanding strong `ease-out` curves.
|
|
63
|
-
|
|
64
|
-
## 🏛️ Tribunal Integration (Anti-Hallucination)
|
|
61
|
+
## 🏛️ Tribunal Verification & Guardrails
|
|
65
62
|
|
|
66
63
|
**Slash command: `/review` or `/tribunal-full`**
|
|
67
|
-
**Active reviewers: `
|
|
68
|
-
|
|
69
|
-
### ✅ Pre-Flight Self-Audit
|
|
64
|
+
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
70
65
|
|
|
71
|
-
|
|
66
|
+
### ❌ Forbidden AI Tropes
|
|
67
|
+
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
68
|
+
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
69
|
+
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
72
70
|
|
|
71
|
+
### ✅ Pre-Flight Self-Audit
|
|
73
72
|
```
|
|
74
|
-
✅ Did I
|
|
75
|
-
✅
|
|
76
|
-
✅ Did I
|
|
77
|
-
✅
|
|
78
|
-
✅ Did I check for interruptibility and physical correctness?
|
|
73
|
+
✅ Did I rely ONLY on real, verified tools and methods?
|
|
74
|
+
✅ Is this solution appropriately scoped to the user's constraints?
|
|
75
|
+
✅ Did I handle potential failure modes and edge cases?
|
|
76
|
+
✅ Have I avoided generic boilerplate that doesn't add value?
|
|
79
77
|
```
|
|
80
78
|
|
|
81
79
|
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
82
|
-
|
|
83
80
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
84
|
-
|
|
85
|
-
-
|
|
86
|
-
- ✅ **Required:** Output the review in the standard table format (`| Before | After | Why |`) highlighting all violations, and explicitly stating why approval is earned or withheld.
|
|
81
|
+
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
82
|
+
- ✅ **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: rust-pro
|
|
3
3
|
description: Master Rust 1.75+ with modern async patterns, ownership/borrowing, lifetimes, traits, error handling with thiserror/anyhow, async Tokio runtime, axum web framework, serde serialization, and systems programming. Use when building Rust services, CLI tools, WebAssembly, or performance-critical systems.
|
|
4
4
|
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
5
|
-
version:
|
|
6
|
-
last-updated: 2026-07
|
|
5
|
+
version: 4.0.0
|
|
6
|
+
last-updated: 2026-09-07
|
|
7
7
|
skills:
|
|
8
8
|
- clean-code
|
|
9
9
|
- api-patterns
|
|
@@ -21,11 +21,34 @@ scripts-binding:
|
|
|
21
21
|
|
|
22
22
|
Before writing Rust code or Axum handlers, you MUST inspect:
|
|
23
23
|
|
|
24
|
-
1.
|
|
25
|
-
2. Library
|
|
26
|
-
3. Axum 0.7+ Route Parameters
|
|
24
|
+
1. Zero `.unwrap()` in Production → Use the `?` operator and typed `Result<T, E>`; use `.expect("invariant: explanation")` only if mathematically unreachable
|
|
25
|
+
2. Standard Library `std::sync::LazyLock` → Use native `LazyLock` (Rust 1.80+); ban external `lazy_static` or `once_cell` dependencies
|
|
26
|
+
3. Axum 0.7+ Route Parameters → Use `{id}` bracket syntax for path parameters (`/users/{id}`); ban legacy `:id` syntax
|
|
27
|
+
4. Tokio Cancellation Safety → Ensure `tokio::select!` branches do not hold partially-completed state across cancellation points
|
|
27
28
|
|
|
28
|
-
|
|
29
|
+
## Activation Boundaries
|
|
30
|
+
|
|
31
|
+
- **Activate when:** Writing systems-level Rust, Tokio async services, Axum web backends, WebAssembly modules, and performance-critical native CLI engines.
|
|
32
|
+
- **DO NOT activate when:** Writing frontend HTML/CSS, or rapid Python/Node.js glue scripts.
|
|
33
|
+
|
|
34
|
+
## 2026 Rust Performance & Memory Invariants
|
|
35
|
+
|
|
36
|
+
1. **Native `std::sync::LazyLock`**:
|
|
37
|
+
```rust
|
|
38
|
+
use std::sync::LazyLock;
|
|
39
|
+
static REGEX: LazyLock<regex::Regex> = LazyLock::new(|| regex::Regex::new(r"^\d+$").unwrap());
|
|
40
|
+
```
|
|
41
|
+
2. **Async fn in Traits**: Use native `async fn` inside traits directly (Rust 1.75+ / 2024 edition) without the legacy `#[async_trait]` macro attribute.
|
|
42
|
+
3. **Zero-Copy Borrowing**: Accept `&str` or `&[T]` instead of taking owned `String` or `Vec<T>` in function signatures unless ownership transfer is strictly required.
|
|
43
|
+
4. **Tokio Task Spawning Budget**: Never spawn unbounded Tokio tasks inside request loops without a semaphore limit to prevent memory exhaustion.
|
|
44
|
+
|
|
45
|
+
## Hallucination Traps (Read First)
|
|
46
|
+
|
|
47
|
+
- ❌ Using `lazy_static!` or `once_cell::sync::Lazy` → ✅ Use `std::sync::LazyLock`
|
|
48
|
+
- ❌ Using `#[async_trait]` macro for basic traits → ✅ Native `async fn` in traits (Rust 1.75+)
|
|
49
|
+
- ❌ `.unwrap()` in production handlers → ✅ `?` operator with `thiserror` / `anyhow`
|
|
50
|
+
- ❌ Axum `:id` path parameter syntax → ✅ Axum 0.7+: `{id}` bracket syntax
|
|
51
|
+
- ❌ Allocating `String` just to pass to a reader → ✅ Pass `&str`
|
|
29
52
|
|
|
30
53
|
---
|
|
31
54
|
|
|
@@ -650,69 +673,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
|
|
|
650
673
|
|
|
651
674
|
---
|
|
652
675
|
|
|
653
|
-
|
|
654
|
-
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
655
|
-
|
|
656
|
-
### ❌ Forbidden AI Tropes
|
|
657
|
-
|
|
658
|
-
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
659
|
-
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
660
|
-
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
661
|
-
|
|
662
|
-
Review these questions before confirming output:
|
|
663
|
-
|
|
664
|
-
```
|
|
665
|
-
✅ Did I rely ONLY on real, verified tools and methods?
|
|
666
|
-
✅ Is this solution appropriately scoped to the user's constraints?
|
|
667
|
-
✅ Did I handle potential failure modes and edge cases?
|
|
668
|
-
✅ Have I avoided generic boilerplate that doesn't add value?
|
|
669
|
-
```
|
|
670
|
-
|
|
671
|
-
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
672
|
-
|
|
673
|
-
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
674
|
-
|
|
675
|
-
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
676
|
-
- ✅ **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.
|
|
677
|
-
|
|
678
|
-
## Pre-Flight Checklist
|
|
679
|
-
|
|
680
|
-
- [ ] Have I reviewed the user's specific constraints and requests?
|
|
681
|
-
- [ ] Have I checked the environment for relevant existing implementations?
|
|
682
|
-
|
|
683
|
-
## VBC Protocol (Verification-Before-Completion)
|
|
684
|
-
|
|
685
|
-
You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
|
|
686
|
-
|
|
687
|
-
---
|
|
688
|
-
|
|
689
|
-
## 🤖 LLM-Specific Traps
|
|
690
|
-
|
|
691
|
-
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
692
|
-
|
|
693
|
-
1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
|
|
694
|
-
2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
|
|
695
|
-
3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
|
|
696
|
-
4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
697
|
-
5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
|
|
698
|
-
|
|
699
|
-
---
|
|
700
|
-
|
|
701
|
-
## 🏛️ Tribunal Integration (Anti-Hallucination)
|
|
676
|
+
## 🏛️ Tribunal Verification & Guardrails
|
|
702
677
|
|
|
703
678
|
**Slash command: `/review` or `/tribunal-full`**
|
|
704
679
|
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
705
680
|
|
|
706
681
|
### ❌ Forbidden AI Tropes
|
|
707
|
-
|
|
708
682
|
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
709
683
|
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
710
684
|
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
711
685
|
|
|
712
686
|
### ✅ Pre-Flight Self-Audit
|
|
713
|
-
|
|
714
|
-
Review these questions before confirming output:
|
|
715
|
-
|
|
716
687
|
```
|
|
717
688
|
✅ Did I rely ONLY on real, verified tools and methods?
|
|
718
689
|
✅ Is this solution appropriately scoped to the user's constraints?
|
|
@@ -721,8 +692,6 @@ Review these questions before confirming output:
|
|
|
721
692
|
```
|
|
722
693
|
|
|
723
694
|
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
724
|
-
|
|
725
695
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
726
|
-
|
|
727
696
|
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
728
697
|
- ✅ **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.
|