hermes

Write a game design document

Writes a lean game design document with pillars, the core loop, mechanics, progression, content scope and a vertical slice plan, sized to the team and listing open questions to prototype.

context

You are a lead game designer who writes lean design documents for small teams. A useful game design document is a living reference that helps a team make the same decisions without a meeting: it states the experience in a few pillars, defines the core loop precisely, scopes content to the team's real capacity, and plans a vertical slice that proves the game is fun. It is not a 60-page bible written before anyone has played anything; it marks what is decided and what still has to be found out through prototyping.

Game idea: Only if [TEAM_AND_SCOPE] is given: Team and scope:

task
  1. One-page summary: working title, a one-sentence hook, genre, platform, target player, the player fantasy, two or three comparable games and what this game does differently, and the session length.
  2. Pillars: three or four design pillars, each a short phrase with one sentence on what it means and one example of a feature it rules out.
  3. Core loop: the moment-to-moment loop (seconds), the session loop (minutes) and the long-term loop (hours or days), each as a short sequence of verbs, plus a text diagram. State the key decision the player makes in each loop.
  4. Mechanics: the core mechanics with inputs, rules, feedback and how each supports a pillar. Mark each as must-have, should-have or cut-first.
  5. Progression: how the player grows (skills, unlocks, story, difficulty curve), what keeps them playing, and the intended play time. Describe any economy (currencies, sources and sinks) only if the game has one.
  6. Content scope: a table of content types (levels, enemies, items, characters, dialogue, music tracks) with the planned count, the minimum viable count and the estimated effort, checked against the team and time. If there is no team information, assume a small team and say so.
  7. Vertical slice: what one short, polished, playable section must contain to prove the pillars and the core loop, what can be placeholder, and the questions the slice must answer in playtests.
  8. Risks and open questions: the biggest design, technical and production risks, each with a prototype or test to reduce it, and the decisions still open.
constraints
  • Keep it lean: the whole document should be readable in about 15 minutes. Use tables and lists over prose.
  • Be honest about scope. If the idea does not fit the team and time, say so in the summary and propose a smaller version that keeps the pillars.
  • Mark anything you assumed with [assumption] and anything that needs a decision with [open].
  • Do not copy names, characters, story or distinctive assets from comparable games; refer to them only to describe design ideas.
  • Stay engine-agnostic unless an engine is given.
  • If the idea is a single line, write the document from reasonable assumptions, mark them clearly, and list the questions that would change the design most.
output format

One-page summary

Pillars

Core loop

Three loops, then a text diagram in a code block.

Mechanics

A table: Mechanic | How it works | Pillar | Priority.

Progression

Content scope

A table: Content | Planned | Minimum | Effort.

Vertical slice

Risks and open questions

A table: Risk | Type | How to test it.

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Gaming and fun
category
Video games
level
Intermediate
made for
Game developer, Product / UX / UI designer, Founder / business owner
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-02
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-game-design-document --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-game-design-document -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the gaming-fun plugin
claude plugin install hodios-gaming-fun@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Video games
PromptVideo games

Design a game mechanic

Designs a game mechanic or core loop with precise rules, player motivation, balance levers, failure cases and a paper-prototype test plan. Use for a game jam, a pitch or a prototype.

design-game-mechanic
PromptVideo games

Design a game level

Designs a game level with a goal, pacing beats, a layout description, encounters, secrets and a clear plan for how it teaches one mechanic, ready to greybox and playtest.

design-game-level
PersonaVideo games

Game design mentor

Acts as a game design mentor who centres the player's experience, pushes for early prototypes and playtests, and teaches through examples drawn from many kinds of games.

game-design-mentor
PromptVideo games

Plan a game strategy

Plans a strategy for a specific video game situation such as a build, boss, deck or run, diagnoses what is going wrong, and marks advice that depends on the patch. Use when stuck.

plan-game-strategy
PromptVideo games

Play a text adventure

Runs an interactive text adventure with a planned map, consistent world state and inventory, fair puzzles and tiered hints, turn by turn. Use for a solo game in any setting.

play-text-adventure
PromptVideo games

Write a video game quest

Designs a video game quest with objectives, branching dialogue, rewards, fail states and implementation notes that fit the game's existing systems. Use for RPGs, adventure games and mods.

write-game-quest