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
@@ -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.