Game Dev Workflow
2025-09-03 12:39
STATUS: #sapling
TAGS: writing workflow,
Game Dev Workflow
Obsidian Documentation Structure for Your Team
1. Homepage & Project Overview
📄 Project Vision & Pillars
📄 Core Story Summary (One Page)
📄 Target Audience & Game Tone
📄 Development Timeline & Milestones
2. Story & Narrative Hub
📁 Core Narrative/
├── 📄 Three-Act Story Structure
├── 📄 Character Profiles & Arcs
├── 📄 World Lore & Setting
├── 📄 Dialogue Style Guide
└── 📄 Cutscene Scripts & Timing
📁 Implementation Guides/
├── 📄 Text Integration Specs
├── 📄 Dialogue System Requirements
├── 📄 Cutscene Technical Specs
└── 📄 Localization Guidelines
3. Team-Specific Sections
For Developer:
📁 Technical Requirements/
├── 📄 Story Integration Points
├── 📄 Dialogue System Architecture
├── 📄 Save System Story States
├── 📄 Cutscene Trigger Locations
└── 📄 UI Text Requirements
For Artist:
📁 Visual Narrative/
├── 📄 Character Design References
├── 📄 Environment Mood Boards
├── 📄 Cutscene Storyboards
├── 📄 UI/Menu Art Specifications
└── 📄 Asset Priority Lists
4. Production Resources
📁 Asset Lists/
├── 📄 Character Art Needed
├── 📄 Environment Art Needed
├── 📄 UI Elements Needed
└── 📄 Audio Cues Required
📁 Review Materials/
├── 📄 Completed Scenes
├── 📄 Feedback & Iteration Notes
└── 📄 Version History
Development Order & Process
Phase 1: Foundation (Weeks 1-3)
1. Core Vision Documentation[1][2]
- Write your three-act story structure in one page
- Create character profiles with gameplay relevance
- Define your narrative pillars (themes, tone, target emotions)
- Document technical story requirements for your developer[3]
2. Story-Gameplay Integration Planning[4][5]
- Map story beats to platformer progression[4][1]
- Define where cutscenes vs environmental storytelling occur[4]
- Plan character progression that mirrors story arc[4]
- Create level story summaries (what story each level tells)[1]
Phase 2: Pre-Production (Weeks 4-8)
3. Detailed Story Planning[4][2]
- Write detailed scene outlines for each level[4]
- Create dialogue scripts for key story moments[4]
- Design environmental storytelling elements (readable objects, visual cues)[4]
- Plan story-driven gameplay mechanics (new abilities that serve narrative)[4]
4. Technical Documentation[3][2]
- Specify dialogue system requirements[5]
- Document save system story states[3]
- Create cutscene technical specifications[2][3]
- Define UI text integration points[3]
5. Art Direction Guidance[6][3]
- Create visual style guide tied to story themes[6][3]
- Provide character reference sheets with story context[6]
- Design environment mood boards for each story section[6]
- Plan cutscene storyboards for key narrative moments[6]
Phase 3: Production (Weeks 9-20)
6. Content Creation Priority[7][3]
- Level 1-2: Establish core mechanics + story hook[7][8]
- Character introduction: Implement protagonist setup[7]
- Mid-game levels: Develop story progression and character growth[7]
- Climax levels: Integrate story peaks with gameplay challenges[7]
- Ending: Resolution that ties to character arc completion[7]
7. Iterative Integration[9][8]
- Weekly story reviews with team in Slack[9]
- Playtesting story pacing alongside gameplay[7][8]
- Refining dialogue based on gameplay flow[8]
- Adjusting environmental storytelling based on art implementation[8]
Phase 4: Polish (Weeks 21-24)
8. Narrative Polish[7][10]
- Dialogue editing for flow and character voice consistency[10]
- Cutscene timing optimization[10]
- Environmental storytelling refinement[10]
- Localization preparation if needed[10]
Team Collaboration Workflow
Daily Coordination:
- Morning Slack check-in: story implementation progress, blockers
- Work in assigned YouTrack tasks: clear story deliverables
- Evening updates: completed story content, next-day preview
Weekly Reviews:
- Story integration playtest: how narrative feels in gameplay context[9][8]
- Art-story alignment check: visual storytelling effectiveness[6]
- Technical story review: dialogue system, cutscene implementation[3]
Key Documentation Principles:
- Single source of truth: Everything story-related lives in Obsidian[11][12]
- Cross-linking: Connect character profiles to scenes, levels to story beats[13]
- Implementation-ready: Every story document includes technical specifications[3]
- Visual integration: Include concept sketches, mood references for your artist[6]
This structure ensures your developer has clear technical requirements, your artist understands the visual narrative goals, and you maintain creative control while providing actionable guidance for your small team[9][14][15]. The key is starting with story-gameplay integration from day one rather than treating narrative as an add-on[4][5][8].
Sources
[1] How Games are Made: 4 Stages of Video Game Development Process https://gamedesignskills.com/game-development/stages-of-game-development-process/
[2] What Are The Main Stages Of Game Development? | GameMaker https://gamemaker.io/en/blog/stages-of-game-development
[3] Game Development Process: Key Phases and Insights https://rocketbrush.com/blog/game-development-process-guide
[4] Video Game Narrative: The Different Types and How-to Start Writing https://pinnguaq.com/learn/video-game-narrative/
[5] Game Narrative Design Complete Guide + Principles & Tips https://pixune.com/blog/game-narrative-developing-a-story-that-works/
[6] Creating Visual Narratives and Storytelling | Art Rocket https://www.clipstudio.net/how-to-draw/archives/158243
[7] How Video Games Are Made : The Game Development Process https://www.cgspectrum.com/blog/game-development-process
[8] Good tutorials on how to create a story-driven 2D Platformer ... - Reddit https://www.reddit.com/r/gamedev/comments/y2t8cl/good_tutorials_on_how_to_create_a_storydriven_2d/
[9] Workflow for indie gamedevs - Indiedevcasts https://www.indiedevcasts.com/posts/workflow-indie-gamedevs
[10] 6 Stages of Game Development: From Idea to Release & Support https://rocketbrush.com/blog/going-through-phases-of-game-creating
[11] Collaborate on a Publish site - Obsidian Help https://help.obsidian.md/publish/collaborate
[12] Publishing for teams - Obsidian Help https://help.obsidian.md/teams/publish
[13] How to Write a Novel in Obsidian: Templates, Workflow, and Tools https://pdworkman.com/write-book-with-obsidian/
[14] Indie Dev Insights #3: How to build a successful small indie team https://gamecity-hamburg.de/news/indie-dev-insights-how-to-build-a-successful-small-indie-team/
[15] How To Form A Solid Indie Game Development Team - NYFA https://www.nyfa.edu/student-resources/forming-solid-indie-game-development-team/
[16] 2D Platformer Game Guide - AI Prompt - DocsBot AI https://docsbot.ai/prompts/creative/2d-platformer-game-guide
[17] Advice for my small indie team? : r/gamedev - Reddit https://www.reddit.com/r/gamedev/comments/173pkqc/advice_for_my_small_indie_team/
[18] Building a best-selling game with a tiny team – with Jonas Tyroller https://newsletter.pragmaticengineer.com/p/thronefall
[19] Creating a 2D Platformer Game Using Stride3D Tutorial Part 1 https://www.youtube.com/watch?v=XiPzWupYEI0
[20] Design 2D Platformer Levels - Scenario https://www.scenario.com/post/design-2d-platformer-levels
[21] The art of storytelling for developers by Dave Kiss : Juha-Matti Santala https://notes.hamatti.org/sources/talks/the-art-of-storytelling-for-developers-by-dave-kiss
[22] Best order to dev? : r/gamedev - Reddit https://www.reddit.com/r/gamedev/comments/182v13a/best_order_to_dev/
[23] Any Examples of Narrative Design Docs? : r/gamedesign - Reddit https://www.reddit.com/r/gamedesign/comments/4gtitr/any_examples_of_narrative_design_docs/
[24] [GENERAL] Game Development Production Pipeline - - kitatus http://kitatusandfriends.co.uk/general/productionpipeline/
[25] The guide to implementing 2D platformers | Higher-Order Fun http://higherorderfun.com/blog/2012/05/20/the-guide-to-implementing-2d-platformers/
[26] How to Write Technical Documentation with Empathy https://pathtosenior.substack.com/p/the-art-of-documentation-how-to-write
[27] A look into our game production pipelines - Tactile Games https://tactilegames.com/the-role-of-producer-at-tactile-a-look-into-our-game-production-pipelines/
[28] The Artistic Journey: Documenting and Organizing Your Creative ... https://www.theartistnextlevel.com/blog/the-artistic-journey-documenting-and-organizing-your-creative-legacy
[29] Game Development Process : Game Production Pipeline - GDKeys - https://gdkeys.com/game-development-process/