game-of-cards / site
llms.txt7 starsChanged 6 months agoMITView on GitHub
Agile for the age of agents — turn work into durable, inspectable cards that humans and LLMs can collaborate on. Game of Cards (GoC) is a repo-local methodology runtime built for swarms, not standups. Work lives in cards under .game-of-cards/deck/; agents pull, work, and close them autonomously; humans steer by curating the queue and resolving decision gates. The GoC plugin delivers all skills and hooks without requiring any checked-in files in the consuming repo. Install once per machine (run these…
In this repository19 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- advance-cardSkill
- audit-deckSkill
- card-schemaSkill
- claude-kickoffSkill
- create-cardSkill
- decide-cardSkill
- deckSkill
- finish-cardSkill
- kickoffSkill
- next-cardSkill
- pull-cardSkill
- refine-deckSkill
- retrospectiveSkill
- scan-deckSkill
- standupSkill
- tune-cadenceSkill
- upgradeSkill
The file
Files
# Game of Cards > Agile for the age of agents — turn work into durable, inspectable cards that humans and LLMs can collaborate on. Game of Cards (GoC) is a repo-local methodology runtime built for swarms, not standups. Work lives in cards under `.game-of-cards/deck/`; agents pull, work, and close them autonomously; humans steer by curating the queue and resolving decision gates. ## Install (Claude Code) The GoC plugin delivers all skills and hooks without requiring any checked-in files in the consuming repo. Install once per machine (run these slash commands inside Claude Code): ``` /plugin marketplace add zauberzeug/game-of-cards /plugin install game-of-cards@game-of-cards ``` **Updating after a new release — run this first:** ``` /plugin marketplace update zauberzeug/game-of-cards /plugin install game-of-cards@game-of-cards ``` Claude Code's `/plugin install` reuses a local marketplace clone and does not refresh it automatically. Skipping the `marketplace update` step installs from stale bytes even after an explicit reinstall. If `/plugin marketplace update` is not available, the equivalent round-trip is: ``` /plugin marketplace remove zauberzeug/game-of-cards /plugin marketplace add zauberzeug/game-of-cards /plugin install game-of-cards@game-of-cards ``` Once the plugin is installed, kick off any repo with: ``` /kickoff ``` or tell your agent: "use game of cards for this repo". ## Install (Codex) The GoC Codex plugin ships Codex-readable skills, optional lifecycle hooks, and a bundled engine mirror. Add this repository's marketplace, then install `game-of-cards` from Codex's `/plugins` browser: ```bash codex plugin marketplace add zauberzeug/game-of-cards ``` **Updating after a new release:** ```bash codex plugin marketplace update zauberzeug/game-of-cards ``` For local development against a checkout: ```bash codex plugin marketplace add ./path/to/game-of-cards ``` Plugin hooks are opt-in in the current Codex runtime. To enable the active-card reminder, prompt router, and pattern-generalization check, add: ```toml [features] plugin_hooks = true ``` Codex does not currently document plugin `bin/` auto-PATH behavior, so bare `goc` is not on PATH in a plugin-only install. The plugin ships `skills/_goc-bootstrap.sh`, which runs the bundled engine — in a plugin-only consumer repo, run `<plugin-root>/skills/_goc-bootstrap.sh <verb>`. If the plugin root is not obvious from the loaded skill path, find the helper with `find "$HOME/.codex/plugins/cache" -path '*/game-of-cards/*/skills/_goc-bootstrap.sh' -type f -perm -111`. Install the CLI with `pipx install game-of-cards` or `uv tool install game-of-cards` only when using vendored Codex skills without the plugin payload; inside this source repo, translate bare `goc ...` examples to `uv run goc ...`. ## Install (OpenClaw) The GoC [OpenClaw](https://openclaw.ai) plugin bundles the goc engine inside its npm payload — the only host prerequisite is `python3` (3.10+). `goc` is exposed as a **registered OpenClaw tool** (not a shell-PATH binary), so the agent invokes it like any typed function. Install via ClawHub: ```sh openclaw skills install game-of-cards ``` The same artifact is published to npm as `game-of-cards`; consumers that prefer npm can add it via OpenClaw's plugin loading mechanism (see <https://docs.openclaw.ai/plugins>). To run against an unreleased checkout instead, build from this repo's plugin payload at <https://github.com/zauberzeug/game-of-cards/tree/main/openclaw-plugin>. > **Known limitation (OpenClaw ≤ 2026.5.6):** spawned subagents do not see the `goc` tool because OpenClaw's plugin-tool allowlist for subagents ignores `tools.subagents.tools.alsoAllow`. Main sessions are unaffected. Upstream tracker: <https://github.com/openclaw/openclaw/pull/51388>. See the plugin README for workaround guidance. ## Install (other agent runtimes / CI) Install the `goc` CLI once per machine: ```bash pipx install game-of-cards # or: uv tool install game-of-cards ``` Initialize a repo (run from the project root): ```bash goc install ``` This creates `.game-of-cards/deck/`, `.game-of-cards/config.yaml`, and merges GoC guidance into `AGENTS.md` / `CLAUDE.md`. It writes no skill files for Claude Code, which loads them from the plugin. For OpenCode or another runtime that reads skills from `.claude/skills/`, run `goc install --agents claude --local-skills` instead to vendor them there. Full CLI reference: https://game-of-cards.com/goc/ ## Key concepts - **Cards** — markdown dirs under `.game-of-cards/deck/<title>/README.md` with YAML frontmatter (status, contribution, human_gate, definition_of_done). - **Human gate** — `none` lets agents work autonomously; `decision` or `session` parks the card until a human resolves it. - **Skills** — small markdown protocols the agent follows for each verb (`create-card`, `pull-card`, `finish-card`, …). - **Andon cord** — when an agent hits a decision-class question it cannot resolve locally, it raises the gate and parks, rather than guessing. ## Daily commands ```bash goc # open queue sorted by leverage goc --board # kanban board by status goc new rename-the-button # scaffold a new card goc status <title> active # claim a card goc done <title> # close after all DoD boxes are ticked goc validate # check frontmatter ``` ## More - CLI reference and install recipe: https://game-of-cards.com/goc/ - About the methodology: https://game-of-cards.com/about/ - GitHub: https://github.com/zauberzeug/game-of-cards
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

