bmad-method 4.37.0 → 4.39.1
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.
- package/.github/ISSUE_TEMPLATE/bug_report.md +3 -3
- package/.github/ISSUE_TEMPLATE/feature_request.md +3 -3
- package/.github/workflows/discord.yaml +11 -2
- package/.github/workflows/format-check.yaml +42 -0
- package/.github/workflows/manual-release.yaml +173 -0
- package/.husky/pre-commit +3 -0
- package/.vscode/settings.json +26 -1
- package/CHANGELOG.md +2 -23
- package/README.md +2 -0
- package/bmad-core/agent-teams/team-all.yaml +1 -1
- package/bmad-core/agents/analyst.md +16 -15
- package/bmad-core/agents/architect.md +11 -11
- package/bmad-core/agents/bmad-master.md +23 -22
- package/bmad-core/agents/bmad-orchestrator.md +13 -17
- package/bmad-core/agents/dev.md +14 -11
- package/bmad-core/agents/pm.md +15 -14
- package/bmad-core/agents/po.md +9 -8
- package/bmad-core/agents/qa.md +42 -22
- package/bmad-core/agents/sm.md +7 -6
- package/bmad-core/agents/ux-expert.md +6 -5
- package/bmad-core/core-config.yaml +2 -0
- package/bmad-core/data/bmad-kb.md +1 -1
- package/bmad-core/data/test-levels-framework.md +146 -0
- package/bmad-core/data/test-priorities-matrix.md +172 -0
- package/bmad-core/tasks/apply-qa-fixes.md +148 -0
- package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
- package/bmad-core/tasks/nfr-assess.md +343 -0
- package/bmad-core/tasks/qa-gate.md +161 -0
- package/bmad-core/tasks/review-story.md +234 -74
- package/bmad-core/tasks/risk-profile.md +353 -0
- package/bmad-core/tasks/test-design.md +174 -0
- package/bmad-core/tasks/trace-requirements.md +264 -0
- package/bmad-core/templates/architecture-tmpl.yaml +49 -49
- package/bmad-core/templates/brainstorming-output-tmpl.yaml +5 -5
- package/bmad-core/templates/brownfield-architecture-tmpl.yaml +31 -31
- package/bmad-core/templates/brownfield-prd-tmpl.yaml +13 -13
- package/bmad-core/templates/competitor-analysis-tmpl.yaml +19 -6
- package/bmad-core/templates/front-end-architecture-tmpl.yaml +21 -9
- package/bmad-core/templates/front-end-spec-tmpl.yaml +24 -24
- package/bmad-core/templates/fullstack-architecture-tmpl.yaml +122 -104
- package/bmad-core/templates/market-research-tmpl.yaml +2 -2
- package/bmad-core/templates/prd-tmpl.yaml +9 -9
- package/bmad-core/templates/project-brief-tmpl.yaml +4 -4
- package/bmad-core/templates/qa-gate-tmpl.yaml +102 -0
- package/bmad-core/templates/story-tmpl.yaml +12 -12
- package/bmad-core/workflows/brownfield-fullstack.yaml +9 -9
- package/bmad-core/workflows/brownfield-service.yaml +1 -1
- package/bmad-core/workflows/brownfield-ui.yaml +1 -1
- package/bmad-core/workflows/greenfield-fullstack.yaml +1 -1
- package/bmad-core/workflows/greenfield-service.yaml +1 -1
- package/bmad-core/workflows/greenfield-ui.yaml +1 -1
- package/common/utils/bmad-doc-template.md +5 -5
- package/dist/agents/analyst.txt +1086 -1079
- package/dist/agents/architect.txt +1534 -1526
- package/dist/agents/bmad-master.txt +646 -632
- package/dist/agents/bmad-orchestrator.txt +40 -18
- package/dist/agents/dev.txt +158 -19
- package/dist/agents/pm.txt +1082 -1107
- package/dist/agents/po.txt +314 -332
- package/dist/agents/qa.txt +1754 -151
- package/dist/agents/sm.txt +88 -98
- package/dist/agents/ux-expert.txt +80 -87
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +109 -146
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +75 -86
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +41 -48
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +1903 -1941
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +15 -50
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +149 -195
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +0 -15
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +20 -37
- package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +2660 -2752
- package/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt +871 -0
- package/dist/expansion-packs/bmad-creative-writing/agents/book-critic.txt +78 -0
- package/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt +839 -0
- package/dist/expansion-packs/bmad-creative-writing/agents/cover-designer.txt +85 -0
- package/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt +861 -0
- package/dist/expansion-packs/bmad-creative-writing/agents/editor.txt +796 -0
- package/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt +927 -0
- package/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt +842 -0
- package/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt +1126 -0
- package/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt +864 -0
- package/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt +5917 -0
- package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +25 -27
- package/dist/teams/team-all.txt +5541 -3768
- package/dist/teams/team-fullstack.txt +3014 -2987
- package/dist/teams/team-ide-minimal.txt +2219 -469
- package/dist/teams/team-no-ui.txt +2993 -2966
- package/docs/enhanced-ide-development-workflow.md +220 -15
- package/docs/user-guide.md +271 -18
- package/docs/versioning-and-releases.md +122 -44
- package/docs/working-in-the-brownfield.md +264 -31
- package/eslint.config.mjs +119 -0
- package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +4 -4
- package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +1 -1
- package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
- package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +26 -28
- package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +50 -50
- package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +23 -23
- package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +24 -24
- package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +42 -42
- package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +65 -65
- package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml +5 -5
- package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml +1 -1
- package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +3 -3
- package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +1 -1
- package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +1 -1
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +23 -23
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +63 -63
- package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +20 -20
- package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +65 -65
- package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +5 -5
- package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +1 -1
- package/expansion-packs/bmad-creative-writing/README.md +132 -0
- package/expansion-packs/bmad-creative-writing/agent-teams/agent-team.yaml +19 -0
- package/expansion-packs/bmad-creative-writing/agents/beta-reader.md +91 -0
- package/expansion-packs/bmad-creative-writing/agents/book-critic.md +35 -0
- package/expansion-packs/bmad-creative-writing/agents/character-psychologist.md +90 -0
- package/expansion-packs/bmad-creative-writing/agents/cover-designer.md +41 -0
- package/expansion-packs/bmad-creative-writing/agents/dialog-specialist.md +89 -0
- package/expansion-packs/bmad-creative-writing/agents/editor.md +90 -0
- package/expansion-packs/bmad-creative-writing/agents/genre-specialist.md +92 -0
- package/expansion-packs/bmad-creative-writing/agents/narrative-designer.md +90 -0
- package/expansion-packs/bmad-creative-writing/agents/plot-architect.md +92 -0
- package/expansion-packs/bmad-creative-writing/agents/world-builder.md +91 -0
- package/expansion-packs/bmad-creative-writing/checklists/beta-feedback-closure-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/character-consistency-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/comedic-timing-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/ebook-formatting-checklist.md +15 -0
- package/expansion-packs/bmad-creative-writing/checklists/epic-poetry-meter-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/fantasy-magic-system-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/foreshadowing-payoff-checklist.md +15 -0
- package/expansion-packs/bmad-creative-writing/checklists/genre-tropes-checklist.md +15 -0
- package/expansion-packs/bmad-creative-writing/checklists/historical-accuracy-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/horror-suspense-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/kdp-cover-ready-checklist.md +18 -0
- package/expansion-packs/bmad-creative-writing/checklists/line-edit-quality-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/marketing-copy-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/mystery-clue-trail-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/orbital-mechanics-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/plot-structure-checklist.md +49 -0
- package/expansion-packs/bmad-creative-writing/checklists/publication-readiness-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/romance-emotional-beats-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/scene-quality-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md +15 -0
- package/expansion-packs/bmad-creative-writing/checklists/sensitivity-representation-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/steampunk-gadget-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/thriller-pacing-stakes-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/timeline-continuity-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/world-building-continuity-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/checklists/ya-appropriateness-checklist.md +16 -0
- package/expansion-packs/bmad-creative-writing/config.yaml +11 -0
- package/expansion-packs/bmad-creative-writing/data/bmad-kb.md +197 -0
- package/expansion-packs/bmad-creative-writing/data/story-structures.md +58 -0
- package/expansion-packs/bmad-creative-writing/docs/brief.md +183 -0
- package/expansion-packs/bmad-creative-writing/tasks/advanced-elicitation.md +117 -0
- package/expansion-packs/bmad-creative-writing/tasks/analyze-reader-feedback.md +16 -0
- package/expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md +55 -0
- package/expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md +22 -0
- package/expansion-packs/bmad-creative-writing/tasks/brainstorm-premise.md +16 -0
- package/expansion-packs/bmad-creative-writing/tasks/build-world.md +17 -0
- package/expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md +15 -0
- package/expansion-packs/bmad-creative-writing/tasks/create-doc.md +101 -0
- package/expansion-packs/bmad-creative-writing/tasks/create-draft-section.md +19 -0
- package/expansion-packs/bmad-creative-writing/tasks/critical-review.md +19 -0
- package/expansion-packs/bmad-creative-writing/tasks/develop-character.md +17 -0
- package/expansion-packs/bmad-creative-writing/tasks/execute-checklist.md +93 -0
- package/expansion-packs/bmad-creative-writing/tasks/expand-premise.md +16 -0
- package/expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md +16 -0
- package/expansion-packs/bmad-creative-writing/tasks/final-polish.md +16 -0
- package/expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md +18 -0
- package/expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md +19 -0
- package/expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md +16 -0
- package/expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md +18 -0
- package/expansion-packs/bmad-creative-writing/tasks/outline-scenes.md +16 -0
- package/expansion-packs/bmad-creative-writing/tasks/provide-feedback.md +17 -0
- package/expansion-packs/bmad-creative-writing/tasks/publish-chapter.md +16 -0
- package/expansion-packs/bmad-creative-writing/tasks/quick-feedback.md +15 -0
- package/expansion-packs/bmad-creative-writing/tasks/select-next-arc.md +16 -0
- package/expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md +51 -0
- package/expansion-packs/bmad-creative-writing/templates/beta-feedback-form.yaml +96 -0
- package/expansion-packs/bmad-creative-writing/templates/chapter-draft-tmpl.yaml +81 -0
- package/expansion-packs/bmad-creative-writing/templates/character-profile-tmpl.yaml +92 -0
- package/expansion-packs/bmad-creative-writing/templates/cover-design-brief-tmpl.yaml +97 -0
- package/expansion-packs/bmad-creative-writing/templates/premise-brief-tmpl.yaml +77 -0
- package/expansion-packs/bmad-creative-writing/templates/scene-list-tmpl.yaml +54 -0
- package/expansion-packs/bmad-creative-writing/templates/story-outline-tmpl.yaml +96 -0
- package/expansion-packs/bmad-creative-writing/templates/world-guide-tmpl.yaml +88 -0
- package/expansion-packs/bmad-creative-writing/workflows/book-cover-design-workflow.md +176 -0
- package/expansion-packs/bmad-creative-writing/workflows/novel-greenfield-workflow.yaml +58 -0
- package/expansion-packs/bmad-creative-writing/workflows/novel-serial-workflow.yaml +51 -0
- package/expansion-packs/bmad-creative-writing/workflows/novel-snowflake-workflow.yaml +69 -0
- package/expansion-packs/bmad-creative-writing/workflows/novel-writing.yaml +92 -0
- package/expansion-packs/bmad-creative-writing/workflows/screenplay-development.yaml +86 -0
- package/expansion-packs/bmad-creative-writing/workflows/series-planning.yaml +79 -0
- package/expansion-packs/bmad-creative-writing/workflows/short-story-creation.yaml +65 -0
- package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
- package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +20 -20
- package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +7 -7
- package/package.json +62 -39
- package/prettier.config.mjs +32 -0
- package/sync-version.sh +23 -0
- package/tools/bmad-npx-wrapper.js +10 -10
- package/tools/builders/web-builder.js +124 -130
- package/tools/bump-all-versions.js +42 -33
- package/tools/bump-expansion-version.js +23 -16
- package/tools/cli.js +10 -12
- package/tools/flattener/aggregate.js +10 -10
- package/tools/flattener/binary.js +44 -17
- package/tools/flattener/discovery.js +19 -18
- package/tools/flattener/files.js +6 -6
- package/tools/flattener/ignoreRules.js +125 -125
- package/tools/flattener/main.js +426 -70
- package/tools/flattener/projectRoot.js +186 -25
- package/tools/flattener/prompts.js +9 -9
- package/tools/flattener/stats.helpers.js +395 -0
- package/tools/flattener/stats.js +64 -14
- package/tools/flattener/test-matrix.js +413 -0
- package/tools/flattener/xml.js +33 -31
- package/tools/installer/bin/bmad.js +156 -113
- package/tools/installer/config/ide-agent-config.yaml +1 -1
- package/tools/installer/config/install.config.yaml +13 -3
- package/tools/installer/lib/config-loader.js +46 -42
- package/tools/installer/lib/file-manager.js +91 -113
- package/tools/installer/lib/ide-base-setup.js +57 -56
- package/tools/installer/lib/ide-setup.js +545 -399
- package/tools/installer/lib/installer.js +875 -714
- package/tools/installer/lib/memory-profiler.js +54 -53
- package/tools/installer/lib/module-manager.js +19 -15
- package/tools/installer/lib/resource-locator.js +26 -28
- package/tools/installer/package.json +19 -19
- package/tools/lib/dependency-resolver.js +26 -30
- package/tools/lib/yaml-utils.js +7 -7
- package/tools/preview-release-notes.js +66 -0
- package/tools/shared/bannerArt.js +3 -3
- package/tools/sync-installer-version.js +7 -9
- package/tools/update-expansion-version.js +14 -15
- package/tools/upgraders/v3-to-v4-upgrader.js +203 -294
- package/tools/version-bump.js +41 -26
- package/tools/yaml-format.js +56 -43
- package/.github/workflows/release.yaml +0 -60
- package/.releaserc.json +0 -21
- package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/Complete AI Agent System - Flowchart.svg +0 -102
- package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.1 Google Cloud Project Setup/1.1.1 - Initial Project Configuration - bash copy.txt +0 -13
- package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.1 Google Cloud Project Setup/1.1.1 - Initial Project Configuration - bash.txt +0 -13
- package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.2 Agent Development Kit Installation/1.2.2 - Basic Project Structure - txt.txt +0 -25
- package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.3 Core Configuration Files/1.3.1 - settings.py +0 -34
- package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.3 Core Configuration Files/1.3.2 - main.py - Base Application.py +0 -70
- package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.4 Deployment Configuration/1.4.2 - cloudbuild.yaml +0 -26
- package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md +0 -109
- package/tools/semantic-release-sync-installer.js +0 -30
|
@@ -210,7 +210,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
|
|
|
210
210
|
## Instructions
|
|
211
211
|
|
|
212
212
|
1. **Initial Assessment**
|
|
213
|
-
|
|
214
213
|
- If user or the task being run provides a checklist name:
|
|
215
214
|
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
|
|
216
215
|
- If multiple matches found, ask user to clarify
|
|
@@ -223,14 +222,12 @@ If the user asks or does not specify a specific checklist, list the checklists a
|
|
|
223
222
|
- All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
|
|
224
223
|
|
|
225
224
|
2. **Document and Artifact Gathering**
|
|
226
|
-
|
|
227
225
|
- Each checklist will specify its required documents/artifacts at the beginning
|
|
228
226
|
- Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
|
|
229
227
|
|
|
230
228
|
3. **Checklist Processing**
|
|
231
229
|
|
|
232
230
|
If in interactive mode:
|
|
233
|
-
|
|
234
231
|
- Work through each section of the checklist one at a time
|
|
235
232
|
- For each section:
|
|
236
233
|
- Review all items in the section following instructions for that section embedded in the checklist
|
|
@@ -239,7 +236,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
|
|
|
239
236
|
- Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
|
|
240
237
|
|
|
241
238
|
If in YOLO mode:
|
|
242
|
-
|
|
243
239
|
- Process all sections at once
|
|
244
240
|
- Create a comprehensive report of all findings
|
|
245
241
|
- Present the complete analysis to the user
|
|
@@ -247,7 +243,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
|
|
|
247
243
|
4. **Validation Approach**
|
|
248
244
|
|
|
249
245
|
For each checklist item:
|
|
250
|
-
|
|
251
246
|
- Read and understand the requirement
|
|
252
247
|
- Look for evidence in the documentation that satisfies the requirement
|
|
253
248
|
- Consider both explicit mentions and implicit coverage
|
|
@@ -261,7 +256,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
|
|
|
261
256
|
5. **Section Analysis**
|
|
262
257
|
|
|
263
258
|
For each section:
|
|
264
|
-
|
|
265
259
|
- think step by step to calculate pass rate
|
|
266
260
|
- Identify common themes in failed items
|
|
267
261
|
- Provide specific recommendations for improvement
|
|
@@ -271,7 +265,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
|
|
|
271
265
|
6. **Final Report**
|
|
272
266
|
|
|
273
267
|
Prepare a summary that includes:
|
|
274
|
-
|
|
275
268
|
- Overall checklist completion status
|
|
276
269
|
- Pass rates by section
|
|
277
270
|
- List of failed items with context
|
|
@@ -306,7 +299,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
306
299
|
[[LLM: Begin by understanding the game design context and goals. Ask clarifying questions if needed to determine the best approach for game-specific ideation.]]
|
|
307
300
|
|
|
308
301
|
1. **Establish Game Context**
|
|
309
|
-
|
|
310
302
|
- Understand the game genre or opportunity area
|
|
311
303
|
- Identify target audience and platform constraints
|
|
312
304
|
- Determine session goals (concept exploration vs. mechanic refinement)
|
|
@@ -324,7 +316,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
324
316
|
|
|
325
317
|
1. **"What If" Game Scenarios**
|
|
326
318
|
[[LLM: Generate provocative what-if questions that challenge game design assumptions and expand thinking beyond current genre limitations.]]
|
|
327
|
-
|
|
328
319
|
- What if players could rewind time in any genre?
|
|
329
320
|
- What if the game world reacted to the player's real-world location?
|
|
330
321
|
- What if failure was more rewarding than success?
|
|
@@ -333,7 +324,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
333
324
|
|
|
334
325
|
2. **Cross-Genre Fusion**
|
|
335
326
|
[[LLM: Help user combine unexpected game genres and mechanics to create unique experiences.]]
|
|
336
|
-
|
|
337
327
|
- "How might [genre A] mechanics work in [genre B]?"
|
|
338
328
|
- Puzzle mechanics in action games
|
|
339
329
|
- Dating sim elements in strategy games
|
|
@@ -342,7 +332,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
342
332
|
|
|
343
333
|
3. **Player Motivation Reversal**
|
|
344
334
|
[[LLM: Flip traditional player motivations to reveal new gameplay possibilities.]]
|
|
345
|
-
|
|
346
335
|
- What if losing was the goal?
|
|
347
336
|
- What if cooperation was forced in competitive games?
|
|
348
337
|
- What if players had to help their enemies?
|
|
@@ -359,7 +348,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
359
348
|
|
|
360
349
|
1. **SCAMPER for Game Mechanics**
|
|
361
350
|
[[LLM: Guide through each SCAMPER prompt specifically for game design.]]
|
|
362
|
-
|
|
363
351
|
- **S** = Substitute: What mechanics can be substituted? (walking → flying → swimming)
|
|
364
352
|
- **C** = Combine: What systems can be merged? (inventory + character growth)
|
|
365
353
|
- **A** = Adapt: What mechanics from other media? (books, movies, sports)
|
|
@@ -370,7 +358,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
370
358
|
|
|
371
359
|
2. **Player Agency Spectrum**
|
|
372
360
|
[[LLM: Explore different levels of player control and agency across game systems.]]
|
|
373
|
-
|
|
374
361
|
- Full Control: Direct character movement, combat, building
|
|
375
362
|
- Indirect Control: Setting rules, giving commands, environmental changes
|
|
376
363
|
- Influence Only: Suggestions, preferences, emotional reactions
|
|
@@ -378,7 +365,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
378
365
|
|
|
379
366
|
3. **Temporal Game Design**
|
|
380
367
|
[[LLM: Explore how time affects gameplay and player experience.]]
|
|
381
|
-
|
|
382
368
|
- Real-time vs. turn-based mechanics
|
|
383
369
|
- Time travel and manipulation
|
|
384
370
|
- Persistent vs. session-based progress
|
|
@@ -389,7 +375,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
389
375
|
|
|
390
376
|
1. **Emotion-First Design**
|
|
391
377
|
[[LLM: Start with target emotions and work backward to mechanics that create them.]]
|
|
392
|
-
|
|
393
378
|
- Target Emotion: Wonder → Mechanics: Discovery, mystery, scale
|
|
394
379
|
- Target Emotion: Triumph → Mechanics: Challenge, skill growth, recognition
|
|
395
380
|
- Target Emotion: Connection → Mechanics: Cooperation, shared goals, communication
|
|
@@ -397,7 +382,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
397
382
|
|
|
398
383
|
2. **Player Archetype Brainstorming**
|
|
399
384
|
[[LLM: Design for different player types and motivations.]]
|
|
400
|
-
|
|
401
385
|
- Achievers: Progression, completion, mastery
|
|
402
386
|
- Explorers: Discovery, secrets, world-building
|
|
403
387
|
- Socializers: Interaction, cooperation, community
|
|
@@ -406,7 +390,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
406
390
|
|
|
407
391
|
3. **Accessibility-First Innovation**
|
|
408
392
|
[[LLM: Generate ideas that make games more accessible while creating new gameplay.]]
|
|
409
|
-
|
|
410
393
|
- Visual impairment considerations leading to audio-focused mechanics
|
|
411
394
|
- Motor accessibility inspiring one-handed or simplified controls
|
|
412
395
|
- Cognitive accessibility driving clear feedback and pacing
|
|
@@ -416,7 +399,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
416
399
|
|
|
417
400
|
1. **Environmental Storytelling**
|
|
418
401
|
[[LLM: Brainstorm ways the game world itself tells stories without explicit narrative.]]
|
|
419
|
-
|
|
420
402
|
- How does the environment show history?
|
|
421
403
|
- What do interactive objects reveal about characters?
|
|
422
404
|
- How can level design communicate mood?
|
|
@@ -424,7 +406,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
424
406
|
|
|
425
407
|
2. **Player-Generated Narrative**
|
|
426
408
|
[[LLM: Explore ways players create their own stories through gameplay.]]
|
|
427
|
-
|
|
428
409
|
- Emergent storytelling through player choices
|
|
429
410
|
- Procedural narrative generation
|
|
430
411
|
- Player-to-player story sharing
|
|
@@ -432,7 +413,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
432
413
|
|
|
433
414
|
3. **Genre Expectation Subversion**
|
|
434
415
|
[[LLM: Identify and deliberately subvert player expectations within genres.]]
|
|
435
|
-
|
|
436
416
|
- Fantasy RPG where magic is mundane
|
|
437
417
|
- Horror game where monsters are friendly
|
|
438
418
|
- Racing game where going slow is optimal
|
|
@@ -442,7 +422,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
442
422
|
|
|
443
423
|
1. **Platform-Specific Design**
|
|
444
424
|
[[LLM: Generate ideas that leverage unique platform capabilities.]]
|
|
445
|
-
|
|
446
425
|
- Mobile: GPS, accelerometer, camera, always-connected
|
|
447
426
|
- Web: URLs, tabs, social sharing, real-time collaboration
|
|
448
427
|
- Console: Controllers, TV viewing, couch co-op
|
|
@@ -450,7 +429,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
450
429
|
|
|
451
430
|
2. **Constraint-Based Creativity**
|
|
452
431
|
[[LLM: Use technical or design constraints as creative catalysts.]]
|
|
453
|
-
|
|
454
432
|
- One-button games
|
|
455
433
|
- Games without graphics
|
|
456
434
|
- Games that play in notification bars
|
|
@@ -496,19 +474,16 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
|
|
|
496
474
|
[[LLM: Guide the brainstorming session with appropriate pacing for game design exploration.]]
|
|
497
475
|
|
|
498
476
|
1. **Inspiration Phase** (10-15 min)
|
|
499
|
-
|
|
500
477
|
- Reference existing games and mechanics
|
|
501
478
|
- Explore player experiences and emotions
|
|
502
479
|
- Gather visual and thematic inspiration
|
|
503
480
|
|
|
504
481
|
2. **Divergent Exploration** (25-35 min)
|
|
505
|
-
|
|
506
482
|
- Generate many game concepts or mechanics
|
|
507
483
|
- Use expansion and fusion techniques
|
|
508
484
|
- Encourage wild and impossible ideas
|
|
509
485
|
|
|
510
486
|
3. **Player-Centered Filtering** (15-20 min)
|
|
511
|
-
|
|
512
487
|
- Consider target audience reactions
|
|
513
488
|
- Evaluate emotional impact and engagement
|
|
514
489
|
- Group ideas by player experience goals
|
|
@@ -629,63 +604,54 @@ CRITICAL: First, help the user select the most appropriate research focus based
|
|
|
629
604
|
Present these numbered options to the user:
|
|
630
605
|
|
|
631
606
|
1. **Product Validation Research**
|
|
632
|
-
|
|
633
607
|
- Validate product hypotheses and market fit
|
|
634
608
|
- Test assumptions about user needs and solutions
|
|
635
609
|
- Assess technical and business feasibility
|
|
636
610
|
- Identify risks and mitigation strategies
|
|
637
611
|
|
|
638
612
|
2. **Market Opportunity Research**
|
|
639
|
-
|
|
640
613
|
- Analyze market size and growth potential
|
|
641
614
|
- Identify market segments and dynamics
|
|
642
615
|
- Assess market entry strategies
|
|
643
616
|
- Evaluate timing and market readiness
|
|
644
617
|
|
|
645
618
|
3. **User & Customer Research**
|
|
646
|
-
|
|
647
619
|
- Deep dive into user personas and behaviors
|
|
648
620
|
- Understand jobs-to-be-done and pain points
|
|
649
621
|
- Map customer journeys and touchpoints
|
|
650
622
|
- Analyze willingness to pay and value perception
|
|
651
623
|
|
|
652
624
|
4. **Competitive Intelligence Research**
|
|
653
|
-
|
|
654
625
|
- Detailed competitor analysis and positioning
|
|
655
626
|
- Feature and capability comparisons
|
|
656
627
|
- Business model and strategy analysis
|
|
657
628
|
- Identify competitive advantages and gaps
|
|
658
629
|
|
|
659
630
|
5. **Technology & Innovation Research**
|
|
660
|
-
|
|
661
631
|
- Assess technology trends and possibilities
|
|
662
632
|
- Evaluate technical approaches and architectures
|
|
663
633
|
- Identify emerging technologies and disruptions
|
|
664
634
|
- Analyze build vs. buy vs. partner options
|
|
665
635
|
|
|
666
636
|
6. **Industry & Ecosystem Research**
|
|
667
|
-
|
|
668
637
|
- Map industry value chains and dynamics
|
|
669
638
|
- Identify key players and relationships
|
|
670
639
|
- Analyze regulatory and compliance factors
|
|
671
640
|
- Understand partnership opportunities
|
|
672
641
|
|
|
673
642
|
7. **Strategic Options Research**
|
|
674
|
-
|
|
675
643
|
- Evaluate different strategic directions
|
|
676
644
|
- Assess business model alternatives
|
|
677
645
|
- Analyze go-to-market strategies
|
|
678
646
|
- Consider expansion and scaling paths
|
|
679
647
|
|
|
680
648
|
8. **Risk & Feasibility Research**
|
|
681
|
-
|
|
682
649
|
- Identify and assess various risk factors
|
|
683
650
|
- Evaluate implementation challenges
|
|
684
651
|
- Analyze resource requirements
|
|
685
652
|
- Consider regulatory and legal implications
|
|
686
653
|
|
|
687
654
|
9. **Custom Research Focus**
|
|
688
|
-
|
|
689
655
|
- User-defined research objectives
|
|
690
656
|
- Specialized domain investigation
|
|
691
657
|
- Cross-functional research needs
|
|
@@ -854,13 +820,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
|
|
|
854
820
|
### 5. Review and Refinement
|
|
855
821
|
|
|
856
822
|
1. **Present Complete Prompt**
|
|
857
|
-
|
|
858
823
|
- Show the full research prompt
|
|
859
824
|
- Explain key elements and rationale
|
|
860
825
|
- Highlight any assumptions made
|
|
861
826
|
|
|
862
827
|
2. **Gather Feedback**
|
|
863
|
-
|
|
864
828
|
- Are the objectives clear and correct?
|
|
865
829
|
- Do the questions address all concerns?
|
|
866
830
|
- Is the scope appropriate?
|
|
@@ -918,7 +882,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
|
|
|
918
882
|
2. If the section contains game flow diagrams, level layouts, or system diagrams, explain each diagram briefly with game development context before offering elicitation options (e.g., "The gameplay loop diagram shows how player actions lead to rewards and progression. Notice how each step maintains player engagement and creates opportunities for skill development.")
|
|
919
883
|
|
|
920
884
|
3. If the section contains multiple game elements (like multiple mechanics, multiple levels, multiple systems, etc.), inform the user they can apply elicitation actions to:
|
|
921
|
-
|
|
922
885
|
- The entire section as a whole
|
|
923
886
|
- Individual game elements within the section (specify which element when selecting an action)
|
|
924
887
|
|
|
@@ -1028,7 +991,7 @@ sections:
|
|
|
1028
991
|
- id: initial-setup
|
|
1029
992
|
instruction: |
|
|
1030
993
|
This template creates a comprehensive Game Design Document that will serve as the foundation for all game development work. The GDD should be detailed enough that developers can create user stories and epics from it. Focus on gameplay systems, mechanics, and technical requirements that can be broken down into implementable features.
|
|
1031
|
-
|
|
994
|
+
|
|
1032
995
|
If available, review any provided documents or ask if any are optionally available: Project Brief, Market Research, Competitive Analysis
|
|
1033
996
|
|
|
1034
997
|
- id: executive-summary
|
|
@@ -1073,7 +1036,7 @@ sections:
|
|
|
1073
1036
|
instruction: Define the 30-60 second loop that players will repeat. Be specific about timing and player actions.
|
|
1074
1037
|
template: |
|
|
1075
1038
|
**Primary Loop ({{duration}} seconds):**
|
|
1076
|
-
|
|
1039
|
+
|
|
1077
1040
|
1. {{action_1}} ({{time_1}}s)
|
|
1078
1041
|
2. {{action_2}} ({{time_2}}s)
|
|
1079
1042
|
3. {{action_3}} ({{time_3}}s)
|
|
@@ -1083,12 +1046,12 @@ sections:
|
|
|
1083
1046
|
instruction: Clearly define success and failure states
|
|
1084
1047
|
template: |
|
|
1085
1048
|
**Victory Conditions:**
|
|
1086
|
-
|
|
1049
|
+
|
|
1087
1050
|
- {{win_condition_1}}
|
|
1088
1051
|
- {{win_condition_2}}
|
|
1089
|
-
|
|
1052
|
+
|
|
1090
1053
|
**Failure States:**
|
|
1091
|
-
|
|
1054
|
+
|
|
1092
1055
|
- {{loss_condition_1}}
|
|
1093
1056
|
- {{loss_condition_2}}
|
|
1094
1057
|
|
|
@@ -1104,17 +1067,17 @@ sections:
|
|
|
1104
1067
|
title: "{{mechanic_name}}"
|
|
1105
1068
|
template: |
|
|
1106
1069
|
**Description:** {{detailed_description}}
|
|
1107
|
-
|
|
1070
|
+
|
|
1108
1071
|
**Player Input:** {{input_method}}
|
|
1109
|
-
|
|
1072
|
+
|
|
1110
1073
|
**System Response:** {{game_response}}
|
|
1111
|
-
|
|
1074
|
+
|
|
1112
1075
|
**Implementation Notes:**
|
|
1113
|
-
|
|
1076
|
+
|
|
1114
1077
|
- {{tech_requirement_1}}
|
|
1115
1078
|
- {{tech_requirement_2}}
|
|
1116
1079
|
- {{performance_consideration}}
|
|
1117
|
-
|
|
1080
|
+
|
|
1118
1081
|
**Dependencies:** {{other_mechanics_needed}}
|
|
1119
1082
|
- id: controls
|
|
1120
1083
|
title: Controls
|
|
@@ -1133,9 +1096,9 @@ sections:
|
|
|
1133
1096
|
title: Player Progression
|
|
1134
1097
|
template: |
|
|
1135
1098
|
**Progression Type:** {{linear|branching|metroidvania}}
|
|
1136
|
-
|
|
1099
|
+
|
|
1137
1100
|
**Key Milestones:**
|
|
1138
|
-
|
|
1101
|
+
|
|
1139
1102
|
1. **{{milestone_1}}** - {{unlock_description}}
|
|
1140
1103
|
2. **{{milestone_2}}** - {{unlock_description}}
|
|
1141
1104
|
3. **{{milestone_3}}** - {{unlock_description}}
|
|
@@ -1172,9 +1135,9 @@ sections:
|
|
|
1172
1135
|
**Duration:** {{target_time}}
|
|
1173
1136
|
**Key Elements:** {{required_mechanics}}
|
|
1174
1137
|
**Difficulty:** {{relative_difficulty}}
|
|
1175
|
-
|
|
1138
|
+
|
|
1176
1139
|
**Structure Template:**
|
|
1177
|
-
|
|
1140
|
+
|
|
1178
1141
|
- Introduction: {{intro_description}}
|
|
1179
1142
|
- Challenge: {{main_challenge}}
|
|
1180
1143
|
- Resolution: {{completion_requirement}}
|
|
@@ -1200,13 +1163,13 @@ sections:
|
|
|
1200
1163
|
title: Platform Specific
|
|
1201
1164
|
template: |
|
|
1202
1165
|
**Desktop:**
|
|
1203
|
-
|
|
1166
|
+
|
|
1204
1167
|
- Resolution: {{min_resolution}} - {{max_resolution}}
|
|
1205
1168
|
- Input: Keyboard, Mouse, Gamepad
|
|
1206
1169
|
- Browser: Chrome 80+, Firefox 75+, Safari 13+
|
|
1207
|
-
|
|
1170
|
+
|
|
1208
1171
|
**Mobile:**
|
|
1209
|
-
|
|
1172
|
+
|
|
1210
1173
|
- Resolution: {{mobile_min}} - {{mobile_max}}
|
|
1211
1174
|
- Input: Touch, Tilt (optional)
|
|
1212
1175
|
- OS: iOS 13+, Android 8+
|
|
@@ -1215,14 +1178,14 @@ sections:
|
|
|
1215
1178
|
instruction: Define asset specifications for the art and audio teams
|
|
1216
1179
|
template: |
|
|
1217
1180
|
**Visual Assets:**
|
|
1218
|
-
|
|
1181
|
+
|
|
1219
1182
|
- Art Style: {{style_description}}
|
|
1220
1183
|
- Color Palette: {{color_specification}}
|
|
1221
1184
|
- Animation: {{animation_requirements}}
|
|
1222
1185
|
- UI Resolution: {{ui_specs}}
|
|
1223
|
-
|
|
1186
|
+
|
|
1224
1187
|
**Audio Assets:**
|
|
1225
|
-
|
|
1188
|
+
|
|
1226
1189
|
- Music Style: {{music_genre}}
|
|
1227
1190
|
- Sound Effects: {{sfx_requirements}}
|
|
1228
1191
|
- Voice Acting: {{voice_needs}}
|
|
@@ -1235,7 +1198,7 @@ sections:
|
|
|
1235
1198
|
title: Engine Configuration
|
|
1236
1199
|
template: |
|
|
1237
1200
|
**Phaser 3 Setup:**
|
|
1238
|
-
|
|
1201
|
+
|
|
1239
1202
|
- TypeScript: Strict mode enabled
|
|
1240
1203
|
- Physics: {{physics_system}} (Arcade/Matter)
|
|
1241
1204
|
- Renderer: WebGL with Canvas fallback
|
|
@@ -1244,7 +1207,7 @@ sections:
|
|
|
1244
1207
|
title: Code Architecture
|
|
1245
1208
|
template: |
|
|
1246
1209
|
**Required Systems:**
|
|
1247
|
-
|
|
1210
|
+
|
|
1248
1211
|
- Scene Management
|
|
1249
1212
|
- State Management
|
|
1250
1213
|
- Asset Loading
|
|
@@ -1256,7 +1219,7 @@ sections:
|
|
|
1256
1219
|
title: Data Management
|
|
1257
1220
|
template: |
|
|
1258
1221
|
**Save Data:**
|
|
1259
|
-
|
|
1222
|
+
|
|
1260
1223
|
- Progress tracking
|
|
1261
1224
|
- Settings persistence
|
|
1262
1225
|
- Statistics collection
|
|
@@ -1374,7 +1337,7 @@ sections:
|
|
|
1374
1337
|
- id: initial-setup
|
|
1375
1338
|
instruction: |
|
|
1376
1339
|
This template creates comprehensive level design documentation that guides both content creation and technical implementation. This document should provide enough detail for developers to create level loading systems and for designers to create specific levels.
|
|
1377
|
-
|
|
1340
|
+
|
|
1378
1341
|
If available, review: Game Design Document (GDD), Game Architecture Document. This document should align with the game mechanics and technical systems defined in those documents.
|
|
1379
1342
|
|
|
1380
1343
|
- id: introduction
|
|
@@ -1382,7 +1345,7 @@ sections:
|
|
|
1382
1345
|
instruction: Establish the purpose and scope of level design for this game
|
|
1383
1346
|
content: |
|
|
1384
1347
|
This document defines the level design framework for {{game_title}}, providing guidelines for creating engaging, balanced levels that support the core gameplay mechanics defined in the Game Design Document.
|
|
1385
|
-
|
|
1348
|
+
|
|
1386
1349
|
This framework ensures consistency across all levels while providing flexibility for creative level design within established technical and design constraints.
|
|
1387
1350
|
sections:
|
|
1388
1351
|
- id: change-log
|
|
@@ -1429,29 +1392,29 @@ sections:
|
|
|
1429
1392
|
title: "{{category_name}} Levels"
|
|
1430
1393
|
template: |
|
|
1431
1394
|
**Purpose:** {{gameplay_purpose}}
|
|
1432
|
-
|
|
1395
|
+
|
|
1433
1396
|
**Target Duration:** {{min_time}} - {{max_time}} minutes
|
|
1434
|
-
|
|
1397
|
+
|
|
1435
1398
|
**Difficulty Range:** {{difficulty_scale}}
|
|
1436
|
-
|
|
1399
|
+
|
|
1437
1400
|
**Key Mechanics Featured:**
|
|
1438
|
-
|
|
1401
|
+
|
|
1439
1402
|
- {{mechanic_1}} - {{usage_description}}
|
|
1440
1403
|
- {{mechanic_2}} - {{usage_description}}
|
|
1441
|
-
|
|
1404
|
+
|
|
1442
1405
|
**Player Objectives:**
|
|
1443
|
-
|
|
1406
|
+
|
|
1444
1407
|
- Primary: {{primary_objective}}
|
|
1445
1408
|
- Secondary: {{secondary_objective}}
|
|
1446
1409
|
- Hidden: {{secret_objective}}
|
|
1447
|
-
|
|
1410
|
+
|
|
1448
1411
|
**Success Criteria:**
|
|
1449
|
-
|
|
1412
|
+
|
|
1450
1413
|
- {{completion_requirement_1}}
|
|
1451
1414
|
- {{completion_requirement_2}}
|
|
1452
|
-
|
|
1415
|
+
|
|
1453
1416
|
**Technical Requirements:**
|
|
1454
|
-
|
|
1417
|
+
|
|
1455
1418
|
- Maximum entities: {{entity_limit}}
|
|
1456
1419
|
- Performance target: {{fps_target}} FPS
|
|
1457
1420
|
- Memory budget: {{memory_limit}}MB
|
|
@@ -1466,11 +1429,11 @@ sections:
|
|
|
1466
1429
|
instruction: Based on GDD requirements, define the overall level organization
|
|
1467
1430
|
template: |
|
|
1468
1431
|
**Organization Type:** {{linear|hub_world|open_world}}
|
|
1469
|
-
|
|
1432
|
+
|
|
1470
1433
|
**Total Level Count:** {{number}}
|
|
1471
|
-
|
|
1434
|
+
|
|
1472
1435
|
**World Breakdown:**
|
|
1473
|
-
|
|
1436
|
+
|
|
1474
1437
|
- World 1: {{level_count}} levels - {{theme}} - {{difficulty_range}}
|
|
1475
1438
|
- World 2: {{level_count}} levels - {{theme}} - {{difficulty_range}}
|
|
1476
1439
|
- World 3: {{level_count}} levels - {{theme}} - {{difficulty_range}}
|
|
@@ -1505,7 +1468,7 @@ sections:
|
|
|
1505
1468
|
instruction: Define how players access new levels
|
|
1506
1469
|
template: |
|
|
1507
1470
|
**Progression Gates:**
|
|
1508
|
-
|
|
1471
|
+
|
|
1509
1472
|
- Linear progression: Complete previous level
|
|
1510
1473
|
- Star requirements: {{star_count}} stars to unlock
|
|
1511
1474
|
- Skill gates: Demonstrate {{skill_requirement}}
|
|
@@ -1520,17 +1483,17 @@ sections:
|
|
|
1520
1483
|
instruction: Define all environmental components that can be used in levels
|
|
1521
1484
|
template: |
|
|
1522
1485
|
**Terrain Types:**
|
|
1523
|
-
|
|
1486
|
+
|
|
1524
1487
|
- {{terrain_1}}: {{properties_and_usage}}
|
|
1525
1488
|
- {{terrain_2}}: {{properties_and_usage}}
|
|
1526
|
-
|
|
1489
|
+
|
|
1527
1490
|
**Interactive Objects:**
|
|
1528
|
-
|
|
1491
|
+
|
|
1529
1492
|
- {{object_1}}: {{behavior_and_purpose}}
|
|
1530
1493
|
- {{object_2}}: {{behavior_and_purpose}}
|
|
1531
|
-
|
|
1494
|
+
|
|
1532
1495
|
**Hazards and Obstacles:**
|
|
1533
|
-
|
|
1496
|
+
|
|
1534
1497
|
- {{hazard_1}}: {{damage_and_behavior}}
|
|
1535
1498
|
- {{hazard_2}}: {{damage_and_behavior}}
|
|
1536
1499
|
- id: collectibles-rewards
|
|
@@ -1538,18 +1501,18 @@ sections:
|
|
|
1538
1501
|
instruction: Define all collectible items and their placement rules
|
|
1539
1502
|
template: |
|
|
1540
1503
|
**Collectible Types:**
|
|
1541
|
-
|
|
1504
|
+
|
|
1542
1505
|
- {{collectible_1}}: {{value_and_purpose}}
|
|
1543
1506
|
- {{collectible_2}}: {{value_and_purpose}}
|
|
1544
|
-
|
|
1507
|
+
|
|
1545
1508
|
**Placement Guidelines:**
|
|
1546
|
-
|
|
1509
|
+
|
|
1547
1510
|
- Mandatory collectibles: {{placement_rules}}
|
|
1548
1511
|
- Optional collectibles: {{placement_rules}}
|
|
1549
1512
|
- Secret collectibles: {{placement_rules}}
|
|
1550
|
-
|
|
1513
|
+
|
|
1551
1514
|
**Reward Distribution:**
|
|
1552
|
-
|
|
1515
|
+
|
|
1553
1516
|
- Easy to find: {{percentage}}%
|
|
1554
1517
|
- Moderate challenge: {{percentage}}%
|
|
1555
1518
|
- High skill required: {{percentage}}%
|
|
@@ -1558,18 +1521,18 @@ sections:
|
|
|
1558
1521
|
instruction: Define how enemies should be placed and balanced in levels
|
|
1559
1522
|
template: |
|
|
1560
1523
|
**Enemy Categories:**
|
|
1561
|
-
|
|
1524
|
+
|
|
1562
1525
|
- {{enemy_type_1}}: {{behavior_and_usage}}
|
|
1563
1526
|
- {{enemy_type_2}}: {{behavior_and_usage}}
|
|
1564
|
-
|
|
1527
|
+
|
|
1565
1528
|
**Placement Principles:**
|
|
1566
|
-
|
|
1529
|
+
|
|
1567
1530
|
- Introduction encounters: {{guideline}}
|
|
1568
1531
|
- Standard encounters: {{guideline}}
|
|
1569
1532
|
- Challenge encounters: {{guideline}}
|
|
1570
|
-
|
|
1533
|
+
|
|
1571
1534
|
**Difficulty Scaling:**
|
|
1572
|
-
|
|
1535
|
+
|
|
1573
1536
|
- Enemy count progression: {{scaling_rule}}
|
|
1574
1537
|
- Enemy type introduction: {{pacing_rule}}
|
|
1575
1538
|
- Encounter complexity: {{complexity_rule}}
|
|
@@ -1582,14 +1545,14 @@ sections:
|
|
|
1582
1545
|
title: Level Layout Principles
|
|
1583
1546
|
template: |
|
|
1584
1547
|
**Spatial Design:**
|
|
1585
|
-
|
|
1548
|
+
|
|
1586
1549
|
- Grid size: {{grid_dimensions}}
|
|
1587
1550
|
- Minimum path width: {{width_units}}
|
|
1588
1551
|
- Maximum vertical distance: {{height_units}}
|
|
1589
1552
|
- Safe zones placement: {{safety_guidelines}}
|
|
1590
|
-
|
|
1553
|
+
|
|
1591
1554
|
**Navigation Design:**
|
|
1592
|
-
|
|
1555
|
+
|
|
1593
1556
|
- Clear path indication: {{visual_cues}}
|
|
1594
1557
|
- Landmark placement: {{landmark_rules}}
|
|
1595
1558
|
- Dead end avoidance: {{dead_end_policy}}
|
|
@@ -1599,13 +1562,13 @@ sections:
|
|
|
1599
1562
|
instruction: Define how to control the rhythm and pace of gameplay within levels
|
|
1600
1563
|
template: |
|
|
1601
1564
|
**Action Sequences:**
|
|
1602
|
-
|
|
1565
|
+
|
|
1603
1566
|
- High intensity duration: {{max_duration}}
|
|
1604
1567
|
- Rest period requirement: {{min_rest_time}}
|
|
1605
1568
|
- Intensity variation: {{pacing_pattern}}
|
|
1606
|
-
|
|
1569
|
+
|
|
1607
1570
|
**Learning Sequences:**
|
|
1608
|
-
|
|
1571
|
+
|
|
1609
1572
|
- New mechanic introduction: {{teaching_method}}
|
|
1610
1573
|
- Practice opportunity: {{practice_duration}}
|
|
1611
1574
|
- Skill application: {{application_context}}
|
|
@@ -1614,14 +1577,14 @@ sections:
|
|
|
1614
1577
|
instruction: Define how to create appropriate challenges for each level type
|
|
1615
1578
|
template: |
|
|
1616
1579
|
**Challenge Types:**
|
|
1617
|
-
|
|
1580
|
+
|
|
1618
1581
|
- Execution challenges: {{skill_requirements}}
|
|
1619
1582
|
- Puzzle challenges: {{complexity_guidelines}}
|
|
1620
1583
|
- Time challenges: {{time_pressure_rules}}
|
|
1621
1584
|
- Resource challenges: {{resource_management}}
|
|
1622
|
-
|
|
1585
|
+
|
|
1623
1586
|
**Difficulty Calibration:**
|
|
1624
|
-
|
|
1587
|
+
|
|
1625
1588
|
- Skill check frequency: {{frequency_guidelines}}
|
|
1626
1589
|
- Failure recovery: {{retry_mechanics}}
|
|
1627
1590
|
- Hint system integration: {{help_system}}
|
|
@@ -1635,7 +1598,7 @@ sections:
|
|
|
1635
1598
|
instruction: Define how level data should be structured for implementation
|
|
1636
1599
|
template: |
|
|
1637
1600
|
**Level File Format:**
|
|
1638
|
-
|
|
1601
|
+
|
|
1639
1602
|
- Data format: {{json|yaml|custom}}
|
|
1640
1603
|
- File naming: `level_{{world}}_{{number}}.{{extension}}`
|
|
1641
1604
|
- Data organization: {{structure_description}}
|
|
@@ -1673,14 +1636,14 @@ sections:
|
|
|
1673
1636
|
instruction: Define how level assets are organized and loaded
|
|
1674
1637
|
template: |
|
|
1675
1638
|
**Tilemap Requirements:**
|
|
1676
|
-
|
|
1639
|
+
|
|
1677
1640
|
- Tile size: {{tile_dimensions}}px
|
|
1678
1641
|
- Tileset organization: {{tileset_structure}}
|
|
1679
1642
|
- Layer organization: {{layer_system}}
|
|
1680
1643
|
- Collision data: {{collision_format}}
|
|
1681
|
-
|
|
1644
|
+
|
|
1682
1645
|
**Audio Integration:**
|
|
1683
|
-
|
|
1646
|
+
|
|
1684
1647
|
- Background music: {{music_requirements}}
|
|
1685
1648
|
- Ambient sounds: {{ambient_system}}
|
|
1686
1649
|
- Dynamic audio: {{dynamic_audio_rules}}
|
|
@@ -1689,19 +1652,19 @@ sections:
|
|
|
1689
1652
|
instruction: Define performance requirements for level systems
|
|
1690
1653
|
template: |
|
|
1691
1654
|
**Entity Limits:**
|
|
1692
|
-
|
|
1655
|
+
|
|
1693
1656
|
- Maximum active entities: {{entity_limit}}
|
|
1694
1657
|
- Maximum particles: {{particle_limit}}
|
|
1695
1658
|
- Maximum audio sources: {{audio_limit}}
|
|
1696
|
-
|
|
1659
|
+
|
|
1697
1660
|
**Memory Management:**
|
|
1698
|
-
|
|
1661
|
+
|
|
1699
1662
|
- Texture memory budget: {{texture_memory}}MB
|
|
1700
1663
|
- Audio memory budget: {{audio_memory}}MB
|
|
1701
1664
|
- Level loading time: <{{load_time}}s
|
|
1702
|
-
|
|
1665
|
+
|
|
1703
1666
|
**Culling and LOD:**
|
|
1704
|
-
|
|
1667
|
+
|
|
1705
1668
|
- Off-screen culling: {{culling_distance}}
|
|
1706
1669
|
- Level-of-detail rules: {{lod_system}}
|
|
1707
1670
|
- Asset streaming: {{streaming_requirements}}
|
|
@@ -1714,13 +1677,13 @@ sections:
|
|
|
1714
1677
|
title: Automated Testing
|
|
1715
1678
|
template: |
|
|
1716
1679
|
**Performance Testing:**
|
|
1717
|
-
|
|
1680
|
+
|
|
1718
1681
|
- Frame rate validation: Maintain {{fps_target}} FPS
|
|
1719
1682
|
- Memory usage monitoring: Stay under {{memory_limit}}MB
|
|
1720
1683
|
- Loading time verification: Complete in <{{load_time}}s
|
|
1721
|
-
|
|
1684
|
+
|
|
1722
1685
|
**Gameplay Testing:**
|
|
1723
|
-
|
|
1686
|
+
|
|
1724
1687
|
- Completion path validation: All objectives achievable
|
|
1725
1688
|
- Collectible accessibility: All items reachable
|
|
1726
1689
|
- Softlock prevention: No unwinnable states
|
|
@@ -1748,14 +1711,14 @@ sections:
|
|
|
1748
1711
|
title: Balance Validation
|
|
1749
1712
|
template: |
|
|
1750
1713
|
**Metrics Collection:**
|
|
1751
|
-
|
|
1714
|
+
|
|
1752
1715
|
- Completion rate: Target {{completion_percentage}}%
|
|
1753
1716
|
- Average completion time: {{target_time}} ± {{variance}}
|
|
1754
1717
|
- Death count per level: <{{max_deaths}}
|
|
1755
1718
|
- Collectible discovery rate: {{discovery_percentage}}%
|
|
1756
|
-
|
|
1719
|
+
|
|
1757
1720
|
**Iteration Guidelines:**
|
|
1758
|
-
|
|
1721
|
+
|
|
1759
1722
|
- Adjustment criteria: {{criteria_for_changes}}
|
|
1760
1723
|
- Testing sample size: {{minimum_testers}}
|
|
1761
1724
|
- Validation period: {{testing_duration}}
|
|
@@ -1768,14 +1731,14 @@ sections:
|
|
|
1768
1731
|
title: Design Phase
|
|
1769
1732
|
template: |
|
|
1770
1733
|
**Concept Development:**
|
|
1771
|
-
|
|
1734
|
+
|
|
1772
1735
|
1. Define level purpose and goals
|
|
1773
1736
|
2. Create rough layout sketch
|
|
1774
1737
|
3. Identify key mechanics and challenges
|
|
1775
1738
|
4. Estimate difficulty and duration
|
|
1776
|
-
|
|
1739
|
+
|
|
1777
1740
|
**Documentation Requirements:**
|
|
1778
|
-
|
|
1741
|
+
|
|
1779
1742
|
- Level design brief
|
|
1780
1743
|
- Layout diagrams
|
|
1781
1744
|
- Mechanic integration notes
|
|
@@ -1784,15 +1747,15 @@ sections:
|
|
|
1784
1747
|
title: Implementation Phase
|
|
1785
1748
|
template: |
|
|
1786
1749
|
**Technical Implementation:**
|
|
1787
|
-
|
|
1750
|
+
|
|
1788
1751
|
1. Create level data file
|
|
1789
1752
|
2. Build tilemap and layout
|
|
1790
1753
|
3. Place entities and objects
|
|
1791
1754
|
4. Configure level logic and triggers
|
|
1792
1755
|
5. Integrate audio and visual effects
|
|
1793
|
-
|
|
1756
|
+
|
|
1794
1757
|
**Quality Assurance:**
|
|
1795
|
-
|
|
1758
|
+
|
|
1796
1759
|
1. Automated testing execution
|
|
1797
1760
|
2. Internal playtesting
|
|
1798
1761
|
3. Performance validation
|
|
@@ -1801,14 +1764,14 @@ sections:
|
|
|
1801
1764
|
title: Integration Phase
|
|
1802
1765
|
template: |
|
|
1803
1766
|
**Game Integration:**
|
|
1804
|
-
|
|
1767
|
+
|
|
1805
1768
|
1. Level progression integration
|
|
1806
1769
|
2. Save system compatibility
|
|
1807
1770
|
3. Analytics integration
|
|
1808
1771
|
4. Achievement system integration
|
|
1809
|
-
|
|
1772
|
+
|
|
1810
1773
|
**Final Validation:**
|
|
1811
|
-
|
|
1774
|
+
|
|
1812
1775
|
1. Full game context testing
|
|
1813
1776
|
2. Performance regression testing
|
|
1814
1777
|
3. Platform compatibility verification
|
|
@@ -1861,7 +1824,7 @@ sections:
|
|
|
1861
1824
|
- id: initial-setup
|
|
1862
1825
|
instruction: |
|
|
1863
1826
|
This template creates a comprehensive game brief that serves as the foundation for all subsequent game development work. The brief should capture the essential vision, scope, and requirements needed to create a detailed Game Design Document.
|
|
1864
|
-
|
|
1827
|
+
|
|
1865
1828
|
This brief is typically created early in the ideation process, often after brainstorming sessions, to crystallize the game concept before moving into detailed design.
|
|
1866
1829
|
|
|
1867
1830
|
- id: game-vision
|
|
@@ -1918,7 +1881,7 @@ sections:
|
|
|
1918
1881
|
repeatable: true
|
|
1919
1882
|
template: |
|
|
1920
1883
|
**Core Mechanic: {{mechanic_name}}**
|
|
1921
|
-
|
|
1884
|
+
|
|
1922
1885
|
- **Description:** {{how_it_works}}
|
|
1923
1886
|
- **Player Value:** {{why_its_fun}}
|
|
1924
1887
|
- **Implementation Scope:** {{complexity_estimate}}
|
|
@@ -1945,12 +1908,12 @@ sections:
|
|
|
1945
1908
|
title: Technical Constraints
|
|
1946
1909
|
template: |
|
|
1947
1910
|
**Platform Requirements:**
|
|
1948
|
-
|
|
1911
|
+
|
|
1949
1912
|
- Primary: {{platform_1}} - {{requirements}}
|
|
1950
1913
|
- Secondary: {{platform_2}} - {{requirements}}
|
|
1951
|
-
|
|
1914
|
+
|
|
1952
1915
|
**Technical Specifications:**
|
|
1953
|
-
|
|
1916
|
+
|
|
1954
1917
|
- Engine: Phaser 3 + TypeScript
|
|
1955
1918
|
- Performance Target: {{fps_target}} FPS on {{target_device}}
|
|
1956
1919
|
- Memory Budget: <{{memory_limit}}MB
|
|
@@ -1988,10 +1951,10 @@ sections:
|
|
|
1988
1951
|
title: Competitive Analysis
|
|
1989
1952
|
template: |
|
|
1990
1953
|
**Direct Competitors:**
|
|
1991
|
-
|
|
1954
|
+
|
|
1992
1955
|
- {{competitor_1}}: {{strengths_and_weaknesses}}
|
|
1993
1956
|
- {{competitor_2}}: {{strengths_and_weaknesses}}
|
|
1994
|
-
|
|
1957
|
+
|
|
1995
1958
|
**Differentiation Strategy:**
|
|
1996
1959
|
{{how_we_differ_and_why_thats_valuable}}
|
|
1997
1960
|
- id: market-opportunity
|
|
@@ -2015,16 +1978,16 @@ sections:
|
|
|
2015
1978
|
title: Content Categories
|
|
2016
1979
|
template: |
|
|
2017
1980
|
**Core Content:**
|
|
2018
|
-
|
|
1981
|
+
|
|
2019
1982
|
- {{content_type_1}}: {{quantity_and_description}}
|
|
2020
1983
|
- {{content_type_2}}: {{quantity_and_description}}
|
|
2021
|
-
|
|
1984
|
+
|
|
2022
1985
|
**Optional Content:**
|
|
2023
|
-
|
|
1986
|
+
|
|
2024
1987
|
- {{optional_content_type}}: {{quantity_and_description}}
|
|
2025
|
-
|
|
1988
|
+
|
|
2026
1989
|
**Replay Elements:**
|
|
2027
|
-
|
|
1990
|
+
|
|
2028
1991
|
- {{replayability_features}}
|
|
2029
1992
|
- id: difficulty-accessibility
|
|
2030
1993
|
title: Difficulty and Accessibility
|
|
@@ -2091,13 +2054,13 @@ sections:
|
|
|
2091
2054
|
title: Player Experience Metrics
|
|
2092
2055
|
template: |
|
|
2093
2056
|
**Engagement Goals:**
|
|
2094
|
-
|
|
2057
|
+
|
|
2095
2058
|
- Tutorial completion rate: >{{percentage}}%
|
|
2096
2059
|
- Average session length: {{duration}} minutes
|
|
2097
2060
|
- Player retention: D1 {{d1}}%, D7 {{d7}}%, D30 {{d30}}%
|
|
2098
|
-
|
|
2061
|
+
|
|
2099
2062
|
**Quality Benchmarks:**
|
|
2100
|
-
|
|
2063
|
+
|
|
2101
2064
|
- Player satisfaction: >{{rating}}/10
|
|
2102
2065
|
- Completion rate: >{{percentage}}%
|
|
2103
2066
|
- Technical performance: {{fps_target}} FPS consistent
|
|
@@ -2105,13 +2068,13 @@ sections:
|
|
|
2105
2068
|
title: Development Metrics
|
|
2106
2069
|
template: |
|
|
2107
2070
|
**Technical Targets:**
|
|
2108
|
-
|
|
2071
|
+
|
|
2109
2072
|
- Zero critical bugs at launch
|
|
2110
2073
|
- Performance targets met on all platforms
|
|
2111
2074
|
- Load times under {{seconds}}s
|
|
2112
|
-
|
|
2075
|
+
|
|
2113
2076
|
**Process Goals:**
|
|
2114
|
-
|
|
2077
|
+
|
|
2115
2078
|
- Development timeline adherence
|
|
2116
2079
|
- Feature scope completion
|
|
2117
2080
|
- Quality assurance standards
|
|
@@ -2120,7 +2083,7 @@ sections:
|
|
|
2120
2083
|
condition: has_business_goals
|
|
2121
2084
|
template: |
|
|
2122
2085
|
**Commercial Goals:**
|
|
2123
|
-
|
|
2086
|
+
|
|
2124
2087
|
- {{revenue_target}} in first {{time_period}}
|
|
2125
2088
|
- {{user_acquisition_target}} players in first {{time_period}}
|
|
2126
2089
|
- {{retention_target}} monthly active users
|
|
@@ -2173,12 +2136,12 @@ sections:
|
|
|
2173
2136
|
title: Validation Plan
|
|
2174
2137
|
template: |
|
|
2175
2138
|
**Concept Testing:**
|
|
2176
|
-
|
|
2139
|
+
|
|
2177
2140
|
- {{validation_method_1}} - {{timeline}}
|
|
2178
2141
|
- {{validation_method_2}} - {{timeline}}
|
|
2179
|
-
|
|
2142
|
+
|
|
2180
2143
|
**Prototype Testing:**
|
|
2181
|
-
|
|
2144
|
+
|
|
2182
2145
|
- {{testing_approach}} - {{timeline}}
|
|
2183
2146
|
- {{feedback_collection_method}} - {{timeline}}
|
|
2184
2147
|
|