convez.ai
AgenteProdutividadeIntermediário
Ghraven

Claude Code Solo Studio

Ghraven/Claude-Code-Solo-Studio

6 agentes, zero overhead — 95% de tokens para código de jogo

Ver no GitHub
BomPluginScore · de 0 a 100

Template otimizado para game devs solo que trabalham com Claude Code, reduzindo overhead de tokens através de 6 agentes especializados sem hierarquia e 10 comandos práticos. Suporta Godot 4 e Unity com setup automático baseado em plataforma, dimensão e gênero.

Instalação

$npx convez-ai Ghraven/Claude-Code-Solo-Studio

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
1
Saúde
71%
Último commit
há 2 meses
Versão
v1.3.0
Issues abertas
1
Contribuidores
1

Casos de uso

  • Desenvolvimento de jogos 2D/3D indie com orçamento de tokens limitado
  • Prototipagem rápida com setup automático por plataforma e gênero
  • Code review, QA e otimização de performance em projeto solo

Veredito

Solução prática que inverte o problema usual de templates multi-agente (overhead de coordenação) focando em maximizar tokens para código real. Bem estruturado para o caso específico de devs solo com limites semanais de API, embora exija familiaridade com Claude Code e engines de jogo.

README

A tradução para o português deste README ainda está na fila.

v1.2 — Session-stop hook now warns about uncommitted changes. GDD gains a monetization section for mobile devs. game-designer gets mobile interruption design guidance. new-feature skill scans Known Issues before starting work. qa-check cross-references Known Issues to avoid duplicate bug reports.


The Problem

Most AI coding templates burn your token budget on coordination before a single line of code gets written. 49 agents debating with directors and leads just to decide what to do next works great for a studio with unlimited API credits.

For a solo dev on a weekly limit, it burns your cap with nothing to show.


The Solution

This template strips everything down to what actually matters:

Typical multi-agentSolo Studio
Agents20–496
HierarchyDirector → Lead → WorkerNone — direct specialists
Inter-agent callsConstantZero
Slash commands20+10 practical ones
Token overheadHighNear zero
Token budget going to code~30–50%~95%

6 specialists. No hierarchy. No coordination overhead. Nearly 100% of your tokens go to actual game code.


Quick Start

Prerequisites

  • Claude Code — npm install -g @anthropic-ai/claude-code
  • Godot 4 or Unity installed
  • Git

Setup

git clone https://github.com/Ghraven/Claude-Code-Solo-Studio my-game
cd my-game
claude

Then in Claude Code:

/setup

Answer 4 questions. Your project is ready in seconds.


/setup — What It Does

The setup command asks:

  1. Platform — Android · PC · Web
  2. Dimension — 2D · 3D
  3. Genre — Platformer · RPG · Puzzle · Shooter · Other
  4. Engine — Godot 4 · Unity (with a tip card to help you choose)

Then generates in one shot:

  • CLAUDE.md filled with your project config
  • Full folder structure (src/ · assets/ · design/ · docs/ · tests/)
  • Starter scene and script files for your engine
  • design/gdd.md — Game Design Document stub ready to fill in

Slash Commands

CommandWhat it does
/setupInitialize project — platform · genre · engine · starter files
/new-featureStart a feature (breaks into max 5 focused tasks)
/level-designDesign a level with scene structure
/ui-designDesign a menu · HUD · screen
/code-reviewReview code for bugs, engine-specific patterns, quality
/qa-checkFull quality check before moving on
/bug-reportLog a bug with severity, diagnosis, and regression test
/performanceProfiling check, bottleneck diagnosis, and optimization strategy
/buildExport/build checklist for your target platform
/statusSprint snapshot — tasks, open bugs, next focus
/helpShow all commands with descriptions

Agents

Use agents when you want deep focused work on a single domain. Slash commands handle most everyday tasks — agents are for when you need a specialist to go all-in on one area.

AgentUse for
game-designerMechanics · balancing · GDD updates
programmerAll code — GDScript or C#
level-designerLevel layouts · scene structure
ui-designerMenus · HUD · screen design
qaCode review · bugs · test cases
releaseBuilds · exports · versioning

Every agent reads CLAUDE.md for project context — no re-explaining your engine, platform, or genre every session.


Project Structure

my-game/
├── CLAUDE.md                Your project brain — update this as you build
├── .claude/
│   ├── agents/              6 specialist agent prompts
│   ├── skills/              10 slash commands
│   ├── hooks/               3 hooks (session start/stop, commit check)
│   └── settings.json        Hook wiring and permissions
├── design/
│   └── gdd.md               Game Design Document
├── src/                     Game source code
├── assets/                  Art · audio · fonts
├── docs/                    Technical notes
└── tests/                   Test cases

How the Token Efficiency Works

Agents don't talk to each other. Each one has full context baked into its prompt and reads CLAUDE.md for project state. There's no coordination layer, no approval chains, no "consulting" step.

You stay in control. Claude starts coding immediately.

  • Hooks only fire when relevant (commit hook exits instantly if not a commit)
  • CLAUDE.md carries context across sessions — no context re-setup
  • Specialists go straight to work — no meta-discussion about what to build

Customization

Everything is plain Markdown — edit freely:

# Add a new agent
touch .claude/agents/my-agent.md

# Edit a slash command
nano .claude/skills/new-feature/prompt.md

# Add a hook
touch .claude/hooks/my-hook.sh
# Wire it in .claude/settings.json

The default Claude Code permissions allow common read-only navigation tools, including rg, so agents can search the project quickly without broad shell access.


Credits

Inspired by Claude-Code-Game-Studios by Donchitos.
Rebuilt from scratch for solo devs on limited API budgets.


Contributing

See CONTRIBUTING.md — adding a slash command or agent is straightforward.

Changelog

See CHANGELOG.md for release history.



AI Assistance Transparency

I use AI-assisted development tools, including Codex and Claude, while building and maintaining this project. All code, design decisions, testing, commits, and releases are reviewed and shipped by me as the repository owner; AI tools are not listed as project contributors.

License

MIT — see LICENSE

Ver o original no GitHub

Bom para

Relacionados