From ad2c770e2b423c6ea524e101b22811cbfe020efd Mon Sep 17 00:00:00 2001 From: Jaco du Preez Date: Mon, 22 Jun 2026 20:27:50 +0200 Subject: [PATCH 1/3] chore: add superpowers paths to .gitignore --- .gitignore | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/.gitignore b/.gitignore index 90c608e..becae1c 100644 --- a/.gitignore +++ b/.gitignore @@ -11,6 +11,11 @@ opencode-config-verify.json production/session-logs/ production/session-state/ +# Superpowers SDK design docs (not part of OCGS) +.superpowers/ +docs/superpowers/ +framework/ + # Git worktrees .worktrees/ From 3fed0b8c0a10523738626886bb74385350839e58 Mon Sep 17 00:00:00 2001 From: Jaco du Preez Date: Mon, 22 Jun 2026 20:54:23 +0200 Subject: [PATCH 2/3] docs: add Pi awareness across README and framework docs --- CONTRIBUTING.md | 10 ++++- README.md | 59 ++++++++++++++++++---------- docs/CONTRIBUTING.md | 3 ++ docs/framework/quick-start.md | 32 +++++++++++++-- docs/framework/setup-requirements.md | 3 +- 5 files changed, 79 insertions(+), 28 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a1a73ed..708f86c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,14 +2,20 @@ Thanks for your interest in OpenCode Game Studios! +OpenCode Game Studios runs on both [OpenCode](https://opencode.ai) and [Pi](https://github.com/earendil-works/pi-coding-agent). + ## Quick Start +### OpenCode ```bash -git clone https://github.com/striderZA/OpenCodeGameStudios.git -cd OpenCodeGameStudios opencode ``` +### Pi +```bash +pi +``` + ## How to Contribute 1. **Open an issue** first — bug report or feature request diff --git a/README.md b/README.md index c40a73f..7de4f40 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ OpenCode Game Studios Banner

