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.
Files changed (142) hide show
  1. package/.agent/agents/accessibility-reviewer.md +220 -134
  2. package/.agent/agents/ai-code-reviewer.md +233 -129
  3. package/.agent/agents/backend-specialist.md +238 -178
  4. package/.agent/agents/code-archaeologist.md +181 -119
  5. package/.agent/agents/database-architect.md +207 -164
  6. package/.agent/agents/debugger.md +218 -151
  7. package/.agent/agents/dependency-reviewer.md +136 -55
  8. package/.agent/agents/devops-engineer.md +238 -175
  9. package/.agent/agents/documentation-writer.md +221 -137
  10. package/.agent/agents/explorer-agent.md +180 -142
  11. package/.agent/agents/frontend-reviewer.md +194 -80
  12. package/.agent/agents/frontend-specialist.md +237 -188
  13. package/.agent/agents/game-developer.md +52 -184
  14. package/.agent/agents/logic-reviewer.md +149 -78
  15. package/.agent/agents/mobile-developer.md +223 -152
  16. package/.agent/agents/mobile-reviewer.md +195 -79
  17. package/.agent/agents/orchestrator.md +211 -170
  18. package/.agent/agents/penetration-tester.md +174 -131
  19. package/.agent/agents/performance-optimizer.md +203 -139
  20. package/.agent/agents/performance-reviewer.md +211 -108
  21. package/.agent/agents/product-manager.md +162 -108
  22. package/.agent/agents/project-planner.md +162 -142
  23. package/.agent/agents/qa-automation-engineer.md +242 -138
  24. package/.agent/agents/security-auditor.md +194 -170
  25. package/.agent/agents/seo-specialist.md +213 -132
  26. package/.agent/agents/sql-reviewer.md +194 -73
  27. package/.agent/agents/supervisor-agent.md +203 -156
  28. package/.agent/agents/test-coverage-reviewer.md +193 -81
  29. package/.agent/agents/type-safety-reviewer.md +208 -65
  30. package/.agent/scripts/__pycache__/auto_preview.cpython-311.pyc +0 -0
  31. package/.agent/scripts/__pycache__/bundle_analyzer.cpython-311.pyc +0 -0
  32. package/.agent/scripts/__pycache__/checklist.cpython-311.pyc +0 -0
  33. package/.agent/scripts/__pycache__/dependency_analyzer.cpython-311.pyc +0 -0
  34. package/.agent/scripts/__pycache__/security_scan.cpython-311.pyc +0 -0
  35. package/.agent/scripts/__pycache__/session_manager.cpython-311.pyc +0 -0
  36. package/.agent/scripts/__pycache__/skill_integrator.cpython-311.pyc +0 -0
  37. package/.agent/scripts/__pycache__/swarm_dispatcher.cpython-311.pyc +0 -0
  38. package/.agent/scripts/__pycache__/test_runner.cpython-311.pyc +0 -0
  39. package/.agent/scripts/__pycache__/verify_all.cpython-311.pyc +0 -0
  40. package/.agent/skills/agent-organizer/SKILL.md +126 -132
  41. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +155 -66
  42. package/.agent/skills/api-patterns/SKILL.md +289 -257
  43. package/.agent/skills/api-security-auditor/SKILL.md +172 -70
  44. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +1 -1
  45. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +1 -1
  46. package/.agent/skills/appflow-wireframe/SKILL.md +107 -100
  47. package/.agent/skills/architecture/SKILL.md +331 -200
  48. package/.agent/skills/authentication-best-practices/SKILL.md +168 -67
  49. package/.agent/skills/bash-linux/SKILL.md +154 -215
  50. package/.agent/skills/brainstorming/SKILL.md +104 -210
  51. package/.agent/skills/building-native-ui/SKILL.md +169 -70
  52. package/.agent/skills/clean-code/SKILL.md +360 -206
  53. package/.agent/skills/config-validator/SKILL.md +141 -165
  54. package/.agent/skills/csharp-developer/SKILL.md +528 -107
  55. package/.agent/skills/database-design/SKILL.md +455 -275
  56. package/.agent/skills/deployment-procedures/SKILL.md +145 -188
  57. package/.agent/skills/devops-engineer/SKILL.md +332 -134
  58. package/.agent/skills/devops-incident-responder/SKILL.md +113 -98
  59. package/.agent/skills/edge-computing/SKILL.md +157 -213
  60. package/.agent/skills/extract-design-system/SKILL.md +129 -69
  61. package/.agent/skills/framer-motion-expert/SKILL.md +939 -0
  62. package/.agent/skills/game-design-expert/SKILL.md +105 -0
  63. package/.agent/skills/game-engineering-expert/SKILL.md +122 -0
  64. package/.agent/skills/geo-fundamentals/SKILL.md +124 -215
  65. package/.agent/skills/github-operations/SKILL.md +314 -354
  66. package/.agent/skills/gsap-expert/SKILL.md +901 -0
  67. package/.agent/skills/i18n-localization/SKILL.md +138 -216
  68. package/.agent/skills/intelligent-routing/SKILL.md +127 -139
  69. package/.agent/skills/llm-engineering/SKILL.md +357 -258
  70. package/.agent/skills/local-first/SKILL.md +154 -203
  71. package/.agent/skills/mcp-builder/SKILL.md +118 -224
  72. package/.agent/skills/nextjs-react-expert/SKILL.md +783 -203
  73. package/.agent/skills/nodejs-best-practices/SKILL.md +559 -280
  74. package/.agent/skills/observability/SKILL.md +330 -285
  75. package/.agent/skills/parallel-agents/SKILL.md +122 -181
  76. package/.agent/skills/performance-profiling/SKILL.md +254 -197
  77. package/.agent/skills/plan-writing/SKILL.md +118 -188
  78. package/.agent/skills/platform-engineer/SKILL.md +123 -135
  79. package/.agent/skills/playwright-best-practices/SKILL.md +157 -76
  80. package/.agent/skills/powershell-windows/SKILL.md +146 -230
  81. package/.agent/skills/python-pro/SKILL.md +879 -114
  82. package/.agent/skills/react-specialist/SKILL.md +931 -108
  83. package/.agent/skills/realtime-patterns/SKILL.md +304 -296
  84. package/.agent/skills/rust-pro/SKILL.md +701 -240
  85. package/.agent/skills/seo-fundamentals/SKILL.md +154 -181
  86. package/.agent/skills/server-management/SKILL.md +190 -212
  87. package/.agent/skills/shadcn-ui-expert/SKILL.md +201 -68
  88. package/.agent/skills/sql-pro/SKILL.md +633 -104
  89. package/.agent/skills/swiftui-expert/SKILL.md +171 -70
  90. package/.agent/skills/systematic-debugging/SKILL.md +118 -186
  91. package/.agent/skills/tailwind-patterns/SKILL.md +576 -232
  92. package/.agent/skills/tdd-workflow/SKILL.md +137 -209
  93. package/.agent/skills/testing-patterns/SKILL.md +573 -205
  94. package/.agent/skills/vue-expert/SKILL.md +964 -119
  95. package/.agent/skills/vulnerability-scanner/SKILL.md +269 -316
  96. package/.agent/skills/web-accessibility-auditor/SKILL.md +188 -71
  97. package/.agent/skills/webapp-testing/SKILL.md +145 -236
  98. package/.agent/workflows/api-tester.md +151 -279
  99. package/.agent/workflows/audit.md +138 -168
  100. package/.agent/workflows/brainstorm.md +110 -146
  101. package/.agent/workflows/changelog.md +112 -144
  102. package/.agent/workflows/create.md +124 -139
  103. package/.agent/workflows/debug.md +189 -196
  104. package/.agent/workflows/deploy.md +189 -153
  105. package/.agent/workflows/enhance.md +151 -139
  106. package/.agent/workflows/fix.md +135 -143
  107. package/.agent/workflows/generate.md +157 -164
  108. package/.agent/workflows/migrate.md +160 -163
  109. package/.agent/workflows/orchestrate.md +168 -151
  110. package/.agent/workflows/performance-benchmarker.md +123 -305
  111. package/.agent/workflows/plan.md +173 -151
  112. package/.agent/workflows/preview.md +80 -137
  113. package/.agent/workflows/refactor.md +183 -153
  114. package/.agent/workflows/review-ai.md +129 -140
  115. package/.agent/workflows/review.md +116 -155
  116. package/.agent/workflows/session.md +94 -154
  117. package/.agent/workflows/status.md +79 -125
  118. package/.agent/workflows/strengthen-skills.md +139 -99
  119. package/.agent/workflows/swarm.md +179 -194
  120. package/.agent/workflows/test.md +211 -166
  121. package/.agent/workflows/tribunal-backend.md +113 -111
  122. package/.agent/workflows/tribunal-database.md +115 -132
  123. package/.agent/workflows/tribunal-frontend.md +118 -115
  124. package/.agent/workflows/tribunal-full.md +133 -136
  125. package/.agent/workflows/tribunal-mobile.md +119 -123
  126. package/.agent/workflows/tribunal-performance.md +133 -152
  127. package/.agent/workflows/ui-ux-pro-max.md +143 -171
  128. package/README.md +11 -15
  129. package/package.json +1 -1
  130. package/.agent/skills/dotnet-core-expert/SKILL.md +0 -103
  131. package/.agent/skills/framer-motion-animations/SKILL.md +0 -74
  132. package/.agent/skills/game-development/2d-games/SKILL.md +0 -119
  133. package/.agent/skills/game-development/3d-games/SKILL.md +0 -135
  134. package/.agent/skills/game-development/SKILL.md +0 -236
  135. package/.agent/skills/game-development/game-art/SKILL.md +0 -185
  136. package/.agent/skills/game-development/game-audio/SKILL.md +0 -190
  137. package/.agent/skills/game-development/game-design/SKILL.md +0 -129
  138. package/.agent/skills/game-development/mobile-games/SKILL.md +0 -108
  139. package/.agent/skills/game-development/multiplayer/SKILL.md +0 -132
  140. package/.agent/skills/game-development/pc-games/SKILL.md +0 -144
  141. package/.agent/skills/game-development/vr-ar/SKILL.md +0 -123
  142. 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/image.png" alt="Tribunal Kit Logo" width="300">
3
+ <img src="./docs/tribunalkit_no_bg.png" alt="TribunalKit Code Without Hallucinations" width="480">
4
4
  </picture>
5
5
 
6
- <h1><b>TRIBUNAL—KIT</b></h1>
7
-
8
- <p><code>&lt; ZERO_HALLUCINATION_PROTOCOL /&gt;</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
  [![NPM](https://img.shields.io/npm/v/tribunal-kit?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/tribunal-kit)
16
9
  [![License](https://img.shields.io/badge/License-MIT-8b5cf6?style=for-the-badge)](LICENSE)
10
+ [![Version](https://img.shields.io/badge/Version-3.0.0-black?style=for-the-badge)](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** | `32` | Specialist personas (Security, DB Architect, DevOps Responder) |
72
- | 🧠 **Skills** | `44` | Domain modules (Edge Computing, Red Team Tactics, WebXR) |
73
- | ⚡ **Workflows** | `25` | Slash command procedures including `/swarm` orchestration |
74
- | 🛠️ **Scripts** | `13` | CI/CD, linting, payload dispatching, test suite runners |
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 8** reviewers simultaneously. Maximum scrutiny. |
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": "2.4.6",
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.