# OpenCode Superpowers Overview Implementation Plan

> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** Add one new blog post that summarizes `obra/superpowers` (OpenCode-first) + update the AI/OpenCode sidebar entry, matching this blog's writing style.

**Architecture:** One new Markdown article under `src/ai/` plus a small ordering update in `src/.vuepress/sidebar.ts`. Use upstream README as the source-of-truth for workflow + install commands.

**Tech Stack:** VuePress v2 + vuepress-theme-hope, Markdown, TypeScript config.

---

### Task 1: Gather upstream command strings + permalinks

**Files:**
- Read: `~/.config/opencode/superpowers/README.md`

- [ ] **Step 1: Get upstream repo HEAD SHA (for permalinks)**

Run:

```bash
git -C "$HOME/.config/opencode/superpowers" rev-parse HEAD
```

Expected: prints a 40-char SHA.

- [ ] **Step 2: Identify exact upstream snippets to copy**

From upstream `README.md`:

- Installation commands (Claude Code official + marketplace, Cursor, Codex, OpenCode, Gemini)
- Update command (Claude Code)
- Verify Installation paragraph
- Basic Workflow list

---

### Task 2: Create the new overview post

**Files:**
- Create: `src/ai/opencode-superpowers-overview.md`

- [ ] **Step 1: Add frontmatter + title + `<!-- more -->`**

Requirements:

- Chinese
- Major headings `## 一、二、三...`
- Use `---` thematic breaks between major sections

- [ ] **Step 2: Add sections per spec**

Include:

- What it is (1 screen)
- Upstream Basic Workflow (7 steps; step 4 includes "subagent-driven-development or executing-plans")
- Skill map (if/then) + links to existing posts:
  - `src/ai/opencode-superpowers.md`
  - `src/ai/opencode-skills-playbook.md`
- Install/Verify/Update quick reference with strict fenced-block counts:
  - 5 install blocks (Claude/Cursor/Codex/OpenCode/Gemini)
  - 1 verify block (2 lines)
  - 3 update blocks (Claude/OpenCode/Gemini)
  - Cursor + Codex updates as plain text notes (no fenced blocks)

---

### Task 3: Update sidebar order

**Files:**
- Modify: `src/.vuepress/sidebar.ts`

- [ ] **Step 1: Insert new link under AI -> OpenCode**

Insert before the existing:

- `text: "superpowers"`
- `link: "opencode-superpowers.md"`

New item:

- `text: "superpowers-总览"`
- `link: "opencode-superpowers-overview.md"`

Ensure final order:

1) `opencode.md`
2) `opencode-tui.md`
3) `opencode-superpowers-overview.md`
4) `opencode-superpowers.md`
5) `opencode-skills-playbook.md`

---

### Task 4: Verify build

**Files:**
- None

- [ ] **Step 1: Run production build**

Run:

```bash
npm run docs:build
```

Expected: `success VuePress build completed`.