mirror of
https://github.com/Donchitos/Claude-Code-Game-Studios.git
synced 2026-10-16 09:58:36 +00:00
DonchitosandClaude Opus 5.5
b21fa0f7f2
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
83 lines
6.7 KiB
Markdown
83 lines
6.7 KiB
Markdown
# Agent Test Spec: writer
|
|
|
|
## Agent Summary
|
|
- **Domain**: In-game written content — NPC dialogue (including branching trees), lore codex entries, item and ability descriptions, environmental text (signs, books, notes), quest text, tutorial text, in-world written documents
|
|
- **Does NOT own**: Story architecture and narrative structure (narrative-director), world lore and world rules (world-builder), UX flows and information architecture (ux-designer; it writes UI microcopy, not the UX around it), patch notes (community-manager)
|
|
- **Gate IDs**: None; flags lore inconsistencies to narrative-director rather than resolving them autonomously
|
|
|
|
---
|
|
|
|
## Static Assertions (Structural)
|
|
|
|
- [ ] `description:` field is present and domain-specific (references dialogue, lore entries, item descriptions, in-game text)
|
|
- [ ] `tools:` reads Read, Glob, Grep, Write, Edit and `disallowedTools:` lists Bash — text authoring only, no shell or code execution
|
|
- [ ] Model tier is `inherit` — frontmatter `model:` reads exactly `inherit` (tiers: `.claude/docs/model-tiers.md`)
|
|
- [ ] Agent definition does not claim authority over narrative structure, world rules, or UX copy direction
|
|
|
|
---
|
|
|
|
## Test Cases
|
|
|
|
### Case 1: In-domain request — NPC merchant dialogue
|
|
**Input**: "Write dialogue for Mira, a traveling merchant NPC. She sells general supplies. Players can ask her about her wares, the road ahead, and rumors."
|
|
**Expected behavior**:
|
|
- Looks for Mira's voice profile (voice profiles are defined by narrative-director); if none is provided, says so and asks, or proposes a provisional voice for approval — it does not decide her character arc
|
|
- Produces a dialogue tree with at least three top-level conversation options: [Wares], [The Road Ahead], [Rumors], and at least one follow-up branch (tree structure, not flat responses)
|
|
- Every line has a speaker tag and a context note, and branch conditions carry condition/state annotations in a consistent format
|
|
- No line exceeds 120 characters; any variable insertion uses a named placeholder (e.g., `{player_name}`)
|
|
- Road and rumor content does not contradict established world-building
|
|
- Drafts in conversation and asks "May I write this to [filepath]?" before writing (for a multi-section file, it first asks to create the section skeleton)
|
|
|
|
### Case 2: Out-of-domain request — world history design
|
|
**Input**: "Design the history of the world — when the first kingdom was founded, what the great wars were, and why magic was banned."
|
|
**Expected behavior**:
|
|
- Does not produce world history, lore architecture, or world rules
|
|
- States clearly: "World history, lore, and world rules are owned by world-builder; once the history is established, I can write in-game texts, books, and dialogue that reference those events"
|
|
- Does not produce even partial world history as a "placeholder"
|
|
|
|
### Case 3: Dialogue contradicts established lore — flag to narrative-director
|
|
**Input**: "Write Mira's dialogue line where she mentions that dragons have been extinct for 200 years." [Context includes existing lore: dragons are alive and revered in the northern provinces, not extinct.]
|
|
**Expected behavior**:
|
|
- Identifies the contradiction: established lore states dragons are alive and revered; dialogue stating they're extinct directly conflicts
|
|
- Does NOT write the requested line as given
|
|
- Flags the inconsistency to narrative-director: "Mira's dialogue as requested contradicts established lore (dragons are alive per world-builder's document); requires narrative-director resolution before I can write this line"
|
|
- Offers the user a lore-consistent alternative line (e.g., Mira expresses awe about a dragon sighting in the north) to use while the conflict is resolved
|
|
|
|
### Case 4: Item description references an undesigned mechanic
|
|
**Input**: "Write a description for the 'Berserker's Chalice' — a consumable that triggers the Berserker state when drunk."
|
|
**Expected behavior**:
|
|
- Identifies the dependency gap: "Berserker state" is not defined in any provided game design document
|
|
- Flags the missing dependency: "This description references a 'Berserker state' mechanic that has no GDD entry — I cannot write accurate flavor text for a mechanic whose rules are undefined, as the description may create incorrect player expectations"
|
|
- Does NOT write a description that invents mechanic details (duration, effects) that may conflict with the eventual design
|
|
- Raises the missing definition with game-designer (its coordinator for mechanical clarity in text) and asks the user how to proceed: (a) a vague, non-mechanical description that creates no false expectations, flagged as temporary; or (b) wait for game-designer to define the Berserker state first
|
|
|
|
### Case 5: Context pass — character voice guide
|
|
**Input context**: Character voice guide for Mira: She speaks in short, energetic sentences. Uses merchant slang ("a fine bargain," "coin well spent"). Drops pronouns occasionally ("Good wares, these."). Never uses contractions — always "I will" not "I'll". Warm but slightly mercenary.
|
|
**Input**: "Write Mira's response when a player asks if she has healing potions."
|
|
**Expected behavior**:
|
|
- Short, energetic sentences — no long monologues
|
|
- Uses merchant slang: "a fine bargain," "coin well spent," or similar
|
|
- Drops pronouns where natural: "Fine stock, these potions."
|
|
- No contractions: "I will" not "I'll," "do not" not "don't"
|
|
- Warm tone with a mercenary undertone: she's happy to help because you're a paying customer
|
|
- Does NOT produce dialogue that violates any voice guide rule — check each rule explicitly
|
|
|
|
---
|
|
|
|
## Protocol Compliance
|
|
|
|
- [ ] Stays within declared domain (dialogue, lore entries, item descriptions, in-game text)
|
|
- [ ] Redirects world history and world rule requests to world-builder without producing unauthorized lore
|
|
- [ ] Flags lore contradictions to narrative-director rather than silently writing inconsistent content
|
|
- [ ] Identifies mechanic dependency gaps before writing item descriptions that could create false player expectations
|
|
- [ ] Applies all rules from a provided character voice guide — no partial compliance
|
|
- [ ] For a multi-section document (e.g., a set of lore entries), asks "May I create [filepath] with the section skeleton?" before creating the file, writes each section once it is approved, and updates `production/session-state/active.md` after each section
|
|
|
|
---
|
|
|
|
## Coverage Notes
|
|
- Case 3 (lore contradiction detection) requires that existing lore is in the conversation context — test is only valid when context is provided
|
|
- Case 4 (dependency gap) tests whether the agent writes descriptions that could set wrong player expectations — a subtle but important quality issue
|
|
- Case 5 is the most important context-awareness test; voice guide compliance must be checked rule-by-rule, not holistically
|
|
- No automated runner; review manually or via `/skill-test`
|