tribunal-kit 2.4.6 → 3.1.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 (250) hide show
  1. package/.agent/ARCHITECTURE.md +99 -99
  2. package/.agent/GEMINI.md +52 -52
  3. package/.agent/agents/accessibility-reviewer.md +139 -86
  4. package/.agent/agents/ai-code-reviewer.md +160 -90
  5. package/.agent/agents/backend-specialist.md +164 -127
  6. package/.agent/agents/code-archaeologist.md +115 -73
  7. package/.agent/agents/database-architect.md +130 -110
  8. package/.agent/agents/debugger.md +137 -97
  9. package/.agent/agents/dependency-reviewer.md +78 -30
  10. package/.agent/agents/devops-engineer.md +161 -118
  11. package/.agent/agents/documentation-writer.md +151 -87
  12. package/.agent/agents/explorer-agent.md +117 -99
  13. package/.agent/agents/frontend-reviewer.md +127 -47
  14. package/.agent/agents/frontend-specialist.md +169 -109
  15. package/.agent/agents/game-developer.md +28 -164
  16. package/.agent/agents/logic-reviewer.md +87 -49
  17. package/.agent/agents/mobile-developer.md +151 -103
  18. package/.agent/agents/mobile-reviewer.md +133 -50
  19. package/.agent/agents/orchestrator.md +121 -110
  20. package/.agent/agents/penetration-tester.md +103 -77
  21. package/.agent/agents/performance-optimizer.md +136 -92
  22. package/.agent/agents/performance-reviewer.md +139 -69
  23. package/.agent/agents/product-manager.md +104 -70
  24. package/.agent/agents/product-owner.md +6 -25
  25. package/.agent/agents/project-planner.md +95 -95
  26. package/.agent/agents/qa-automation-engineer.md +174 -87
  27. package/.agent/agents/security-auditor.md +133 -129
  28. package/.agent/agents/seo-specialist.md +160 -99
  29. package/.agent/agents/sql-reviewer.md +132 -44
  30. package/.agent/agents/supervisor-agent.md +137 -109
  31. package/.agent/agents/swarm-worker-contracts.md +17 -17
  32. package/.agent/agents/swarm-worker-registry.md +46 -46
  33. package/.agent/agents/test-coverage-reviewer.md +132 -53
  34. package/.agent/agents/test-engineer.md +0 -21
  35. package/.agent/agents/type-safety-reviewer.md +143 -33
  36. package/.agent/patterns/generator.md +9 -9
  37. package/.agent/patterns/inversion.md +12 -12
  38. package/.agent/patterns/pipeline.md +9 -9
  39. package/.agent/patterns/reviewer.md +13 -13
  40. package/.agent/patterns/tool-wrapper.md +9 -9
  41. package/.agent/rules/GEMINI.md +63 -63
  42. package/.agent/scripts/__pycache__/auto_preview.cpython-311.pyc +0 -0
  43. package/.agent/scripts/__pycache__/bundle_analyzer.cpython-311.pyc +0 -0
  44. package/.agent/scripts/__pycache__/checklist.cpython-311.pyc +0 -0
  45. package/.agent/scripts/__pycache__/dependency_analyzer.cpython-311.pyc +0 -0
  46. package/.agent/scripts/__pycache__/security_scan.cpython-311.pyc +0 -0
  47. package/.agent/scripts/__pycache__/session_manager.cpython-311.pyc +0 -0
  48. package/.agent/scripts/__pycache__/skill_integrator.cpython-311.pyc +0 -0
  49. package/.agent/scripts/__pycache__/swarm_dispatcher.cpython-311.pyc +0 -0
  50. package/.agent/scripts/__pycache__/test_runner.cpython-311.pyc +0 -0
  51. package/.agent/scripts/__pycache__/verify_all.cpython-311.pyc +0 -0
  52. package/.agent/scripts/compress_skills.py +167 -0
  53. package/.agent/scripts/consolidate_skills.py +173 -0
  54. package/.agent/scripts/deep_compress.py +202 -0
  55. package/.agent/scripts/minify_context.py +80 -0
  56. package/.agent/scripts/security_scan.py +1 -1
  57. package/.agent/scripts/strip_tribunal.py +41 -0
  58. package/.agent/skills/agent-organizer/SKILL.md +60 -100
  59. package/.agent/skills/agentic-patterns/SKILL.md +0 -70
  60. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +108 -53
  61. package/.agent/skills/api-patterns/SKILL.md +197 -257
  62. package/.agent/skills/api-security-auditor/SKILL.md +125 -57
  63. package/.agent/skills/app-builder/SKILL.md +326 -50
  64. package/.agent/skills/app-builder/templates/SKILL.md +13 -15
  65. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +16 -16
  66. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +22 -22
  67. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +18 -18
  68. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +20 -20
  69. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +17 -17
  70. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +18 -18
  71. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +21 -21
  72. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +19 -19
  73. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +26 -26
  74. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +26 -26
  75. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +19 -19
  76. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +18 -18
  77. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +20 -20
  78. package/.agent/skills/appflow-wireframe/SKILL.md +71 -98
  79. package/.agent/skills/architecture/SKILL.md +161 -200
  80. package/.agent/skills/authentication-best-practices/SKILL.md +121 -54
  81. package/.agent/skills/bash-linux/SKILL.md +71 -166
  82. package/.agent/skills/behavioral-modes/SKILL.md +8 -69
  83. package/.agent/skills/brainstorming/SKILL.md +345 -127
  84. package/.agent/skills/building-native-ui/SKILL.md +125 -57
  85. package/.agent/skills/clean-code/SKILL.md +266 -149
  86. package/.agent/skills/code-review-checklist/SKILL.md +0 -62
  87. package/.agent/skills/config-validator/SKILL.md +73 -131
  88. package/.agent/skills/csharp-developer/SKILL.md +434 -73
  89. package/.agent/skills/database-design/SKILL.md +190 -275
  90. package/.agent/skills/deployment-procedures/SKILL.md +81 -158
  91. package/.agent/skills/devops-engineer/SKILL.md +255 -94
  92. package/.agent/skills/devops-incident-responder/SKILL.md +50 -69
  93. package/.agent/skills/doc.md +5 -5
  94. package/.agent/skills/documentation-templates/SKILL.md +19 -63
  95. package/.agent/skills/edge-computing/SKILL.md +75 -165
  96. package/.agent/skills/extract-design-system/SKILL.md +84 -58
  97. package/.agent/skills/framer-motion-expert/SKILL.md +195 -0
  98. package/.agent/skills/frontend-design/SKILL.md +151 -499
  99. package/.agent/skills/game-design-expert/SKILL.md +71 -0
  100. package/.agent/skills/game-engineering-expert/SKILL.md +88 -0
  101. package/.agent/skills/geo-fundamentals/SKILL.md +52 -178
  102. package/.agent/skills/github-operations/SKILL.md +197 -272
  103. package/.agent/skills/gsap-expert/SKILL.md +194 -0
  104. package/.agent/skills/i18n-localization/SKILL.md +60 -172
  105. package/.agent/skills/intelligent-routing/SKILL.md +123 -103
  106. package/.agent/skills/lint-and-validate/SKILL.md +8 -52
  107. package/.agent/skills/llm-engineering/SKILL.md +281 -195
  108. package/.agent/skills/local-first/SKILL.md +76 -159
  109. package/.agent/skills/mcp-builder/SKILL.md +48 -188
  110. package/.agent/skills/mobile-design/SKILL.md +213 -219
  111. package/.agent/skills/motion-engineering/SKILL.md +184 -0
  112. package/.agent/skills/nextjs-react-expert/SKILL.md +184 -203
  113. package/.agent/skills/nodejs-best-practices/SKILL.md +403 -185
  114. package/.agent/skills/observability/SKILL.md +211 -203
  115. package/.agent/skills/parallel-agents/SKILL.md +53 -146
  116. package/.agent/skills/performance-profiling/SKILL.md +171 -151
  117. package/.agent/skills/plan-writing/SKILL.md +49 -153
  118. package/.agent/skills/platform-engineer/SKILL.md +57 -103
  119. package/.agent/skills/playwright-best-practices/SKILL.md +110 -63
  120. package/.agent/skills/powershell-windows/SKILL.md +61 -179
  121. package/.agent/skills/python-patterns/SKILL.md +7 -35
  122. package/.agent/skills/python-pro/SKILL.md +273 -114
  123. package/.agent/skills/react-specialist/SKILL.md +227 -108
  124. package/.agent/skills/readme-builder/SKILL.md +15 -85
  125. package/.agent/skills/realtime-patterns/SKILL.md +216 -243
  126. package/.agent/skills/red-team-tactics/SKILL.md +10 -51
  127. package/.agent/skills/rust-pro/SKILL.md +525 -142
  128. package/.agent/skills/seo-fundamentals/SKILL.md +92 -153
  129. package/.agent/skills/server-management/SKILL.md +110 -166
  130. package/.agent/skills/shadcn-ui-expert/SKILL.md +154 -55
  131. package/.agent/skills/skill-creator/SKILL.md +18 -58
  132. package/.agent/skills/sql-pro/SKILL.md +543 -68
  133. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +28 -68
  134. package/.agent/skills/swiftui-expert/SKILL.md +124 -57
  135. package/.agent/skills/systematic-debugging/SKILL.md +49 -151
  136. package/.agent/skills/tailwind-patterns/SKILL.md +433 -149
  137. package/.agent/skills/tdd-workflow/SKILL.md +63 -169
  138. package/.agent/skills/test-result-analyzer/SKILL.md +33 -73
  139. package/.agent/skills/testing-patterns/SKILL.md +437 -130
  140. package/.agent/skills/trend-researcher/SKILL.md +30 -71
  141. package/.agent/skills/ui-ux-pro-max/SKILL.md +0 -41
  142. package/.agent/skills/ui-ux-researcher/SKILL.md +51 -91
  143. package/.agent/skills/vue-expert/SKILL.md +225 -119
  144. package/.agent/skills/vulnerability-scanner/SKILL.md +264 -226
  145. package/.agent/skills/web-accessibility-auditor/SKILL.md +141 -58
  146. package/.agent/skills/web-design-guidelines/SKILL.md +17 -61
  147. package/.agent/skills/webapp-testing/SKILL.md +71 -196
  148. package/.agent/skills/whimsy-injector/SKILL.md +58 -132
  149. package/.agent/skills/workflow-optimizer/SKILL.md +28 -68
  150. package/.agent/workflows/api-tester.md +96 -224
  151. package/.agent/workflows/audit.md +81 -122
  152. package/.agent/workflows/brainstorm.md +69 -105
  153. package/.agent/workflows/changelog.md +65 -97
  154. package/.agent/workflows/create.md +73 -88
  155. package/.agent/workflows/debug.md +80 -111
  156. package/.agent/workflows/deploy.md +119 -92
  157. package/.agent/workflows/enhance.md +80 -91
  158. package/.agent/workflows/fix.md +68 -97
  159. package/.agent/workflows/generate.md +165 -164
  160. package/.agent/workflows/migrate.md +106 -109
  161. package/.agent/workflows/orchestrate.md +103 -86
  162. package/.agent/workflows/performance-benchmarker.md +77 -268
  163. package/.agent/workflows/plan.md +120 -98
  164. package/.agent/workflows/preview.md +39 -96
  165. package/.agent/workflows/refactor.md +105 -97
  166. package/.agent/workflows/review-ai.md +63 -102
  167. package/.agent/workflows/review.md +71 -110
  168. package/.agent/workflows/session.md +53 -113
  169. package/.agent/workflows/status.md +42 -88
  170. package/.agent/workflows/strengthen-skills.md +90 -51
  171. package/.agent/workflows/swarm.md +114 -129
  172. package/.agent/workflows/test.md +125 -102
  173. package/.agent/workflows/tribunal-backend.md +60 -78
  174. package/.agent/workflows/tribunal-database.md +62 -100
  175. package/.agent/workflows/tribunal-frontend.md +62 -82
  176. package/.agent/workflows/tribunal-full.md +56 -100
  177. package/.agent/workflows/tribunal-mobile.md +65 -94
  178. package/.agent/workflows/tribunal-performance.md +62 -105
  179. package/.agent/workflows/ui-ux-pro-max.md +72 -121
  180. package/README.md +11 -15
  181. package/package.json +1 -1
  182. package/.agent/skills/api-patterns/api-style.md +0 -42
  183. package/.agent/skills/api-patterns/auth.md +0 -24
  184. package/.agent/skills/api-patterns/documentation.md +0 -26
  185. package/.agent/skills/api-patterns/graphql.md +0 -41
  186. package/.agent/skills/api-patterns/rate-limiting.md +0 -31
  187. package/.agent/skills/api-patterns/response.md +0 -37
  188. package/.agent/skills/api-patterns/rest.md +0 -40
  189. package/.agent/skills/api-patterns/security-testing.md +0 -122
  190. package/.agent/skills/api-patterns/trpc.md +0 -41
  191. package/.agent/skills/api-patterns/versioning.md +0 -22
  192. package/.agent/skills/app-builder/agent-coordination.md +0 -71
  193. package/.agent/skills/app-builder/feature-building.md +0 -53
  194. package/.agent/skills/app-builder/project-detection.md +0 -34
  195. package/.agent/skills/app-builder/scaffolding.md +0 -118
  196. package/.agent/skills/app-builder/tech-stack.md +0 -40
  197. package/.agent/skills/architecture/context-discovery.md +0 -43
  198. package/.agent/skills/architecture/examples.md +0 -94
  199. package/.agent/skills/architecture/pattern-selection.md +0 -68
  200. package/.agent/skills/architecture/patterns-reference.md +0 -50
  201. package/.agent/skills/architecture/trade-off-analysis.md +0 -77
  202. package/.agent/skills/brainstorming/dynamic-questioning.md +0 -360
  203. package/.agent/skills/database-design/database-selection.md +0 -43
  204. package/.agent/skills/database-design/indexing.md +0 -39
  205. package/.agent/skills/database-design/migrations.md +0 -48
  206. package/.agent/skills/database-design/optimization.md +0 -36
  207. package/.agent/skills/database-design/orm-selection.md +0 -30
  208. package/.agent/skills/database-design/schema-design.md +0 -56
  209. package/.agent/skills/dotnet-core-expert/SKILL.md +0 -103
  210. package/.agent/skills/framer-motion-animations/SKILL.md +0 -74
  211. package/.agent/skills/frontend-design/animation-guide.md +0 -331
  212. package/.agent/skills/frontend-design/color-system.md +0 -329
  213. package/.agent/skills/frontend-design/decision-trees.md +0 -418
  214. package/.agent/skills/frontend-design/motion-graphics.md +0 -306
  215. package/.agent/skills/frontend-design/typography-system.md +0 -363
  216. package/.agent/skills/frontend-design/ux-psychology.md +0 -1116
  217. package/.agent/skills/frontend-design/visual-effects.md +0 -383
  218. package/.agent/skills/game-development/2d-games/SKILL.md +0 -119
  219. package/.agent/skills/game-development/3d-games/SKILL.md +0 -135
  220. package/.agent/skills/game-development/SKILL.md +0 -236
  221. package/.agent/skills/game-development/game-art/SKILL.md +0 -185
  222. package/.agent/skills/game-development/game-audio/SKILL.md +0 -190
  223. package/.agent/skills/game-development/game-design/SKILL.md +0 -129
  224. package/.agent/skills/game-development/mobile-games/SKILL.md +0 -108
  225. package/.agent/skills/game-development/multiplayer/SKILL.md +0 -132
  226. package/.agent/skills/game-development/pc-games/SKILL.md +0 -144
  227. package/.agent/skills/game-development/vr-ar/SKILL.md +0 -123
  228. package/.agent/skills/game-development/web-games/SKILL.md +0 -150
  229. package/.agent/skills/intelligent-routing/router-manifest.md +0 -65
  230. package/.agent/skills/mobile-design/decision-trees.md +0 -516
  231. package/.agent/skills/mobile-design/mobile-backend.md +0 -491
  232. package/.agent/skills/mobile-design/mobile-color-system.md +0 -420
  233. package/.agent/skills/mobile-design/mobile-debugging.md +0 -122
  234. package/.agent/skills/mobile-design/mobile-design-thinking.md +0 -357
  235. package/.agent/skills/mobile-design/mobile-navigation.md +0 -458
  236. package/.agent/skills/mobile-design/mobile-performance.md +0 -767
  237. package/.agent/skills/mobile-design/mobile-testing.md +0 -356
  238. package/.agent/skills/mobile-design/mobile-typography.md +0 -433
  239. package/.agent/skills/mobile-design/platform-android.md +0 -666
  240. package/.agent/skills/mobile-design/platform-ios.md +0 -561
  241. package/.agent/skills/mobile-design/touch-psychology.md +0 -537
  242. package/.agent/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +0 -312
  243. package/.agent/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +0 -240
  244. package/.agent/skills/nextjs-react-expert/3-server-server-side-performance.md +0 -490
  245. package/.agent/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +0 -264
  246. package/.agent/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +0 -581
  247. package/.agent/skills/nextjs-react-expert/6-rendering-rendering-performance.md +0 -432
  248. package/.agent/skills/nextjs-react-expert/7-js-javascript-performance.md +0 -684
  249. package/.agent/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +0 -150
  250. package/.agent/skills/vulnerability-scanner/checklists.md +0 -121
