# programming-architecture

The programming-architecture skill guides game-system architecture with patterns for states, events, and commands. Use it when gameplay logic is growing harder to organize or test.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 110 installs · ★ 56 repo stars
- Author: pluginagentmarketplace
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pluginagentmarketplace/custom-plugin-game-developer/tree/HEAD/skills/programming-architecture/SKILL.md
- Updated: 2026-01-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/programming-architecture

## What it does

The skill gives C# examples of a state machine for characters and game flow, an object pool for bullets and particles, events for UI updates and damage notifications, and commands that can undo actions. It also divides a game project into game and engine layers, with managers, systems, and components inside the game layer.

For system boundaries, it recommends dependency injection and event-based communication instead of direct references. It also covers separating logic from `MonoBehaviour`, using interfaces for dependencies, and writing pure functions that are easier to test. The examples use C# and Unity APIs, so projects on another stack will need adapted implementations.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill programming-architecture -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/programming-architecture/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/programming-architecture/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill programming-architecture -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/programming-architecture/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill programming-architecture -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/programming-architecture/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pluginagentmarketplace/custom-plugin-game-developer skills/programming-architecture
```

2. **Manually: put the files in place**
- File: `.github/skills/programming-architecture/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill programming-architecture -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pluginagentmarketplace/custom-plugin-game-developer --path skills/programming-architecture
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/programming-architecture/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-game-developer --skill programming-architecture -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pluginagentmarketplace/custom-plugin-game-developer/tree/HEAD/skills/programming-architecture/SKILL.md

## When to use it
- model character behavior as distinct states
- reuse objects for bullets and particles
- notify the UI when game events change
- support undo through command objects
- make game systems easier to test

## Example prompts
- Design a C# state machine for my character and show how it switches between states.
- Suggest an event setup for updating the score and health UI.
- Separate this game logic from `MonoBehaviour` so I can test it.

## Similar
- [shader-programming](https://affpapa.org/en/nevibecode/skills/shader-programming.md) — skill · 13300 installs
- [remember-interactive-programming](https://affpapa.org/en/nevibecode/skills/remember-interactive-programming.md) — skill · 9000 installs
- [Pair Programming](https://affpapa.org/en/nevibecode/skills/pair-programming.md) — skill · 1200 installs
- [reactive-programming](https://affpapa.org/en/nevibecode/skills/reactive-programming.md) — skill · 498 installs
- [rust-systems-programming](https://affpapa.org/en/nevibecode/skills/rust-systems-programming.md) — skill · 489 installs
- [142-java-functional-programming](https://affpapa.org/en/nevibecode/skills/142-java-functional-programming.md) — skill · 399 installs

From the same set: [pluginagentmarketplace/custom-plugin-game-developer](https://affpapa.org/en/nevibecode/by/pluginagentmarketplace/custom-plugin-game-developer.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
