GitHub Copilot Game Studios

A GitHub Copilot studio-kit template for structured solo game development.
Current snapshot: 23 agents, 14 skills, 11 instruction files.

---

Why This Exists

Building a game with AI is faster when the session has structure. This repository gives GitHub Copilot a studio-style operating model: role-specific agents, task-oriented skills, path-scoped instructions, workflow docs, and governance files that keep work reviewable.

This is a template kit, not a complete Unity project. The repo is intentionally light on engine scaffolding so teams can pin their own Unity version and project defaults through the workflow instead of inheriting a sample project they may discard.

Current Snapshot

Category	Count	Notes
Agents	23	Current custom agents under .github/agents/
Skills	14	Current workflow skills under .github/skills/
Instructions	11	Path-scoped instruction files under .github/instructions/
Hook files	2	Documentation-only hook folder (README.md + policy template)

When root docs drift, use the indexes under .github/docs/ as the source of truth.

Current Agent Inventory

• Core studio agents: studio-orchestrator, producer, creative-director, technical-director, art-director, design-lead
• Programming agents: lead-programmer, gameplay-programmer, engine-programmer, ui-programmer, ai-programmer
• Engine specialists: unity-specialist, unity-ui-specialist, unity-dots-specialist, unity-addressables-specialist, unity-shader-specialist, godot-specialist, godot-gdscript-specialist, godot-csharp-specialist, godot-gdextension-specialist, godot-shader-specialist, unreal-specialist
• Quality agent: qa-lead

See .github/docs/agents-index.md for concise responsibilities.

Current Skill Inventory

• /architecture-review
• /brainstorm
• /code-review
• /design-review
• /dev-story
• /gate-check
• /help
• /project-stage-detect
• /scope-check
• /setup-engine
• /smoke-check
• /sprint-status
• /start
• /story-readiness

See .github/docs/skills-index.md and .github/docs/workflow-catalog.yaml for routing.

What The Template Includes

• .github/copilot-instructions.md as the main workspace operating model.
• .github/agents/ for specialist agent definitions.
• .github/skills/ for slash-command workflows.
• .github/instructions/ for path-scoped coding and content rules.
• .github/docs/ for workflow catalog, indexes, migration notes, and supporting guidance.
• docs/ for workflow guidance, examples, and engine reference material.
• Root files such as README.md, LICENSE, and .gitignore.

What It Does Not Include By Default

• No bundled Unity project scaffold.
• No active hook bundle running automatically on every session.
• No promise that roadmap counts from earlier drafts are already shipped in this snapshot.

That tradeoff keeps the template smaller, more predictable, and cheaper in context usage.

Getting Started

1. Clone the template.
2. Open the repository in VS Code with GitHub Copilot enabled.
3. Read .github/copilot-instructions.md for the workspace operating model.
4. Run /start if you want workflow routing from scratch.
5. Run /setup-engine when you are ready to pin engine version, naming conventions, and project defaults.

If you are maintaining the kit itself, start from .github/docs/, then inspect .github/agents/, .github/skills/, and .github/instructions/.

Project Structure

.github/
  agents/
  docs/
  hooks/
  instructions/
  memory/
  rules/
  skills/
docs/
src/
LICENSE
README.md

This repository currently ships the AI studio layer, not a sample gameplay project.

Hooks Policy

The public template keeps hooks in documentation-only mode for now. The hook folder exists to document future or optional hook wiring without shipping a heavy automation layer by default. See .github/hooks/README.md and .github/docs/hooks-mapping.md.

Customization

This template is meant to be adapted:

• add or remove agents for your studio workflow,
• expand the skill set as your pipeline matures,
• tighten instruction files around your project structure,
• introduce active hooks later if your team wants stricter automation,
• pin Unity-specific defaults through /setup-engine and .github/docs/technical-preferences.md.

Supporting Docs

• .github/copilot-instructions.md - operating model
• .github/docs/README.md - docs hub
• .github/docs/agents-index.md - current agent inventory
• .github/docs/engine-routing-spec.md - engine routing rules
• .github/docs/skills-index.md - current skill inventory
• .github/docs/rules-index.md - grouped instruction coverage
• .github/docs/instruction-index.md - fast instruction lookup
• .github/docs/workflow-catalog.yaml - workflow sequencing
• docs/README.md - supporting docs classified as current, planned, or legacy
• docs/COLLABORATIVE-DESIGN-PRINCIPLE.md - collaboration model
• docs/WORKFLOW-GUIDE.md - current workflow guide for the shipped snapshot

License

MIT License. See LICENSE for details.