@@ -1,129 +0,0 @@
1
- ---
2
- name: game-design
3
- description: Game design principles. GDD structure, balancing, player psychology, progression.
4
- allowed-tools: Read, Glob, Grep
5
- ---
6
-
7
- # Game Design Principles
8
-
9
- > Design thinking for engaging games.
10
-
11
- ---
12
-
13
- ## 1. Core Loop Design
14
-
15
- ### The 30-Second Test
16
-
17
- ```
18
- Every game needs a fun 30-second loop:
19
- 1. ACTION → Player does something
20
- 2. FEEDBACK → Game responds
21
- 3. REWARD → Player feels good
22
- 4. REPEAT
23
- ```
24
-
25
- ### Loop Examples
26
-
27
- | Genre | Core Loop |
28
- |-------|-----------|
29
- | Platformer | Run → Jump → Land → Collect |
30
- | Shooter | Aim → Shoot → Kill → Loot |
31
- | Puzzle | Observe → Think → Solve → Advance |
32
- | RPG | Explore → Fight → Level → Gear |
33
-
34
- ---
35
-
36
- ## 2. Game Design Document (GDD)
37
-
38
- ### Essential Sections
39
-
40
- | Section | Content |
41
- |---------|---------|
42
- | **Pitch** | One-sentence description |
43
- | **Core Loop** | 30-second gameplay |
44
- | **Mechanics** | How systems work |
45
- | **Progression** | How player advances |
46
- | **Art Style** | Visual direction |
47
- | **Audio** | Sound direction |
48
-
49
- ### Principles
50
-
51
- - Keep it living (update regularly)
52
- - Visuals help communicate
53
- - Less is more (start small)
54
-
55
- ---
56
-
57
- ## 3. Player Psychology
58
-
59
- ### Motivation Types
60
-
61
- | Type | Driven By |
62
- |------|-----------|
63
- | **Achiever** | Goals, completion |
64
- | **Explorer** | Discovery, secrets |
65
- | **Socializer** | Interaction, community |
66
- | **Killer** | Competition, dominance |
67
-
68
- ### Reward Schedules
69
-
70
- | Schedule | Effect | Use |
71
- |----------|--------|-----|
72
- | **Fixed** | Predictable | Milestone rewards |
73
- | **Variable** | Addictive | Loot drops |
74
- | **Ratio** | Effort-based | Grind games |
75
-
76
- ---
77
-
78
- ## 4. Difficulty Balancing
79
-
80
- ### Flow State
81
-
82
- ```
83
- Too Hard → Frustration → Quit
84
- Too Easy → Boredom → Quit
85
- Just Right → Flow → Engagement
86
- ```
87
-
88
- ### Balancing Strategies
89
-
90
- | Strategy | How |
91
- |----------|-----|
92
- | **Dynamic** | Adjust to player skill |
93
- | **Selection** | Let player choose |
94
- | **Accessibility** | Options for all |
95
-
96
- ---
97
-
98
- ## 5. Progression Design
99
-
100
- ### Progression Types
101
-
102
- | Type | Example |
103
- |------|---------|
104
- | **Skill** | Player gets better |
105
- | **Power** | Character gets stronger |
106
- | **Content** | New areas unlock |
107
- | **Story** | Narrative advances |
108
-
109
- ### Pacing Principles
110
-
111
- - Early wins (hook quickly)
112
- - Gradually increase challenge
113
- - Rest beats between intensity
114
- - Meaningful choices
115
-
116
- ---
117
-
118
- ## 6. Anti-Patterns
119
-
120
- | ❌ Don't | ✅ Do |
121
- |----------|-------|
122
- | Design in isolation | Playtest constantly |
123
- | Polish before fun | Prototype first |
124
- | Force one way to play | Allow player expression |
125
- | Punish excessively | Reward progress |
126
-
127
- ---
128
-
129
- > **Remember:** Fun is discovered through iteration, not designed on paper.
@@ -1,108 +0,0 @@
1
- ---
2
- name: mobile-games
3
- description: Mobile game development principles. Touch input, battery, performance, app stores.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- ---
6
-
7
- # Mobile Game Development
8
-
9
- > Platform constraints and optimization principles.
10
-
11
- ---
12
-
13
- ## 1. Platform Considerations
14
-
15
- ### Key Constraints
16
-
17
- | Constraint | Strategy |
18
- |------------|----------|
19
- | **Touch input** | Large hit areas, gestures |
20
- | **Battery** | Limit CPU/GPU usage |
21
- | **Thermal** | Throttle when hot |
22
- | **Screen size** | Responsive UI |
23
- | **Interruptions** | Pause on background |
24
-
25
- ---
26
-
27
- ## 2. Touch Input Principles
28
-
29
- ### Touch vs Controller
30
-
31
- | Touch | Desktop/Console |
32
- |-------|-----------------|
33
- | Imprecise | Precise |
34
- | Occludes screen | No occlusion |
35
- | Limited buttons | Many buttons |
36
- | Gestures available | Buttons/sticks |
37
-
38
- ### Best Practices
39
-
40
- - Minimum touch target: 44x44 points
41
- - Visual feedback on touch
42
- - Avoid precise timing requirements
43
- - Support both portrait and landscape
44
-
45
- ---
46
-
47
- ## 3. Performance Targets
48
-
49
- ### Thermal Management
50
-
51
- | Action | Trigger |
52
- |--------|---------|
53
- | Reduce quality | Device warm |
54
- | Limit FPS | Device hot |
55
- | Pause effects | Critical temp |
56
-
57
- ### Battery Optimization
58
-
59
- - 30 FPS often sufficient
60
- - Sleep when paused
61
- - Minimize GPS/network
62
- - Dark mode saves OLED battery
63
-
64
- ---
65
-
66
- ## 4. App Store Requirements
67
-
68
- ### iOS (App Store)
69
-
70
- | Requirement | Note |
71
- |-------------|------|
72
- | Privacy labels | Required |
73
- | Account deletion | If account creation exists |
74
- | Screenshots | For all device sizes |
75
-
76
- ### Android (Google Play)
77
-
78
- | Requirement | Note |
79
- |-------------|------|
80
- | Target API | Current year's SDK |
81
- | 64-bit | Required |
82
- | App bundles | Recommended |
83
-
84
- ---
85
-
86
- ## 5. Monetization Models
87
-
88
- | Model | Best For |
89
- |-------|----------|
90
- | **Premium** | Quality games, loyal audience |
91
- | **Free + IAP** | Casual, progression-based |
92
- | **Ads** | Hyper-casual, high volume |
93
- | **Subscription** | Content updates, multiplayer |
94
-
95
- ---
96
-
97
- ## 6. Anti-Patterns
98
-
99
- | ❌ Don't | ✅ Do |
100
- |----------|-------|
101
- | Desktop controls on mobile | Design for touch |
102
- | Ignore battery drain | Monitor thermals |
103
- | Force landscape | Support player preference |
104
- | Always-on network | Cache and sync |
105
-
106
- ---
107
-
108
- > **Remember:** Mobile is the most constrained platform. Respect battery and attention.
@@ -1,132 +0,0 @@
1
- ---
2
- name: multiplayer
3
- description: Multiplayer game development principles. Architecture, networking, synchronization.
4
- allowed-tools: Read, Write, Edit, Glob, Grep, Bash
5
- ---
6
-
7
- # Multiplayer Game Development
8
-
9
- > Networking architecture and synchronization principles.
10
-
11
- ---
12
-
13
- ## 1. Architecture Selection
14
-
15
- ### Decision Tree
16
-
17
- ```
18
- What type of multiplayer?
19
-
20
- ├── Competitive / Real-time
21
- │ └── Dedicated Server (authoritative)
22
-
23
- ├── Cooperative / Casual
24
- │ └── Host-based (one player is server)
25
-
26
- ├── Turn-based
27
- │ └── Client-server (simple)
28
-
29
- └── Massive (MMO)
30
- └── Distributed servers
31
- ```
32
-
33
- ### Comparison
34
-
35
- | Architecture | Latency | Cost | Security |
36
- |--------------|---------|------|----------|
37
- | **Dedicated** | Low | High | Strong |
38
- | **P2P** | Variable | Low | Weak |
39
- | **Host-based** | Medium | Low | Medium |
40
-
41
- ---
42
-
43
- ## 2. Synchronization Principles
44
-
45
- ### State vs Input
46
-
47
- | Approach | Sync What | Best For |
48
- |----------|-----------|----------|
49
- | **State Sync** | Game state | Simple, few objects |
50
- | **Input Sync** | Player inputs | Action games |
51
- | **Hybrid** | Both | Most games |
52
-
53
- ### Lag Compensation
54
-
55
- | Technique | Purpose |
56
- |-----------|---------|
57
- | **Prediction** | Client predicts server |
58
- | **Interpolation** | Smooth remote players |
59
- | **Reconciliation** | Fix mispredictions |
60
- | **Lag compensation** | Rewind for hit detection |
61
-
62
- ---
63
-
64
- ## 3. Network Optimization
65
-
66
- ### Bandwidth Reduction
67
-
68
- | Technique | Savings |
69
- |-----------|---------|
70
- | **Delta compression** | Send only changes |
71
- | **Quantization** | Reduce precision |
72
- | **Priority** | Important data first |
73
- | **Area of interest** | Only nearby entities |
74
-
75
- ### Update Rates
76
-
77
- | Type | Rate |
78
- |------|------|
79
- | Position | 20-60 Hz |
80
- | Health | On change |
81
- | Inventory | On change |
82
- | Chat | On send |
83
-
84
- ---
85
-
86
- ## 4. Security Principles
87
-
88
- ### Server Authority
89
-
90
- ```
91
- Client: "I hit the enemy"
92
- Server: Validate → did projectile actually hit?
93
- → was player in valid state?
94
- → was timing possible?
95
- ```
96
-
97
- ### Anti-Cheat
98
-
99
- | Cheat | Prevention |
100
- |-------|------------|
101
- | Speed hack | Server validates movement |
102
- | Aimbot | Server validates sight line |
103
- | Item dupe | Server owns inventory |
104
- | Wall hack | Don't send hidden data |
105
-
106
- ---
107
-
108
- ## 5. Matchmaking
109
-
110
- ### Considerations
111
-
112
- | Factor | Impact |
113
- |--------|--------|
114
- | **Skill** | Fair matches |
115
- | **Latency** | Playable connection |
116
- | **Wait time** | Player patience |
117
- | **Party size** | Group play |
118
-
119
- ---
120
-
121
- ## 6. Anti-Patterns
122
-
123
- | ❌ Don't | ✅ Do |
124
- |----------|-------|
125
- | Trust the client | Server is authority |
126
- | Send everything | Send only necessary |
127
- | Ignore latency | Design for 100-200ms |
128
- | Sync exact positions | Interpolate/predict |
129
-
130
- ---
131
-
132
- > **Remember:** Never trust the client. The server is the source of truth.
@@ -1,144 +0,0 @@
1
- ---
2
- name: pc-games
3
- description: PC and console game development principles. Engine selection, platform features, optimization strategies.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- ---
6
-
7
- # PC/Console Game Development
8
-
9
- > Engine selection and platform-specific principles.
10
-
11
- ---
12
-
13
- ## 1. Engine Selection
14
-
15
- ### Decision Tree
16
-
17
- ```
18
- What are you building?
19
-
20
- ├── 2D Game
21
- │ ├── Open source important? → Godot
22
- │ └── Large team/assets? → Unity
23
-
24
- ├── 3D Game
25
- │ ├── AAA visual quality? → Unreal
26
- │ ├── Cross-platform priority? → Unity
27
- │ └── Indie/open source? → Godot 4
28
-
29
- └── Specific Needs
30
- ├── DOTS performance? → Unity
31
- ├── Nanite/Lumen? → Unreal
32
- └── Lightweight? → Godot
33
- ```
34
-
35
- ### Comparison
36
-
37
- | Factor | Unity 6 | Godot 4 | Unreal 5 |
38
- |--------|---------|---------|----------|
39
- | 2D | Good | Excellent | Limited |
40
- | 3D | Good | Good | Excellent |
41
- | Learning | Medium | Easy | Hard |
42
- | Cost | Revenue share | Free | 5% after $1M |
43
- | Team | Any | Solo-Medium | Medium-Large |
44
-
45
- ---
46
-
47
- ## 2. Platform Features
48
-
49
- ### Steam Integration
50
-
51
- | Feature | Purpose |
52
- |---------|---------|
53
- | Achievements | Player goals |
54
- | Cloud Saves | Cross-device progress |
55
- | Leaderboards | Competition |
56
- | Workshop | User mods |
57
- | Rich Presence | Show in-game status |
58
-
59
- ### Console Requirements
60
-
61
- | Platform | Certification |
62
- |----------|--------------|
63
- | PlayStation | TRC compliance |
64
- | Xbox | XR compliance |
65
- | Nintendo | Lotcheck |
66
-
67
- ---
68
-
69
- ## 3. Controller Support
70
-
71
- ### Input Abstraction
72
-
73
- ```
74
- Map ACTIONS, not buttons:
75
- - "confirm" → A (Xbox), Cross (PS), B (Nintendo)
76
- - "cancel" → B (Xbox), Circle (PS), A (Nintendo)
77
- ```
78
-
79
- ### Haptic Feedback
80
-
81
- | Intensity | Use |
82
- |-----------|-----|
83
- | Light | UI feedback |
84
- | Medium | Impacts |
85
- | Heavy | Major events |
86
-
87
- ---
88
-
89
- ## 4. Performance Optimization
90
-
91
- ### Profiling First
92
-
93
- | Engine | Tool |
94
- |--------|------|
95
- | Unity | Profiler Window |
96
- | Godot | Debugger → Profiler |
97
- | Unreal | Unreal Insights |
98
-
99
- ### Common Bottlenecks
100
-
101
- | Bottleneck | Solution |
102
- |------------|----------|
103
- | Draw calls | Batching, atlases |
104
- | GC spikes | Object pooling |
105
- | Physics | Simpler colliders |
106
- | Shaders | LOD shaders |
107
-
108
- ---
109
-
110
- ## 5. Engine-Specific Principles
111
-
112
- ### Unity 6
113
-
114
- - DOTS for performance-critical systems
115
- - Burst compiler for hot paths
116
- - Addressables for asset streaming
117
-
118
- ### Godot 4
119
-
120
- - GDScript for rapid iteration
121
- - C# for complex logic
122
- - Signals for decoupling
123
-
124
- ### Unreal 5
125
-
126
- - Blueprint for designers
127
- - C++ for performance
128
- - Nanite for high-poly environments
129
- - Lumen for dynamic lighting
130
-
131
- ---
132
-
133
- ## 6. Anti-Patterns
134
-
135
- | ❌ Don't | ✅ Do |
136
- |----------|-------|
137
- | Choose engine by hype | Choose by project needs |
138
- | Ignore platform guidelines | Study certification requirements |
139
- | Hardcode input buttons | Abstract to actions |
140
- | Skip profiling | Profile early and often |
141
-
142
- ---
143
-
144
- > **Remember:** Engine is a tool. Master the principles, then adapt to any engine.
@@ -1,123 +0,0 @@
1
- ---
2
- name: vr-ar
3
- description: VR/AR development principles. Comfort, interaction, performance requirements.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- ---
6
-
7
- # VR/AR Development
8
-
9
- > Immersive experience principles.
10
-
11
- ---
12
-
13
- ## 1. Platform Selection
14
-
15
- ### VR Platforms
16
-
17
- | Platform | Use Case |
18
- |----------|----------|
19
- | **Quest** | Standalone, wireless |
20
- | **PCVR** | High fidelity |
21
- | **PSVR** | Console market |
22
- | **WebXR** | Browser-based |
23
-
24
- ### AR Platforms
25
-
26
- | Platform | Use Case |
27
- |----------|----------|
28
- | **ARKit** | iOS devices |
29
- | **ARCore** | Android devices |
30
- | **WebXR** | Browser AR |
31
- | **HoloLens** | Enterprise |
32
-
33
- ---
34
-
35
- ## 2. Comfort Principles
36
-
37
- ### Motion Sickness Prevention
38
-
39
- | Cause | Solution |
40
- |-------|----------|
41
- | **Locomotion** | Teleport, snap turn |
42
- | **Low FPS** | Maintain 90 FPS |
43
- | **Camera shake** | Avoid or minimize |
44
- | **Rapid acceleration** | Gradual movement |
45
-
46
- ### Comfort Settings
47
-
48
- - Vignette during movement
49
- - Snap vs smooth turning
50
- - Seated vs standing modes
51
- - Height calibration
52
-
53
- ---
54
-
55
- ## 3. Performance Requirements
56
-
57
- ### Target Metrics
58
-
59
- | Platform | FPS | Resolution |
60
- |----------|-----|------------|
61
- | Quest 2 | 72-90 | 1832x1920 |
62
- | Quest 3 | 90-120 | 2064x2208 |
63
- | PCVR | 90 | 2160x2160+ |
64
- | PSVR2 | 90-120 | 2000x2040 |
65
-
66
- ### Frame Budget
67
-
68
- - VR requires consistent frame times
69
- - Single dropped frame = visible judder
70
- - 90 FPS = 11.11ms budget
71
-
72
- ---
73
-
74
- ## 4. Interaction Principles
75
-
76
- ### Controller Interaction
77
-
78
- | Type | Use |
79
- |------|-----|
80
- | **Point + click** | UI, distant objects |
81
- | **Grab** | Manipulation |
82
- | **Gesture** | Magic, special actions |
83
- | **Physical** | Throwing, swinging |
84
-
85
- ### Hand Tracking
86
-
87
- - More immersive but less precise
88
- - Good for: social, casual
89
- - Challenging for: action, precision
90
-
91
- ---
92
-
93
- ## 5. Spatial Design
94
-
95
- ### World Scale
96
-
97
- - 1 unit = 1 meter (critical)
98
- - Objects must feel right size
99
- - Test with real measurements
100
-
101
- ### Depth Cues
102
-
103
- | Cue | Importance |
104
- |-----|------------|
105
- | Stereo | Primary depth |
106
- | Motion parallax | Secondary |
107
- | Shadows | Grounding |
108
- | Occlusion | Layering |
109
-
110
- ---
111
-
112
- ## 6. Anti-Patterns
113
-
114
- | ❌ Don't | ✅ Do |
115
- |----------|-------|
116
- | Move camera without player | Player controls camera |
117
- | Drop below 90 FPS | Maintain frame rate |
118
- | Use tiny UI text | Large, readable text |
119
- | Ignore arm length | Scale to player reach |
120
-
121
- ---
122
-
123
- > **Remember:** Comfort is not optional. Sick players don't play.