mirror of
https://github.com/Donchitos/Claude-Code-Game-Studios.git
synced 2026-10-16 10:17:06 +00:00
Release 1.1.2 — the default path works end to end
Fix release for 1.1.1: the minimal path end to end, engine commands that run on Godot, Unity and Unreal, hook warnings you can see, and verdicts that say when they could not check. Details in CHANGELOG.md; upgrade steps in UPGRADING.md (v1.1.1 → v1.1.2). Fixes #67 Fixes #131 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WuJn2FdynEybfL5KC697nJ
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
7ed2c3e9c4
commit
b21fa0f7f2
@@ -3,7 +3,6 @@
|
||||
## Agent Summary
|
||||
Domain: User experience flows, interaction design, information architecture, input handling design, and onboarding UX.
|
||||
Does NOT own: visual art style (art-director), UI implementation code (ui-programmer).
|
||||
Model tier: Sonnet (default).
|
||||
No gate IDs assigned.
|
||||
|
||||
---
|
||||
@@ -11,8 +10,8 @@ No gate IDs assigned.
|
||||
## Static Assertions (Structural)
|
||||
|
||||
- [ ] `description:` field is present and domain-specific (references UX flows / interaction design / information architecture)
|
||||
- [ ] `allowed-tools:` list includes Read, Write, Edit, Glob, Grep
|
||||
- [ ] Model tier is Sonnet (default for specialists)
|
||||
- [ ] `tools:` list includes Read, Write, Edit, Glob, Grep
|
||||
- [ ] Model tier is `inherit` — frontmatter `model:` reads exactly `inherit` (tiers: `.claude/docs/model-tiers.md`)
|
||||
- [ ] Agent definition does not claim authority over visual art direction or UI implementation code
|
||||
|
||||
---
|
||||
@@ -22,11 +21,13 @@ No gate IDs assigned.
|
||||
### Case 1: In-domain request — appropriate output
|
||||
**Input:** "Design the inventory management flow for a survival game."
|
||||
**Expected behavior:**
|
||||
- Produces a user flow diagram (states and transitions) for the inventory: open, browse, select item, sub-actions (equip/drop/combine), close
|
||||
- Defines all interaction states (default, hover, selected, empty-slot, locked-slot)
|
||||
- Specifies input mappings for each action (keyboard, gamepad if applicable)
|
||||
- Notes cognitive load considerations (e.g., maximum items visible without scrolling)
|
||||
- Before drafting, asks clarifying questions (core player goal, constraints such as input methods and scope, reference games) and presents 2-4 flow options with pros/cons grounded in UX theory (e.g., mental models, progressive disclosure, Fitts's Law), with a recommendation and the final choice deferred to the user
|
||||
- The drafted flow maps each step and transition: open, browse, select item, sub-actions (equip/drop/combine), close — and names the friction points it removes
|
||||
- Specifies button assignments and contextual actions for each input method in scope (keyboard/mouse, gamepad, touch if applicable)
|
||||
- Specifies player feedback for each action (visual, audio, haptic) so the player always knows what happened and why
|
||||
- Checks the flow against the agent's Accessibility Checklist (keyboard-only, gamepad-only, not reliant on color alone, readable at minimum font size)
|
||||
- Does NOT produce visual design (colors, icons) or implementation code
|
||||
- Asks "May I write this to [filepath]?" before writing the spec
|
||||
|
||||
### Case 2: Out-of-domain request — redirects correctly
|
||||
**Input:** "Implement the inventory screen in GDScript with drag-and-drop support."
|
||||
@@ -34,31 +35,31 @@ No gate IDs assigned.
|
||||
- Does NOT produce implementation code
|
||||
- Explicitly states that UI code implementation belongs to `ui-programmer`
|
||||
- Redirects the request to `ui-programmer`
|
||||
- Notes that the UX flow spec should be provided to ui-programmer as the implementation reference
|
||||
- Offers the part of the request it does own: the drag-and-drop interaction design (drag affordance, valid/invalid drop feedback, and a non-drag equivalent so the screen stays usable with gamepad only and keyboard only) for ui-programmer to implement against
|
||||
|
||||
### Case 3: Flow depth conflict — simplification
|
||||
**Input:** "The lead designer says the current 5-step crafting flow is too deep; maximum 3 steps allowed."
|
||||
**Expected behavior:**
|
||||
- Produces a revised 3-step flow that collapses the original 5-step sequence
|
||||
- Shows clearly what was merged or removed and why each collapse is safe from a usability standpoint
|
||||
- Does NOT simply remove steps without addressing the user's goal at each removed step
|
||||
- Flags if the 3-step constraint makes any required use case impossible and proposes an alternative
|
||||
- Presents 2-4 ways to reach a 3-step flow, each with pros/cons and a recommendation, and defers the choice to the user
|
||||
- For each option, shows which of the 5 steps are merged or removed and what each removed step did for the player, so the usability cost of the collapse is visible
|
||||
- Does NOT drop a step whose player goal has nowhere else to happen without saying so
|
||||
- Flags any required use case the 3-step limit cannot serve for user input, and proposes an alternative (e.g., progressive disclosure of advanced options)
|
||||
|
||||
### Case 4: Accessibility conflict
|
||||
**Input:** "The onboarding flow uses a timed prompt (auto-advances after 3 seconds) to keep pace, but this conflicts with accessibility requirements for user-controlled timing."
|
||||
**Expected behavior:**
|
||||
- Identifies the conflict with WCAG 2.1 2.2.1 (Timing Adjustable)
|
||||
- Does NOT override the accessibility requirement to preserve pace
|
||||
- Coordinates with `accessibility-specialist` to agree on a compliant solution
|
||||
- Proposes alternatives: pause-on-hover, skip button, settings option to disable auto-advance
|
||||
- Identifies the conflict: an auto-advancing prompt takes timing out of the player's control
|
||||
- Does NOT keep the auto-advance to preserve pace — accessibility requirements are not overridden for aesthetics
|
||||
- Coordinates with `accessibility-specialist`, which owns the WCAG criterion that applies (SC 2.2.1 Timing Adjustable), to agree on a compliant solution
|
||||
- Presents alternatives as options with pros/cons — player-advanced prompt, skip or pause control, a setting to disable auto-advance — and shows how each keeps the onboarding's information pacing
|
||||
|
||||
### Case 5: Context pass — player mental model research
|
||||
**Input:** Playtest research provided in context: "Players consistently expected the 'Crafting' option to be inside the Inventory screen, not in a separate top-level menu." Request: "Redesign the navigation IA for crafting."
|
||||
**Expected behavior:**
|
||||
- References the specific player expectation from the research (crafting expected inside inventory)
|
||||
- Restructures the information architecture to place crafting as a tab or panel within the inventory screen
|
||||
- Does NOT produce a design that contradicts the stated player mental model without explicit justification
|
||||
- Notes the research source in the rationale for the design decision
|
||||
- Presents IA options with pros/cons and recommends one that places crafting inside the inventory screen (e.g., a tab or panel), deferring the final choice to the user
|
||||
- Does NOT recommend a design that contradicts the stated player mental model without explicit justification
|
||||
- The WHY behind the recommendation cites the playtest finding and names it as the players' mental model
|
||||
|
||||
---
|
||||
|
||||
@@ -66,10 +67,11 @@ No gate IDs assigned.
|
||||
|
||||
- [ ] Stays within declared domain (UX flows, interaction design, IA, onboarding)
|
||||
- [ ] Redirects code implementation to ui-programmer, visual style to art-director
|
||||
- [ ] Returns structured findings (state diagrams, flow steps, input mappings) not freeform opinions
|
||||
- [ ] Coordinates with accessibility-specialist when flows have timing or cognitive load constraints
|
||||
- [ ] Designs flows based on provided user research, not assumed behavior
|
||||
- [ ] Presents 2-4 options with pros/cons and a recommendation before drafting, and defers the decision to the user
|
||||
- [ ] Coordinates with accessibility-specialist when a flow conflicts with an accessibility requirement
|
||||
- [ ] Grounds recommendations in provided player research when it is given, citing it in the rationale, rather than in assumed behavior
|
||||
- [ ] Documents rationale for flow decisions against user goals
|
||||
- [ ] Asks "May I write this to [filepath]?" before writing
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user