* Added 1.0 files * Converted agents, and templates to new format. Updated filenames to include extensions like in unity-2d-game-team.yaml, Updated some wordage in workflow, config, and increased minor version number * Forgot to remove unused startup section in game-sm since it's moved to activation-instructions, now fixed. * Updated verbosity for development workflow in development-guidenlines.md * built the web-dist files for the expansion pack * Synched with main repo and rebuilt dist * Added enforcement of game-design-checklist to designer persona * Updated with new changes to phaser epack that seem relevant to discussion we had on discord for summarizing documentation updates * updated dist build for our epack
5.6 KiB
Create Game Development Story Task
Purpose
Create detailed, actionable game development stories that enable AI developers to implement specific game features in Unity without requiring additional design decisions.
When to Use
- Breaking down game epics into implementable stories
- Converting GDD features into development tasks
- Preparing work for game developers
- Ensuring clear handoffs from design to development
Prerequisites
Before creating stories, ensure you have:
- Completed Game Design Document (GDD)
- Game Architecture Document
- Epic definition this story belongs to
- Clear understanding of the specific game feature
Process
1. Story Identification
Review Epic Context:
- Understand the epic's overall goal
- Identify specific features that need implementation
- Review any existing stories in the epic
- Ensure no duplicate work
Feature Analysis:
- Reference specific GDD sections
- Understand player experience goals
- Identify technical complexity
- Estimate implementation scope
2. Story Scoping
Single Responsibility:
- Focus on one specific game feature
- Ensure story is completable in 1-3 days
- Break down complex features into multiple stories
- Maintain clear boundaries with other stories
Implementation Clarity:
- Define exactly what needs to be built
- Specify all technical requirements
- Include all necessary integration points
- Provide clear success criteria
3. Template Execution
Load Template:
Use templates#game-story-tmpl following all embedded LLM instructions
Key Focus Areas:
- Clear, actionable description
- Specific acceptance criteria
- Detailed technical specifications
- Complete implementation task list
- Comprehensive testing requirements
4. Story Validation
Technical Review:
- Verify all technical specifications are complete
- Ensure integration points are clearly defined
- Confirm file paths match architecture
- Validate C# interfaces and classes
- Check for proper use of prefabs and scenes
Game Design Alignment:
- Confirm story implements GDD requirements
- Verify player experience goals are met
- Check balance parameters are included
- Ensure game mechanics are correctly interpreted
Implementation Readiness:
- All dependencies identified
- Assets requirements specified
- Testing criteria defined
- Definition of Done complete
5. Quality Assurance
Apply Checklist:
Execute checklists#game-story-dod-checklist against completed story
Story Criteria:
- Story is immediately actionable
- No design decisions left to developer
- Technical requirements are complete
- Testing requirements are comprehensive
- Performance requirements are specified
6. Story Refinement
Developer Perspective:
- Can a developer start implementation immediately?
- Are all technical questions answered?
- Is the scope appropriate for the estimated points?
- Are all dependencies clearly identified?
Iterative Improvement:
- Address any gaps or ambiguities
- Clarify complex technical requirements
- Ensure story fits within epic scope
- Verify story points estimation
Story Elements Checklist
Required Sections
- Clear, specific description
- Complete acceptance criteria (functional, technical, game design)
- Detailed technical specifications
- File creation/modification list
- C# interfaces and classes
- Integration point specifications
- Ordered implementation tasks
- Comprehensive testing requirements
- Performance criteria
- Dependencies clearly identified
- Definition of Done checklist
Game-Specific Requirements
- GDD section references
- Game mechanic implementation details
- Player experience goals
- Balance parameters
- Unity-specific requirements (components, prefabs, scenes)
- Performance targets (stable frame rate)
- Cross-platform considerations
Technical Quality
- C# best practices compliance
- Architecture document alignment
- Code organization follows standards
- Error handling requirements
- Memory management considerations
- Testing strategy defined
Common Pitfalls
Scope Issues:
- Story too large (break into multiple stories)
- Story too vague (add specific requirements)
- Missing dependencies (identify all prerequisites)
- Unclear boundaries (define what's in/out of scope)
Technical Issues:
- Missing integration details
- Incomplete technical specifications
- Undefined interfaces or classes
- Missing performance requirements
Game Design Issues:
- Not referencing GDD properly
- Missing player experience context
- Unclear game mechanic implementation
- Missing balance parameters
Success Criteria
Story Readiness:
- Developer can start implementation immediately
- No additional design decisions required
- All technical questions answered
- Testing strategy is complete
- Performance requirements are clear
- Story fits within epic scope
Quality Validation:
- Game story DOD checklist passes
- Architecture alignment confirmed
- GDD requirements covered
- Implementation tasks are ordered and specific
- Dependencies are complete and accurate
Handoff Protocol
To Game Developer:
- Provide story document
- Confirm GDD and architecture access
- Verify all dependencies are met
- Answer any clarification questions
- Establish check-in schedule
Story Status Updates:
- Draft → Ready for Development
- In Development → Code Review
- Code Review → Testing
- Testing → Done
This task ensures game development stories are immediately actionable and enable efficient AI-driven development of game features in Unity.