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: 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:
|
|
6
|
-
last-updated: 2026-
|
|
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
|
-
|
|
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
|
-
|
|
59
|
-
|
|
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:
|
|
5
|
-
last-updated: 2026-07
|
|
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
|
-
##
|
|
102
|
+
## 🏛️ Tribunal Verification & Guardrails
|
|
97
103
|
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
---
|
|
104
|
+
**Slash command: `/review` or `/tribunal-full`**
|
|
105
|
+
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
102
106
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
**
|
|
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
|
-
✅
|
|
111
|
-
✅ Is
|
|
112
|
-
✅
|
|
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:
|
|
6
|
-
last-updated: 2026-07
|
|
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
|
-
|
|
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:
|
|
6
|
-
last-updated: 2026-07
|
|
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
|
-
|
|
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
|
-
|
|
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:
|
|
6
|
-
last-updated: 2026-07
|
|
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.
|
|
25
|
-
2.
|
|
26
|
-
3.
|
|
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
|
-
##
|
|
29
|
+
## Activation Boundaries
|
|
29
30
|
|
|
30
|
-
-
|
|
31
|
-
-
|
|
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
|
-
|
|
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. **
|
|
49
|
-
|
|
50
|
-
|
|
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
|
-
|
|
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:
|
|
6
|
-
last-updated: 2026-07
|
|
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
|
-
|
|
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:
|
|
6
|
-
last-updated: 2026-
|
|
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
|
-
|
|
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
|
-
|
|
68
|
-
|
|
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.
|