-> ⚡ Evolved from [Claude Code Game Studios (CCGS)](https://github.com/Donchitos/Claude-Code-Game-Studios) — now a standalone framework with workflow selection, phase gates, pre-workflow prototyping, and hybrid discovery-to-production pipelines. +> ⚡ Evolved from [Claude Code Game Studios (CCGS)](https://github.com/Donchitos/Claude-Code-Game-Studios) — now a standalone framework supporting both [OpenCode](https://opencode.ai) and [Pi](https://github.com/earendil-works/pi-coding-agent) coding agents. [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Agents](https://img.shields.io/badge/agents-51-blueviolet)](.agents/agents/) @@ -13,6 +13,7 @@ [![Hooks](https://img.shields.io/badge/plugins-3-orange)](.opencode/plugins/) [![Tests](https://img.shields.io/badge/tests-183-success)](tests/) [![Built for OpenCode](https://img.shields.io/badge/built%20for-OpenCode-5f5f5f)](https://opencode.ai) +[![Pi Compatible](https://img.shields.io/badge/Pi-compatible-4f46e5)](https://github.com/earendil-works/pi-coding-agent) --- @@ -56,7 +57,7 @@ for the full game lifecycle: `/concept-brainstorm` to `/launch-checklist` This project evolved from [CCGS](https://github.com/Donchitos/Claude-Code-Game-Studios) -and runs on [OpenCode](https://opencode.ai). +and runs on [OpenCode](https://opencode.ai) and [Pi](https://github.com/earendil-works/pi-coding-agent). --- @@ -68,25 +69,32 @@ and runs on [OpenCode](https://opencode.ai). ## 📊 Port Status -| Component | CCGS (Claude Code) | OpenCode | Status | -|-----------|-------------------|----------|--------| -| 🤖 **Agents** | 49 agents (`.claude/agents/`) | 51 agents (`.agents/agents/`) | ✅ | -| ⌨️ **Skills** | 72 skills (`.claude/skills/`) | 77 skills (`.agents/skills/`) | ✅ +5 | -| ⌨️ **Commands** | — | 54 commands (`.agents/commands/`) | ✅ New | -| 🔗 **Plugins** | 12 bash hooks (`.claude/hooks/`) | 3 TS plugins (`.opencode/plugins/`) | ✅ **183 tests** | -| 📏 **Rules** | 11 rule files (`.claude/rules/`) | 11 rule files (`.agents/rules/`) | ✅ | -| ⚙️ **Config** | `CLAUDE.md` + `.claude/settings.json` | `AGENTS.md` + `opencode.json` | ✅ | +| Component | CCGS (Claude Code) | OpenCode | Pi | Status | +|-----------|-------------------|----------|-----|--------| +| 🤖 **Agents** | 49 agents (`.claude/agents/`) | 51 agents (`.agents/agents/`) | 51 agents (`.agents/agents/`) | ✅ | +| ⌨️ **Skills** | 72 skills (`.claude/skills/`) | 77 skills (`.agents/skills/`) | 77 skills (`.agents/skills/`) | ✅ +5 | +| ⌨️ **Commands** | — | 54 commands (`.agents/commands/`) | → prompt templates | ✅ New | +| 🔗 **Plugins** | 12 bash hooks (`.claude/hooks/`) | 3 TS plugins (`.opencode/plugins/`) | 7 Pi extensions (`.pi/extensions/`) | ✅ **183 tests** | +| 📏 **Rules** | 11 rule files (`.claude/rules/`) | 11 rule files (`.agents/rules/`) | 11 rule files (`.agents/rules/`) | ✅ | +| ⚙️ **Config** | `CLAUDE.md` + `.claude/settings.json` | `AGENTS.md` + `opencode.json` | `AGENTS.md` + `pi.json` | ✅ | --- ## 🚀 Quick Start +### OpenCode ```bash opencode ``` - Type `/` to browse all 77 skills and 54 commands, or `/start` for onboarding. +### Pi +```bash +pi +``` +All OCGS skills, commands, and agents load automatically through Pi extensions. +See [docs/pi-compatibility.md](docs/pi-compatibility.md) for setup details. + ### 🎮 Demo Game See [**OCGS-Pong**](https://github.com/striderZA/OCGS-Pong) — a complete Pong game built entirely with this toolchain. Demonstrates the full workflow from concept through implementation using OCGS agents and skills. @@ -150,8 +158,7 @@ all game development sessions: | [**dynamic-context-purging**](https://github.com/Opencode-DCP/opencode-dynamic-context-pruning)| Dynamic context pruning — automatically manages context window size, indexes content for search, and prevents context overflow during long sessions | | [**Superpowers**](https://github.com/obra/superpowers) | Enhanced skill library — provides structured workflows for brainstorming, test-driven development, writing plans, code review, and parallel agent dispatch | -Add them to your `opencode.json`: - +**OpenCode:** Add to your `opencode.json`: ```json { "plugin": [ @@ -161,18 +168,21 @@ Add them to your `opencode.json`: } ``` +**Pi:** OCGS Pi extensions are bundled in `.pi/extensions/` and auto-discovered +on startup. See [docs/pi-extensions.md](docs/pi-extensions.md) for details. + --- ## 🗺️ Key Mappings -| CCGS (Claude Code) | OpenCode | -|--------------------|----------| -| `.claude/skills/*.md` → | `.agents/skills/*.md` | -| `.claude/agents/*.md` → | `.agents/agents/*.md` | -| `.claude/hooks/*.sh` → | `.opencode/plugins/ccgs-hooks.ts` | -| `.claude/rules/*.md` → | `.agents/rules/*.md` | -| `CLAUDE.md` → | `AGENTS.md` | -| `.claude/settings.json` → | `opencode.json` | +| CCGS (Claude Code) | OpenCode | Pi | +|--------------------|----------|-----| +| `.claude/skills/*.md` → | `.agents/skills/*.md` | `.agents/skills/*.md` | +| `.claude/agents/*.md` → | `.agents/agents/*.md` | `.agents/agents/*.md` | +| `.claude/hooks/*.sh` → | `.opencode/plugins/ccgs-hooks.ts` | `.pi/extensions/` | +| `.claude/rules/*.md` → | `.agents/rules/*.md` | `.agents/rules/*.md` | +| `CLAUDE.md` → | `AGENTS.md` | `AGENTS.md` | +| `.claude/settings.json` → | `opencode.json` | `pi.json` | --- @@ -255,6 +265,7 @@ node utils/assign-models.js --config my-models.json / ├── AGENTS.md 📋 Project configuration ├── opencode.json ⚙️ OpenCode config (permissions, plugins) +├── pi.json ⚙️ Pi config (MCP, settings) ├── .agents/ 📦 Canonical content (harness-agnostic) │ ├── agents/ 🤖 51 agent definitions │ ├── skills/ 🛠️ 77 skill workflows @@ -277,10 +288,16 @@ node utils/assign-models.js --config my-models.json │ ├── installed.json Module manifest │ └── ... 21 module sources ├── design/ 🎨 Game design documents +├── .pi/ ⚙️ Pi-specific extensions & settings +│ └── extensions/ 🧩 Pi extensions (ocgs-core, delegation, question, etc.) ├── docs/ │ ├── CONTRIBUTING.md 📖 Framework contribution guide │ ├── authoring-agents.md 🤖 Agent authoring guide │ ├── authoring-skills.md 🛠️ Skill authoring guide +│ ├── pi-compatibility.md 🔧 Pi setup guide +│ ├── pi-extensions.md 🧩 Pi extension reference +│ ├── pi-workflow.md 🔄 Pi workflow differences +│ ├── framework/ 🏛️ OCGS framework reference docs & templates │ ├── architecture/ 🏗️ ADRs │ └── engine-reference/ 📚 Engine API reference ├── tests/ diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 83f1781..6a1713e 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -4,6 +4,9 @@ This guide covers how to add, modify, and maintain the OCGS framework — agents, skills, commands, rules, and plugins. If you're building a game (rather than the framework), see `README.md` instead. +The framework supports both [OpenCode](https://opencode.ai) and [Pi](https://github.com/earendil-works/pi-coding-agent) coding agents. +See `docs/pi-compatibility.md` for Pi-specific setup. + ## Table of Contents 1. [Framework Architecture](#framework-architecture) diff --git a/docs/framework/quick-start.md b/docs/framework/quick-start.md index 42a4061..ae941bb 100644 --- a/docs/framework/quick-start.md +++ b/docs/framework/quick-start.md @@ -2,7 +2,12 @@ ## What Is This? -This is a complete OpenCode agent architecture for game development. It +# Game Studio Agent Architecture -- Quick Start Guide + +## What Is This? + +This is a complete agent architecture for game development, supporting both +[OpenCode](https://opencode.ai) and [Pi](https://github.com/earendil-works/pi-coding-agent). It organizes 48 specialized AI agents into a studio hierarchy that mirrors real game development teams, with defined responsibilities, delegation rules, and coordination protocols. It includes engine-specialist agents @@ -232,7 +237,7 @@ If you already know what you need, jump directly to the relevant path: # In Unity: Window → Package Manager → + → Add package from git URL # Paste: https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main ``` - Then add the `mcp.unity` block to your `opencode.json` and set + Then add the `mcp.unity` block to your MCP config (`opencode.json` for OpenCode, `pi.json` for Pi) and set `enabled: true` once Unity Editor is running. See `/setup-engine` §7.4 for full details. 5. **Validate the concept** — Run `/design-review design/gdd/game-concept.md` @@ -284,6 +289,24 @@ If you have design docs, prototypes, or code already: The framework is partitioned into **theme modules**. Only install what you need: +```bash +## Installation + +### OpenCode +```bash +opencode +``` +Type `/` to browse all skills and commands, or `/start` for onboarding. + +### Pi +```bash +pi +``` +All OCGS skills, commands, and agents load automatically through Pi extensions. +See `docs/pi-compatibility.md` for full setup. + +### Install Modules + ```bash node .opencode/modules/install.mjs add core # Required: directors, /start, /help node .opencode/modules/install.mjs add engine-godot # Engine specialists (or engine-unity/engine-unreal) @@ -299,8 +322,9 @@ Available modules: art, design, architecture, stories, programming, ui, audio, n ``` AGENTS.md -- Master config (read this first) -.opencode/ - (opencode.json at root) -- OpenCode settings and plugin configuration +.opencode/ (opencode.json at root) -- OpenCode settings & plugin config +.pi/ (pi.json at root) -- Pi MCP & settings + extensions/ -- 7 Pi extensions (auto-discovered) agents/ -- Agent definitions (YAML frontmatter) skills/ -- Skill definitions (YAML frontmatter) plugins/ -- TypeScript hooks plugin (ccgs-hooks.ts) diff --git a/docs/framework/setup-requirements.md b/docs/framework/setup-requirements.md index 3eebde8..556d69f 100644 --- a/docs/framework/setup-requirements.md +++ b/docs/framework/setup-requirements.md @@ -11,7 +11,8 @@ you'll lose validation features. | Tool | Purpose | Install | | ---- | ---- | ---- | | **Git** | Version control, branch management | [git-scm.com](https://git-scm.com/) | -| **OpenCode** | AI agent CLI | `npm install -g opencode` | +| **OpenCode** | AI agent CLI (via OpenCode) | `npm install -g opencode` | +| **Pi** | AI agent CLI (via Pi) | `npm install -g @earendil-works/pi-coding-agent` | | **Node.js 18+** | Module CLI + hooks | Runtime for `install.mjs` and the CCGS TypeScript hooks plugin | [nodejs.org](https://nodejs.org/) | ## Recommended From 57d062a277f394f2a79ee4f9d9d963ba90463880 Mon Sep 17 00:00:00 2001 From: Jaco du Preez Date: Tue, 23 Jun 2026 20:38:34 +0200 Subject: [PATCH 3/3] chore: prepare v0.10.2 --- CHANGELOG.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index f4a1cee..5936d95 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 --- +## [v0.10.2] — 2026-06-22 + +### Changed + +- **Pi docs**: Updated README.md, CONTRIBUTING.md, framework quick-start, and setup-requirements + to document Pi alongside OpenCode as a supported harness +- **Gitignore**: Added `.superpowers/`, `docs/superpowers/`, and `framework/` paths + +### Housekeeping + +- Purged `docs/superpowers/` and `framework/` from git history (11 design docs, ~352KB) +- Removed superpowers reference from CHANGELOG + ## [v0.10.1] — 2026-06-22 ### Changed