# jnmetacode/superpowers-zh architecture

> Architecture diagram of the GitHub repository jnmetacode/superpowers-zh, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jnmetacode/superpowers-zh
- Repository: https://github.com/jnmetacode/superpowers-zh

## Overview

superpowers-zh packages Chinese-language development skills and makes them available across AI coding tools. A user asks a supported coding agent for work; the skills guide the agent through requirements, planning, implementation, and quality checks, or provide focused help such as debugging and Chinese team conventions. The installer detects tools and copies skills or generates tool-specific bootstrap instructions. README documents these workflows and integrations; sampled installer and adapter source is incomplete, so adapter-to-tool details are limited to documented support.

Main entry points: [`skills/using-superpowers`](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/using-superpowers) (Skill discovery), [`bin/superpowers-zh.js`](https://github.com/jnmetacode/superpowers-zh/blob/main/bin/superpowers-zh.js) (Installer CLI), [`skills/brainstorming`](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/brainstorming) (Brainstorming), [`skills/writing-plans`](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/writing-plans) (Writing plans)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Tool integration"]
  node_installer["Installer CLI<br/>[superpowers-zh.js]"]
  node_agent_adapters["Agent adapters"]
  node_opencode["OpenCode adapter<br/>[superpowers.js]"]
  node_pi["Pi adapter<br/>[superpowers.ts]"]
end

subgraph group_workflow["Development workflow"]
  node_skill_router["Skill discovery"]
  node_brainstorm["Brainstorming"]
  node_plans["Writing plans"]
  node_tdd["Test-driven development"]
  node_execute["Plan execution"]
  node_verify["Completion verification"]
  node_review["Code review"]
  node_debug["Systematic debugging"]
  node_parallel["Parallel agents"]
  node_subagent["Subagent development"]
  node_git["Git worktrees"]
  node_finish["Branch finishing"]
end

subgraph group_china["China-specific skills"]
  node_cn_review["Chinese code review"]
  node_cn_commit["Chinese commit conventions"]
  node_cn_docs["Chinese documentation"]
  node_mcp["MCP server building"]
  node_workflow_runner["Workflow runner"]
end

subgraph group_companion["Brainstorming companion"]
  node_visual["Visual companion"]
  node_server["Companion server<br/>[server.cjs]"]
  node_helper["Browser companion<br/>[helper.js]"]
end

node_developer(("Developer"))
node_agent(("AI coding agent"))

node_developer -->|"requests work"| node_agent
node_installer -->|"installs support"| node_agent_adapters
node_installer -->|"installs skills"| node_opencode
node_installer -->|"installs skills"| node_pi
node_agent -->|"discovers skills"| node_skill_router
node_skill_router -->|"selects skill"| node_brainstorm
node_brainstorm -->|"then plan"| node_plans
node_plans -->|"then test"| node_tdd
node_tdd -->|"then implement"| node_execute
node_execute -->|"then verify"| node_verify
node_verify -->|"then review"| node_review
node_skill_router -->|"selects skill"| node_debug
node_skill_router -->|"selects skill"| node_parallel
node_skill_router -->|"selects skill"| node_subagent
node_skill_router -->|"selects skill"| node_git
node_skill_router -->|"selects skill"| node_finish
node_skill_router -->|"selects skill"| node_cn_review
node_skill_router -->|"selects skill"| node_cn_commit
node_skill_router -->|"selects skill"| node_cn_docs
node_skill_router -->|"selects skill"| node_mcp
node_skill_router -->|"selects skill"| node_workflow_runner
node_brainstorm -->|"offers companion"| node_visual
node_visual -->|"starts server"| node_server
node_server -->|"serves browser helper"| node_helper

click node_installer "https://github.com/jnmetacode/superpowers-zh/blob/main/bin/superpowers-zh.js"
click node_agent_adapters "https://github.com/jnmetacode/superpowers-zh/tree/main/hooks"
click node_opencode "https://github.com/jnmetacode/superpowers-zh/blob/main/.opencode/plugins/superpowers.js"
click node_pi "https://github.com/jnmetacode/superpowers-zh/blob/main/.pi/extensions/superpowers.ts"
click node_skill_router "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/using-superpowers"
click node_brainstorm "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/brainstorming"
click node_plans "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/writing-plans"
click node_tdd "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/test-driven-development"
click node_execute "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/executing-plans"
click node_verify "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/verification-before-completion"
click node_review "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/requesting-code-review"
click node_debug "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/systematic-debugging"
click node_parallel "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/dispatching-parallel-agents"
click node_subagent "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/subagent-driven-development"
click node_git "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/using-git-worktrees"
click node_finish "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/finishing-a-development-branch"
click node_cn_review "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/chinese-code-review"
click node_cn_commit "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/chinese-commit-conventions"
click node_cn_docs "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/chinese-documentation"
click node_mcp "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/mcp-builder"
click node_workflow_runner "https://github.com/jnmetacode/superpowers-zh/tree/main/skills/workflow-runner"
click node_visual "https://github.com/jnmetacode/superpowers-zh/blob/main/skills/brainstorming/visual-companion.md"
click node_server "https://github.com/jnmetacode/superpowers-zh/blob/main/skills/brainstorming/scripts/server.cjs"
click node_helper "https://github.com/jnmetacode/superpowers-zh/blob/main/skills/brainstorming/scripts/helper.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_installer,node_agent_adapters,node_opencode,node_pi toneBlue
class node_skill_router,node_brainstorm,node_plans,node_tdd,node_execute,node_verify,node_review,node_debug,node_parallel,node_subagent,node_git,node_finish toneAmber
class node_cn_review,node_cn_commit,node_cn_docs,node_mcp,node_workflow_runner toneMint
class node_visual,node_server,node_helper toneRose
class node_developer,node_agent toneIndigo
```

## Components

### Tool integration

- [Installer CLI](https://github.com/jnmetacode/superpowers-zh/blob/main/bin/superpowers-zh.js): `bin/superpowers-zh.js`
- [Agent adapters](https://github.com/jnmetacode/superpowers-zh/tree/main/hooks): `hooks`
- [OpenCode adapter](https://github.com/jnmetacode/superpowers-zh/blob/main/.opencode/plugins/superpowers.js): `.opencode/plugins/superpowers.js`
- [Pi adapter](https://github.com/jnmetacode/superpowers-zh/blob/main/.pi/extensions/superpowers.ts): `.pi/extensions/superpowers.ts`

### Development workflow

- [Skill discovery](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/using-superpowers): `skills/using-superpowers`
- [Brainstorming](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/brainstorming): `skills/brainstorming`
- [Writing plans](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/writing-plans): `skills/writing-plans`
- [Test-driven development](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/test-driven-development): `skills/test-driven-development`
- [Plan execution](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/executing-plans): `skills/executing-plans`
- [Completion verification](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/verification-before-completion): `skills/verification-before-completion`
- [Code review](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/requesting-code-review): `skills/requesting-code-review`
- [Systematic debugging](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/systematic-debugging): `skills/systematic-debugging`
- [Parallel agents](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/dispatching-parallel-agents): `skills/dispatching-parallel-agents`
- [Subagent development](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/subagent-driven-development): `skills/subagent-driven-development`
- [Git worktrees](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/using-git-worktrees): `skills/using-git-worktrees`
- [Branch finishing](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/finishing-a-development-branch): `skills/finishing-a-development-branch`

### China-specific skills

- [Chinese code review](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/chinese-code-review): `skills/chinese-code-review`
- [Chinese commit conventions](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/chinese-commit-conventions): `skills/chinese-commit-conventions`
- [Chinese documentation](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/chinese-documentation): `skills/chinese-documentation`
- [MCP server building](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/mcp-builder): `skills/mcp-builder`
- [Workflow runner](https://github.com/jnmetacode/superpowers-zh/tree/main/skills/workflow-runner): `skills/workflow-runner`

### Brainstorming companion

- [Visual companion](https://github.com/jnmetacode/superpowers-zh/blob/main/skills/brainstorming/visual-companion.md): `skills/brainstorming/visual-companion.md`
- [Companion server](https://github.com/jnmetacode/superpowers-zh/blob/main/skills/brainstorming/scripts/server.cjs): `skills/brainstorming/scripts/server.cjs`
- [Browser companion](https://github.com/jnmetacode/superpowers-zh/blob/main/skills/brainstorming/scripts/helper.js): `skills/brainstorming/scripts/helper.js`

### Other components

- **Developer**
- **AI coding agent**

## Connections

- Developer → AI coding agent: requests work
- Installer CLI → Agent adapters: installs support
- Installer CLI → OpenCode adapter: installs skills
- Installer CLI → Pi adapter: installs skills
- AI coding agent → Skill discovery: discovers skills
- Skill discovery → Brainstorming: selects skill
- Brainstorming → Writing plans: then plan
- Writing plans → Test-driven development: then test
- Test-driven development → Plan execution: then implement
- Plan execution → Completion verification: then verify
- Completion verification → Code review: then review
- Skill discovery → Systematic debugging: selects skill
- Skill discovery → Parallel agents: selects skill
- Skill discovery → Subagent development: selects skill
- Skill discovery → Git worktrees: selects skill
- Skill discovery → Branch finishing: selects skill
- Skill discovery → Chinese code review: selects skill
- Skill discovery → Chinese commit conventions: selects skill
- Skill discovery → Chinese documentation: selects skill
- Skill discovery → MCP server building: selects skill
- Skill discovery → Workflow runner: selects skill
- Brainstorming → Visual companion: offers companion
- Visual companion → Companion server: starts server
- Companion server → Browser companion: serves browser helper