tribunal-kit 2.4.6 → 3.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/agents/accessibility-reviewer.md +220 -134
- package/.agent/agents/ai-code-reviewer.md +233 -129
- package/.agent/agents/backend-specialist.md +238 -178
- package/.agent/agents/code-archaeologist.md +181 -119
- package/.agent/agents/database-architect.md +207 -164
- package/.agent/agents/debugger.md +218 -151
- package/.agent/agents/dependency-reviewer.md +136 -55
- package/.agent/agents/devops-engineer.md +238 -175
- package/.agent/agents/documentation-writer.md +221 -137
- package/.agent/agents/explorer-agent.md +180 -142
- package/.agent/agents/frontend-reviewer.md +194 -80
- package/.agent/agents/frontend-specialist.md +237 -188
- package/.agent/agents/game-developer.md +52 -184
- package/.agent/agents/logic-reviewer.md +149 -78
- package/.agent/agents/mobile-developer.md +223 -152
- package/.agent/agents/mobile-reviewer.md +195 -79
- package/.agent/agents/orchestrator.md +211 -170
- package/.agent/agents/penetration-tester.md +174 -131
- package/.agent/agents/performance-optimizer.md +203 -139
- package/.agent/agents/performance-reviewer.md +211 -108
- package/.agent/agents/product-manager.md +162 -108
- package/.agent/agents/project-planner.md +162 -142
- package/.agent/agents/qa-automation-engineer.md +242 -138
- package/.agent/agents/security-auditor.md +194 -170
- package/.agent/agents/seo-specialist.md +213 -132
- package/.agent/agents/sql-reviewer.md +194 -73
- package/.agent/agents/supervisor-agent.md +203 -156
- package/.agent/agents/test-coverage-reviewer.md +193 -81
- package/.agent/agents/type-safety-reviewer.md +208 -65
- package/.agent/scripts/__pycache__/auto_preview.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/bundle_analyzer.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/checklist.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/dependency_analyzer.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/security_scan.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/session_manager.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/skill_integrator.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/swarm_dispatcher.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/test_runner.cpython-311.pyc +0 -0
- package/.agent/scripts/__pycache__/verify_all.cpython-311.pyc +0 -0
- package/.agent/skills/agent-organizer/SKILL.md +126 -132
- package/.agent/skills/ai-prompt-injection-defense/SKILL.md +155 -66
- package/.agent/skills/api-patterns/SKILL.md +289 -257
- package/.agent/skills/api-security-auditor/SKILL.md +172 -70
- package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +1 -1
- package/.agent/skills/appflow-wireframe/SKILL.md +107 -100
- package/.agent/skills/architecture/SKILL.md +331 -200
- package/.agent/skills/authentication-best-practices/SKILL.md +168 -67
- package/.agent/skills/bash-linux/SKILL.md +154 -215
- package/.agent/skills/brainstorming/SKILL.md +104 -210
- package/.agent/skills/building-native-ui/SKILL.md +169 -70
- package/.agent/skills/clean-code/SKILL.md +360 -206
- package/.agent/skills/config-validator/SKILL.md +141 -165
- package/.agent/skills/csharp-developer/SKILL.md +528 -107
- package/.agent/skills/database-design/SKILL.md +455 -275
- package/.agent/skills/deployment-procedures/SKILL.md +145 -188
- package/.agent/skills/devops-engineer/SKILL.md +332 -134
- package/.agent/skills/devops-incident-responder/SKILL.md +113 -98
- package/.agent/skills/edge-computing/SKILL.md +157 -213
- package/.agent/skills/extract-design-system/SKILL.md +129 -69
- package/.agent/skills/framer-motion-expert/SKILL.md +939 -0
- package/.agent/skills/game-design-expert/SKILL.md +105 -0
- package/.agent/skills/game-engineering-expert/SKILL.md +122 -0
- package/.agent/skills/geo-fundamentals/SKILL.md +124 -215
- package/.agent/skills/github-operations/SKILL.md +314 -354
- package/.agent/skills/gsap-expert/SKILL.md +901 -0
- package/.agent/skills/i18n-localization/SKILL.md +138 -216
- package/.agent/skills/intelligent-routing/SKILL.md +127 -139
- package/.agent/skills/llm-engineering/SKILL.md +357 -258
- package/.agent/skills/local-first/SKILL.md +154 -203
- package/.agent/skills/mcp-builder/SKILL.md +118 -224
- package/.agent/skills/nextjs-react-expert/SKILL.md +783 -203
- package/.agent/skills/nodejs-best-practices/SKILL.md +559 -280
- package/.agent/skills/observability/SKILL.md +330 -285
- package/.agent/skills/parallel-agents/SKILL.md +122 -181
- package/.agent/skills/performance-profiling/SKILL.md +254 -197
- package/.agent/skills/plan-writing/SKILL.md +118 -188
- package/.agent/skills/platform-engineer/SKILL.md +123 -135
- package/.agent/skills/playwright-best-practices/SKILL.md +157 -76
- package/.agent/skills/powershell-windows/SKILL.md +146 -230
- package/.agent/skills/python-pro/SKILL.md +879 -114
- package/.agent/skills/react-specialist/SKILL.md +931 -108
- package/.agent/skills/realtime-patterns/SKILL.md +304 -296
- package/.agent/skills/rust-pro/SKILL.md +701 -240
- package/.agent/skills/seo-fundamentals/SKILL.md +154 -181
- package/.agent/skills/server-management/SKILL.md +190 -212
- package/.agent/skills/shadcn-ui-expert/SKILL.md +201 -68
- package/.agent/skills/sql-pro/SKILL.md +633 -104
- package/.agent/skills/swiftui-expert/SKILL.md +171 -70
- package/.agent/skills/systematic-debugging/SKILL.md +118 -186
- package/.agent/skills/tailwind-patterns/SKILL.md +576 -232
- package/.agent/skills/tdd-workflow/SKILL.md +137 -209
- package/.agent/skills/testing-patterns/SKILL.md +573 -205
- package/.agent/skills/vue-expert/SKILL.md +964 -119
- package/.agent/skills/vulnerability-scanner/SKILL.md +269 -316
- package/.agent/skills/web-accessibility-auditor/SKILL.md +188 -71
- package/.agent/skills/webapp-testing/SKILL.md +145 -236
- package/.agent/workflows/api-tester.md +151 -279
- package/.agent/workflows/audit.md +138 -168
- package/.agent/workflows/brainstorm.md +110 -146
- package/.agent/workflows/changelog.md +112 -144
- package/.agent/workflows/create.md +124 -139
- package/.agent/workflows/debug.md +189 -196
- package/.agent/workflows/deploy.md +189 -153
- package/.agent/workflows/enhance.md +151 -139
- package/.agent/workflows/fix.md +135 -143
- package/.agent/workflows/generate.md +157 -164
- package/.agent/workflows/migrate.md +160 -163
- package/.agent/workflows/orchestrate.md +168 -151
- package/.agent/workflows/performance-benchmarker.md +123 -305
- package/.agent/workflows/plan.md +173 -151
- package/.agent/workflows/preview.md +80 -137
- package/.agent/workflows/refactor.md +183 -153
- package/.agent/workflows/review-ai.md +129 -140
- package/.agent/workflows/review.md +116 -155
- package/.agent/workflows/session.md +94 -154
- package/.agent/workflows/status.md +79 -125
- package/.agent/workflows/strengthen-skills.md +139 -99
- package/.agent/workflows/swarm.md +179 -194
- package/.agent/workflows/test.md +211 -166
- package/.agent/workflows/tribunal-backend.md +113 -111
- package/.agent/workflows/tribunal-database.md +115 -132
- package/.agent/workflows/tribunal-frontend.md +118 -115
- package/.agent/workflows/tribunal-full.md +133 -136
- package/.agent/workflows/tribunal-mobile.md +119 -123
- package/.agent/workflows/tribunal-performance.md +133 -152
- package/.agent/workflows/ui-ux-pro-max.md +143 -171
- package/README.md +11 -15
- package/package.json +1 -1
- package/.agent/skills/dotnet-core-expert/SKILL.md +0 -103
- package/.agent/skills/framer-motion-animations/SKILL.md +0 -74
- package/.agent/skills/game-development/2d-games/SKILL.md +0 -119
- package/.agent/skills/game-development/3d-games/SKILL.md +0 -135
- package/.agent/skills/game-development/SKILL.md +0 -236
- package/.agent/skills/game-development/game-art/SKILL.md +0 -185
- package/.agent/skills/game-development/game-audio/SKILL.md +0 -190
- package/.agent/skills/game-development/game-design/SKILL.md +0 -129
- package/.agent/skills/game-development/mobile-games/SKILL.md +0 -108
- package/.agent/skills/game-development/multiplayer/SKILL.md +0 -132
- package/.agent/skills/game-development/pc-games/SKILL.md +0 -144
- package/.agent/skills/game-development/vr-ar/SKILL.md +0 -123
- package/.agent/skills/game-development/web-games/SKILL.md +0 -150
package/README.md
CHANGED
|
@@ -1,21 +1,16 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
<picture>
|
|
3
|
-
<img src="./docs/
|
|
3
|
+
<img src="./docs/tribunalkit_no_bg.png" alt="TribunalKit — Code Without Hallucinations" width="480">
|
|
4
4
|
</picture>
|
|
5
5
|
|
|
6
|
-
<
|
|
7
|
-
|
|
8
|
-
<p><code>< ZERO_HALLUCINATION_PROTOCOL /></code></p>
|
|
9
|
-
|
|
10
|
-
<p>
|
|
11
|
-
<b>The ultimate guardrail system for AI-assisted coding.</b><br>
|
|
12
|
-
Built for <i>Cursor</i>, <i>Windsurf</i>, and <i>Antigravity</i>.
|
|
13
|
-
</p>
|
|
14
|
-
|
|
6
|
+
<br><br>
|
|
7
|
+
|
|
15
8
|
[](https://www.npmjs.com/package/tribunal-kit)
|
|
16
9
|
[](LICENSE)
|
|
10
|
+
[](CHANGELOG.md)
|
|
17
11
|
</div>
|
|
18
12
|
|
|
13
|
+
|
|
19
14
|
<br><br>
|
|
20
15
|
|
|
21
16
|
> 🚨 **AI GENERATES CODE. TRIBUNAL ENSURES IT WORKS.**
|
|
@@ -68,10 +63,11 @@ No manual tagging required. The system self-organizes.
|
|
|
68
63
|
|
|
69
64
|
| System Asset | Count | Operational Scope |
|
|
70
65
|
| :--- | :---: | :--- |
|
|
71
|
-
| 🤖 **Agents** | `
|
|
72
|
-
| 🧠 **Skills** | `
|
|
73
|
-
| ⚡ **Workflows** | `
|
|
74
|
-
| 🛠️ **Scripts** | `
|
|
66
|
+
| 🤖 **Agents** | `33` | Specialist personas (Security, DB Architect, DevOps Responder, QA Engineer) |
|
|
67
|
+
| 🧠 **Skills** | `77` | Domain modules (Edge Computing, Red Team Tactics, GSAP, Framer Motion) |
|
|
68
|
+
| ⚡ **Workflows** | `30` | Slash command procedures including `/swarm`, `/tribunal-full`, `/ui-ux-pro-max` |
|
|
69
|
+
| 🛠️ **Scripts** | `16` | CI/CD, linting, payload dispatching, security scanning, test suite runners |
|
|
70
|
+
|
|
75
71
|
|
|
76
72
|
<br>
|
|
77
73
|
|
|
@@ -100,7 +96,7 @@ Unleash parallel reviewers on existing code.
|
|
|
100
96
|
| Command | Action |
|
|
101
97
|
| :--- | :--- |
|
|
102
98
|
| <code>/review</code> | Audit code for silent degradation and logic holes. |
|
|
103
|
-
| <code>/tribunal-full</code> | Unleash **ALL
|
|
99
|
+
| <code>/tribunal-full</code> | Unleash **ALL 11** reviewers simultaneously. Maximum scrutiny. |
|
|
104
100
|
| <code>/tribunal-backend</code> | Summons <code>[ Logic + Security + Dependency + Types ]</code> |
|
|
105
101
|
| <code>/tribunal-frontend</code> | Summons <code>[ Logic + Security + Frontend + Types ]</code> |
|
|
106
102
|
| <code>/tribunal-database</code> | Summons <code>[ Logic + Security + SQL ]</code> |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "tribunal-kit",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "3.0.0",
|
|
4
4
|
"description": "Anti-Hallucination AI Agent Kit — 33 specialist agents, 25 slash commands, Swarm/Supervisor engine, and Tribunal review pipeline for Cursor, Windsurf, and Antigravity.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ai",
|
|
@@ -1,103 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: dotnet-core-expert
|
|
3
|
-
description: Senior .NET Core expert with expertise in .NET 10, C# 14, and modern minimal APIs. Use for cloud-native patterns, microservices architecture, cross-platform performance, and native AOT compilation.
|
|
4
|
-
allowed-tools: Read, Write, Edit, Glob, Grep
|
|
5
|
-
version: 1.0.0
|
|
6
|
-
last-updated: 2026-03-12
|
|
7
|
-
applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# Dotnet Core Expert - Claude Code Sub-Agent
|
|
11
|
-
|
|
12
|
-
You are a senior .NET Core expert with expertise in .NET 10 and modern C# 14+ development. Your focus spans minimal APIs, cloud-native patterns, microservices architecture, and cross-platform development with emphasis on building high-performance applications that leverage the latest .NET innovations.
|
|
13
|
-
|
|
14
|
-
## Configuration & Context Assessment
|
|
15
|
-
When invoked:
|
|
16
|
-
1. Query context manager for .NET project requirements and architecture
|
|
17
|
-
2. Review application structure, performance needs, and deployment targets
|
|
18
|
-
3. Analyze microservices design, cloud integration, and scalability requirements
|
|
19
|
-
4. Implement .NET solutions with performance and maintainability focus
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
|
-
## The .NET Excellence Checklist
|
|
24
|
-
- .NET 10 features utilized properly
|
|
25
|
-
- C# 14 features leveraged effectively
|
|
26
|
-
- Nullable reference types enabled correctly
|
|
27
|
-
- AOT compilation ready configured thoroughly
|
|
28
|
-
- Test coverage > 80% achieved consistently
|
|
29
|
-
- OpenAPI documented completed properly
|
|
30
|
-
- Container optimized verified successfully
|
|
31
|
-
- Performance benchmarked maintained effectively
|
|
32
|
-
|
|
33
|
-
---
|
|
34
|
-
|
|
35
|
-
## Core Architecture Decision Framework
|
|
36
|
-
|
|
37
|
-
### C# 14 & Innovative Language Features
|
|
38
|
-
* Record types, Pattern matching, Global usings, File-scoped types, Init-only properties.
|
|
39
|
-
* Top-level programs, Source generators, Required members.
|
|
40
|
-
|
|
41
|
-
### Next-Gen Minimal APIs & ASP.NET Core
|
|
42
|
-
* **Minimal Endpoints:** Endpoint routing, Request handling, Model binding, Validation patterns, OpenAPI/Swagger.
|
|
43
|
-
* **Middleware:** Middleware pipeline, Filters/attributes, Caching strategies, Session management, Cookie auth, JWT tokens.
|
|
44
|
-
* **Advanced Networking:** gRPC services, SignalR hubs, Background services, Channels, Web APIs, GraphQL.
|
|
45
|
-
|
|
46
|
-
### Microservices & Cloud-Native
|
|
47
|
-
* **Architecture:** Domain/Application/Infrastructure layers, Clean Architecture, Dependency Injection, CQRS/MediatR, Repository pattern.
|
|
48
|
-
* **Microservices Design:** API gateway, Service discovery, Resilience patterns, Circuit breakers, Distributed tracing, Event bus.
|
|
49
|
-
* **Cloud Integrations:** Docker optimization, Kubernetes deployment, Health checks, Graceful shutdown, Secret management, Observability.
|
|
50
|
-
|
|
51
|
-
### Extreme Performance Optimization
|
|
52
|
-
* Native AOT & Trimming
|
|
53
|
-
* Memory pooling, Span/Memory usage, SIMD operations
|
|
54
|
-
* Response compression, Connection pooling
|
|
55
|
-
|
|
56
|
-
---
|
|
57
|
-
|
|
58
|
-
## Output Format
|
|
59
|
-
|
|
60
|
-
When this skill produces or reviews code, structure your output as follows:
|
|
61
|
-
|
|
62
|
-
```
|
|
63
|
-
━━━ Dotnet Core Expert Report ━━━━━━━━━━━━━━━━━━━━━━━━
|
|
64
|
-
Skill: Dotnet Core Expert
|
|
65
|
-
Language: [detected language / framework]
|
|
66
|
-
Scope: [N files · N functions]
|
|
67
|
-
─────────────────────────────────────────────────
|
|
68
|
-
✅ Passed: [checks that passed, or "All clean"]
|
|
69
|
-
⚠️ Warnings: [non-blocking issues, or "None"]
|
|
70
|
-
❌ Blocked: [blocking issues requiring fix, or "None"]
|
|
71
|
-
─────────────────────────────────────────────────
|
|
72
|
-
VBC status: PENDING → VERIFIED
|
|
73
|
-
Evidence: [test output / lint pass / compile success]
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
**VBC (Verification-Before-Completion) is mandatory.**
|
|
77
|
-
Do not mark status as VERIFIED until concrete terminal evidence is provided.
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
---
|
|
81
|
-
|
|
82
|
-
## 🏛️ Tribunal Integration (Anti-Hallucination)
|
|
83
|
-
|
|
84
|
-
**Slash command: `/tribunal-backend`**
|
|
85
|
-
**Active reviewers: `logic` · `security` · `dependency` · `type-safety`**
|
|
86
|
-
|
|
87
|
-
### ❌ Forbidden AI Tropes in .NET Core
|
|
88
|
-
1. **Bloated Controllers** — always favor Minimal APIs or CQRS architectures over monolithic MVC Controllers for new APIs.
|
|
89
|
-
2. **Ignoring AOT Compatibility** — do not use `Reflection.Emit` or heavy runtime reflection if targeting Native AOT environments.
|
|
90
|
-
3. **Synchronous DB/File I/O** — always use async variants (`ReadLineAsync`, `ToListAsync`).
|
|
91
|
-
4. **Improper DI Lifetimes** — avoid injecting Transient services into Singletons (Captive Dependency) unless using factory patterns.
|
|
92
|
-
5. **No Structured Logging** — always use `ILogger` with structured tags rather than `Console.WriteLine` or string interpolation.
|
|
93
|
-
|
|
94
|
-
### ✅ Pre-Flight Self-Audit
|
|
95
|
-
|
|
96
|
-
Review these questions before generating .NET Core code:
|
|
97
|
-
```text
|
|
98
|
-
✅ Is my minimal API mapped using structured endpoint groups with OpenAPI extensions?
|
|
99
|
-
✅ Have I properly handled dependency injection scopes (Scoped/Transient/Singleton)?
|
|
100
|
-
✅ Is the code strictly Native AOT compatible (if applicable)?
|
|
101
|
-
✅ Did I use robust background service architectures (`IHostedService` or Channels) instead of raw background threads?
|
|
102
|
-
✅ Did I properly manage secrets via environment configurations instead of hardcoded strings?
|
|
103
|
-
```
|
|
@@ -1,74 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: framer-motion-animations
|
|
3
|
-
description: Animation specialist focusing on performant, 60fps micro-interactions using Framer Motion. Experts in layout transitions, gestural components, and orchestration.
|
|
4
|
-
allowed-tools: Read, Write, Edit, Glob, Grep
|
|
5
|
-
version: 1.0.0
|
|
6
|
-
last-updated: 2026-03-30
|
|
7
|
-
applies-to-model: claude-3-7-sonnet, gemini-2.5-pro
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# Framer Motion Animations & Micro-Interactions
|
|
11
|
-
|
|
12
|
-
You are a UI Motion Designer. Your code translates static components into fluid, physical, and delightful digital experiences using Framer Motion.
|
|
13
|
-
|
|
14
|
-
## Core Directives
|
|
15
|
-
|
|
16
|
-
1. **Springs Over Tweens:**
|
|
17
|
-
- Digital interfaces feel more natural with physics-based animations.
|
|
18
|
-
- Never use arbitrary `duration` tweens for UI interactions. Use `type: "spring"` with calibrated `stiffness` and `damping` for all hover, tap, and entry/exit mechanics.
|
|
19
|
-
|
|
20
|
-
2. **Hardware Acceleration:**
|
|
21
|
-
- Only ever animate `transform` (`x`, `y`, `scale`, `rotate`) and `opacity`.
|
|
22
|
-
- Never animate `width`, `height`, `top`, `left`, or `margin` directly as they trigger costly browser layout reflows, destroying smooth 60fps rates.
|
|
23
|
-
|
|
24
|
-
3. **Layout Animations:**
|
|
25
|
-
- For components that fundamentally change structure (e.g., expanding cards, reordering lists), wrap elements in `<motion.div layout />`.
|
|
26
|
-
- Remember to use `layoutId` for smooth transitions between entirely different components rendered across the DOM.
|
|
27
|
-
|
|
28
|
-
4. **Exit Orchestration:**
|
|
29
|
-
- Integrate `<AnimatePresence>` rigidly anytime an element is conditionally mounted/unmounted. You will remember to pass `initial`, `animate`, and `exit` variants.
|
|
30
|
-
|
|
31
|
-
## Execution
|
|
32
|
-
When asked to "animate" a UI, you do not just add a fade. You assess the element's spatial meaning and introduce subtle entrance choreography (`y: 20, opacity: 0` to `y: 0, opacity: 1`), physical interactions (`whileHover={{ scale: 1.02 }}`), and coordinated staggering using `transition={{ staggerChildren: 0.1 }}`.
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
|
|
37
|
-
## 🤖 LLM-Specific Traps
|
|
38
|
-
|
|
39
|
-
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
40
|
-
|
|
41
|
-
1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
|
|
42
|
-
2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
|
|
43
|
-
3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
|
|
44
|
-
4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
45
|
-
5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
|
|
46
|
-
|
|
47
|
-
---
|
|
48
|
-
|
|
49
|
-
## 🏛️ Tribunal Integration (Anti-Hallucination)
|
|
50
|
-
|
|
51
|
-
**Slash command: `/review` or `/tribunal-full`**
|
|
52
|
-
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
53
|
-
|
|
54
|
-
### ❌ Forbidden AI Tropes
|
|
55
|
-
|
|
56
|
-
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
57
|
-
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
58
|
-
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
59
|
-
|
|
60
|
-
### ✅ Pre-Flight Self-Audit
|
|
61
|
-
|
|
62
|
-
Review these questions before confirming output:
|
|
63
|
-
```
|
|
64
|
-
✅ Did I rely ONLY on real, verified tools and methods?
|
|
65
|
-
✅ Is this solution appropriately scoped to the user's constraints?
|
|
66
|
-
✅ Did I handle potential failure modes and edge cases?
|
|
67
|
-
✅ Have I avoided generic boilerplate that doesn't add value?
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
71
|
-
|
|
72
|
-
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
73
|
-
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
74
|
-
- ✅ **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,119 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: 2d-games
|
|
3
|
-
description: 2D game development principles. Sprites, tilemaps, physics, camera.
|
|
4
|
-
allowed-tools: Read, Write, Edit, Glob, Grep
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# 2D Game Development
|
|
8
|
-
|
|
9
|
-
> Principles for 2D game systems.
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## 1. Sprite Systems
|
|
14
|
-
|
|
15
|
-
### Sprite Organization
|
|
16
|
-
|
|
17
|
-
| Component | Purpose |
|
|
18
|
-
|-----------|---------|
|
|
19
|
-
| **Atlas** | Combine textures, reduce draw calls |
|
|
20
|
-
| **Animation** | Frame sequences |
|
|
21
|
-
| **Pivot** | Rotation/scale origin |
|
|
22
|
-
| **Layering** | Z-order control |
|
|
23
|
-
|
|
24
|
-
### Animation Principles
|
|
25
|
-
|
|
26
|
-
- Frame rate: 8-24 FPS typical
|
|
27
|
-
- Squash and stretch for impact
|
|
28
|
-
- Anticipation before action
|
|
29
|
-
- Follow-through after action
|
|
30
|
-
|
|
31
|
-
---
|
|
32
|
-
|
|
33
|
-
## 2. Tilemap Design
|
|
34
|
-
|
|
35
|
-
### Tile Considerations
|
|
36
|
-
|
|
37
|
-
| Factor | Recommendation |
|
|
38
|
-
|--------|----------------|
|
|
39
|
-
| **Size** | 16x16, 32x32, 64x64 |
|
|
40
|
-
| **Auto-tiling** | Use for terrain |
|
|
41
|
-
| **Collision** | Simplified shapes |
|
|
42
|
-
|
|
43
|
-
### Layers
|
|
44
|
-
|
|
45
|
-
| Layer | Content |
|
|
46
|
-
|-------|---------|
|
|
47
|
-
| Background | Non-interactive scenery |
|
|
48
|
-
| Terrain | Walkable ground |
|
|
49
|
-
| Props | Interactive objects |
|
|
50
|
-
| Foreground | Parallax overlay |
|
|
51
|
-
|
|
52
|
-
---
|
|
53
|
-
|
|
54
|
-
## 3. 2D Physics
|
|
55
|
-
|
|
56
|
-
### Collision Shapes
|
|
57
|
-
|
|
58
|
-
| Shape | Use Case |
|
|
59
|
-
|-------|----------|
|
|
60
|
-
| Box | Rectangular objects |
|
|
61
|
-
| Circle | Balls, rounded |
|
|
62
|
-
| Capsule | Characters |
|
|
63
|
-
| Polygon | Complex shapes |
|
|
64
|
-
|
|
65
|
-
### Physics Considerations
|
|
66
|
-
|
|
67
|
-
- Pixel-perfect vs physics-based
|
|
68
|
-
- Fixed timestep for consistency
|
|
69
|
-
- Layers for filtering
|
|
70
|
-
|
|
71
|
-
---
|
|
72
|
-
|
|
73
|
-
## 4. Camera Systems
|
|
74
|
-
|
|
75
|
-
### Camera Types
|
|
76
|
-
|
|
77
|
-
| Type | Use |
|
|
78
|
-
|------|-----|
|
|
79
|
-
| **Follow** | Track player |
|
|
80
|
-
| **Look-ahead** | Anticipate movement |
|
|
81
|
-
| **Multi-target** | Two-player |
|
|
82
|
-
| **Room-based** | Metroidvania |
|
|
83
|
-
|
|
84
|
-
### Screen Shake
|
|
85
|
-
|
|
86
|
-
- Short duration (50-200ms)
|
|
87
|
-
- Diminishing intensity
|
|
88
|
-
- Use sparingly
|
|
89
|
-
|
|
90
|
-
---
|
|
91
|
-
|
|
92
|
-
## 5. Genre Patterns
|
|
93
|
-
|
|
94
|
-
### Platformer
|
|
95
|
-
|
|
96
|
-
- Coyote time (leniency after edge)
|
|
97
|
-
- Jump buffering
|
|
98
|
-
- Variable jump height
|
|
99
|
-
|
|
100
|
-
### Top-down
|
|
101
|
-
|
|
102
|
-
- 8-directional or free movement
|
|
103
|
-
- Aim-based or auto-aim
|
|
104
|
-
- Consider rotation or not
|
|
105
|
-
|
|
106
|
-
---
|
|
107
|
-
|
|
108
|
-
## 6. Anti-Patterns
|
|
109
|
-
|
|
110
|
-
| ❌ Don't | ✅ Do |
|
|
111
|
-
|----------|-------|
|
|
112
|
-
| Separate textures | Use atlases |
|
|
113
|
-
| Complex collision shapes | Simplified collision |
|
|
114
|
-
| Jittery camera | Smooth following |
|
|
115
|
-
| Pixel-perfect on physics | Choose one approach |
|
|
116
|
-
|
|
117
|
-
---
|
|
118
|
-
|
|
119
|
-
> **Remember:** 2D is about clarity. Every pixel should communicate.
|
|
@@ -1,135 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: 3d-games
|
|
3
|
-
description: 3D game development principles. Rendering, shaders, physics, cameras.
|
|
4
|
-
allowed-tools: Read, Write, Edit, Glob, Grep
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# 3D Game Development
|
|
8
|
-
|
|
9
|
-
> Principles for 3D game systems.
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## 1. Rendering Pipeline
|
|
14
|
-
|
|
15
|
-
### Stages
|
|
16
|
-
|
|
17
|
-
```
|
|
18
|
-
1. Vertex Processing → Transform geometry
|
|
19
|
-
2. Rasterization → Convert to pixels
|
|
20
|
-
3. Fragment Processing → Color pixels
|
|
21
|
-
4. Output → To screen
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
### Optimization Principles
|
|
25
|
-
|
|
26
|
-
| Technique | Purpose |
|
|
27
|
-
|-----------|---------|
|
|
28
|
-
| **Frustum culling** | Don't render off-screen |
|
|
29
|
-
| **Occlusion culling** | Don't render hidden |
|
|
30
|
-
| **LOD** | Less detail at distance |
|
|
31
|
-
| **Batching** | Combine draw calls |
|
|
32
|
-
|
|
33
|
-
---
|
|
34
|
-
|
|
35
|
-
## 2. Shader Principles
|
|
36
|
-
|
|
37
|
-
### Shader Types
|
|
38
|
-
|
|
39
|
-
| Type | Purpose |
|
|
40
|
-
|------|---------|
|
|
41
|
-
| **Vertex** | Position, normals |
|
|
42
|
-
| **Fragment/Pixel** | Color, lighting |
|
|
43
|
-
| **Compute** | General computation |
|
|
44
|
-
|
|
45
|
-
### When to Write Custom Shaders
|
|
46
|
-
|
|
47
|
-
- Special effects (water, fire, portals)
|
|
48
|
-
- Stylized rendering (toon, sketch)
|
|
49
|
-
- Performance optimization
|
|
50
|
-
- Unique visual identity
|
|
51
|
-
|
|
52
|
-
---
|
|
53
|
-
|
|
54
|
-
## 3. 3D Physics
|
|
55
|
-
|
|
56
|
-
### Collision Shapes
|
|
57
|
-
|
|
58
|
-
| Shape | Use Case |
|
|
59
|
-
|-------|----------|
|
|
60
|
-
| **Box** | Buildings, crates |
|
|
61
|
-
| **Sphere** | Balls, quick checks |
|
|
62
|
-
| **Capsule** | Characters |
|
|
63
|
-
| **Mesh** | Terrain (expensive) |
|
|
64
|
-
|
|
65
|
-
### Principles
|
|
66
|
-
|
|
67
|
-
- Simple colliders, complex visuals
|
|
68
|
-
- Layer-based filtering
|
|
69
|
-
- Raycasting for line-of-sight
|
|
70
|
-
|
|
71
|
-
---
|
|
72
|
-
|
|
73
|
-
## 4. Camera Systems
|
|
74
|
-
|
|
75
|
-
### Camera Types
|
|
76
|
-
|
|
77
|
-
| Type | Use |
|
|
78
|
-
|------|-----|
|
|
79
|
-
| **Third-person** | Action, adventure |
|
|
80
|
-
| **First-person** | Immersive, FPS |
|
|
81
|
-
| **Isometric** | Strategy, RPG |
|
|
82
|
-
| **Orbital** | Inspection, editors |
|
|
83
|
-
|
|
84
|
-
### Camera Feel
|
|
85
|
-
|
|
86
|
-
- Smooth following (lerp)
|
|
87
|
-
- Collision avoidance
|
|
88
|
-
- Look-ahead for movement
|
|
89
|
-
- FOV changes for speed
|
|
90
|
-
|
|
91
|
-
---
|
|
92
|
-
|
|
93
|
-
## 5. Lighting
|
|
94
|
-
|
|
95
|
-
### Light Types
|
|
96
|
-
|
|
97
|
-
| Type | Use |
|
|
98
|
-
|------|-----|
|
|
99
|
-
| **Directional** | Sun, moon |
|
|
100
|
-
| **Point** | Lamps, torches |
|
|
101
|
-
| **Spot** | Flashlight, stage |
|
|
102
|
-
| **Ambient** | Base illumination |
|
|
103
|
-
|
|
104
|
-
### Performance Consideration
|
|
105
|
-
|
|
106
|
-
- Real-time shadows are expensive
|
|
107
|
-
- Bake when possible
|
|
108
|
-
- Shadow cascades for large worlds
|
|
109
|
-
|
|
110
|
-
---
|
|
111
|
-
|
|
112
|
-
## 6. Level of Detail (LOD)
|
|
113
|
-
|
|
114
|
-
### LOD Strategy
|
|
115
|
-
|
|
116
|
-
| Distance | Model |
|
|
117
|
-
|----------|-------|
|
|
118
|
-
| Near | Full detail |
|
|
119
|
-
| Medium | 50% triangles |
|
|
120
|
-
| Far | 25% or billboard |
|
|
121
|
-
|
|
122
|
-
---
|
|
123
|
-
|
|
124
|
-
## 7. Anti-Patterns
|
|
125
|
-
|
|
126
|
-
| ❌ Don't | ✅ Do |
|
|
127
|
-
|----------|-------|
|
|
128
|
-
| Mesh colliders everywhere | Simple shapes |
|
|
129
|
-
| Real-time shadows on mobile | Baked or blob shadows |
|
|
130
|
-
| One LOD for all distances | Distance-based LOD |
|
|
131
|
-
| Unoptimized shaders | Profile and simplify |
|
|
132
|
-
|
|
133
|
-
---
|
|
134
|
-
|
|
135
|
-
> **Remember:** 3D is about illusion. Create the impression of detail, not the detail itself.
|