Skip to content
Development
Skill

/game-architect

READ this skill when designing or planning any game system architecture — including combat, skills, AI, UI, multiplayer, narrative, or scene systems. Contains paradigm selection guides (DDD / Data-Driven / Prototype), system-specific design references, and mixing strategies.

From plugin
game-dev-skills
10517 skills4 agents

Claude Code

$ npx -y skills add Yuki001/game-dev-skills --skill game-architect --agent claude-code

SKILL.md

game-architect.SKILL.md
name: game-architect
description: READ this skill when designing or planning any game system architecture — including combat, skills, AI, UI, multiplayer, narrative, or scene systems. Contains paradigm selection guides (DDD / Data-Driven / Prototype), system-specific design references, and mixing strategies. Works as a domain knowledge plugin alongside workflow skills (OpenSpec, SpecKit) or plan mode of an agent.

Game Architect Skill

Game architecture domain knowledge reference. Provides paradigm selection, system design references for game project architecture.

> [!NOTE] > This skill contains **domain knowledge only**, not a workflow. Pair it with a workflow skill (e.g., OpenSpec, SpecKit) or an agent's plan mode for structured design flow.

Usage Modes

With Workflow Skill (Recommended)

When used with a workflow skill (e.g., OpenSpec, SpecKit) or in the plan mode of an agent, this skill serves as a domain knowledge plugin:

  • **During requirements/spec phases**: Consult the Paradigm Selection Guide and System-Specific References to inform architectural decisions
  • **During design/planning phases**: Use the Reference Lookup Guide below to read relevant `references/` documents

Knowledge Mode (Query)

When user requests to query knowledge for game architecture, this skill provides a reference lookup guide to relevant `references/` documents based on the task.

---

Reference Lookup Guide

When designing game architecture, read the relevant `references/` documents based on the task:

Architecture References

| When | Read | |------|------| | Always (high-level structure) | `references/macro-design.md` | | Always (core principles) | `references/principles.md` | | Requirement analysis | `references/requirements-analysis.md` | | Choosing DDD paradigm | `references/domain-driven-design.md` | | Choosing Data-Driven paradigm | `references/data-driven-design.md` | | Choosing Prototype paradigm | `references/prototype-design.md` | | Evolution & extensibility review | `references/evolution.md` | | Changing requirements in an existing implementation | `references/requirement-change-strategy.md` | | Performance optimization needed | `references/performance-optimization.md` | | Multiplayer support needed | `references/multiplayer-overview.md` |

  • For physical architecture design, see the Physical Architecture References table below.
  • For system-specific design, see the System-Specific References table below.
  • For multiplayer system design, see the Multiplayer References table below.

Note : Only read the multiplayer references when multiplayer is needed.

Physical Architecture References

| When | Read | |------|------| | Project structure & file organization | `references/project-structure.md` | | Data formats, processing, custom formats, bundles, metadata | `references/data-files.md` | | Gameplay content editor applications and authoring pipelines | `references/content-editor.md` | | Asset conventions & pipeline | `references/asset-conventions.md` | | Distribution, packaging, hot update, CDN, deployment | `references/distribution.md` |

System-Specific References

| System Category | Reference | |----------------|-----------| | Foundation & Core (Logs, Timers, Modules, Events, Resources, Audio, Input) | `references/system-foundation.md` | | Time & Logic Flow (Update Loops, Async, FSM, Command Queues, Controllers) | `references/system-time.md` | | Combat & Scene (Scene Graphs, Spatial Partitioning, ECS/EC, Loading) | `references/system-scene.md` | | UI & Modules (Modules Management, MVC/MVP/MVVM, UI Management, Data Binding, Reactive) | `references/system-ui.md` | | Skill System (Attribute, Skill, Buff) | `references/system-skill.md` | | Action Combat System (HitBox, Damage, Melee, Projectiles) | `references/system-action-combat.md` | | Camera, Character & Controller 3C (PlayerController, Physics, Camera, Actor States) | `references/system-3c.md` | | Effect & Feedback System (Screen Shake, VFX, Hit-Stop, Haptics, SFX, Floating Text, UI Feedback, Orchestration) | `references/system-effect-feedback.md` | | Narrative System (Dialogue, Cutscenes, Story Flow) | `references/system-narrative.md` | | Game AI System (Movement, Pathfinding, Decision Making, Tactical) | `references/system-game-ai.md` | | Mod & DLC System (Plugin Architecture, Config Database, Scripting, Hooks, Extensibility) | `references/system-mod.md` | | Procedural Content Generation (PCG) (World/Level Generation, Roguelike, Noise, Simulation) | `references/system-pcg.md` | | Algorithm & Data Structures (Pathfinding, Search, Physics, Generic Solver) | `references/algorithm.md` | | Puzzle Game System (Match-3, Jigsaw, Water Sort, Blocks, Physics Puzzles, Board Games, Content & Presentation Boundaries) | `references/system-puzzle.md` |

Multiplayer References

| Focus | Reference | Use When | |------|------|------| | Multiplayer overview | `references/multiplayer-overview.md` | Decide client/server responsibility, authority split, and gameplay sync style | | Multiplayer protocol and connection | `references/multiplayer-protocol.md` | Design messages, serialization, Req/Resp/Notify, heartbeat, reconnect | | Multiplayer server architecture | `references/multiplayer-server-architecture.md` | Design ownership boundaries, process roles, deployment, persistence, recovery | | Common server components and services | `references/multiplayer-implementation-common.md` | Build shared infrastructure such as auth, gateway, connector, db, cache, discovery, queue, observability | | Room server build playbook | `references/multiplayer-implementation-room.md` | Build a concrete small-to-medium room-based realtime server with join flow, room ownership, settlement, reconnect | | Encounter server build playbook | `references/multiplayer-implementation-encounter.md` | Build a concrete turn-based or combat-workflow server with checkpointing, idempotent actions, settlement | | Persistent world server build playbook | `r

Read more
@yuki001
Ships withgame-dev-skills

This is my personal agent skill repository, primarily focused on game development.

10517 skills4 agents
Get the whole plugin

Stars on GitHub

Momentum

stars in total
105
Star history of Yuki001/game-dev-skills on GitHub, a chart by star-history.com

Other skills on game-dev-skills.

gat-design

gat-design

Design one system within a specific milestone's scope: write the milestone-scoped system GDD, content data, and system art doc,…

gat-milestone

gat-milestone

Plan milestone slices from overview + narrative alone (no system GDDs required), create per-milestone directory skeletons and…

gat-story

gat-story

Develop game story and narrative through one-question-at-a-time writer interviews. Produces narrative docs under gat/narrative/…

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills10d309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc12d293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react1d252k
@facebook@facebookInstall Skill

Questions about game-architect.

Which coding agents can use game-architect?
game-architect installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.