superpowers-zh 1.5.0 → 1.7.0

package/docs/README.antigravity.md

@@ -9,14 +9,14 @@ cd /your/project
 npx superpowers-zh
 ```
 
-安装脚本会自动检测 `.antigravity/` 目录并将 skills 复制到该目录。
+安装脚本会自动检测 `.agents/` 目录并将 skills 复制到该目录。
 
 ## 手动安装
 
 ```bash
 git clone https://github.com/jnMetaCode/superpowers-zh.git
-mkdir -p /your/project/.antigravity/skills
-cp -r superpowers-zh/skills/* /your/project/.antigravity/skills/
+mkdir -p /your/project/.agents/skills
+cp -r superpowers-zh/skills/* /your/project/.agents/skills/
 ```
 
 ## 工作原理
@@ -27,7 +27,7 @@ Antigravity 支持多种规则文件格式：
 |------|--------|------|
 | `GEMINI.md` | 最高 | Antigravity 专属规则 |
 | `AGENTS.md` | 中 | 通用规则（Antigravity、Cursor、Claude Code 共享） |
-| `.antigravity/rules.md` | 中 | 项目级规则目录 |
+| `.agents/rules.md` | 中 | 项目级规则目录 |
 | `CLAUDE.md` | 低 | 也会被自动读取 |
 
 ### 推荐配置方式
@@ -37,10 +37,10 @@ Antigravity 支持多种规则文件格式：
 ```markdown
 # GEMINI.md
 
-使用 .antigravity/ 目录下的 superpowers skills 来指导工作流程。
+使用 .agents/ 目录下的 superpowers skills 来指导工作流程。
 优先使用 brainstorming（头脑风暴）开始新任务。
 
-Skills 列表参见 .antigravity/ 目录。
+Skills 列表参见 .agents/ 目录。
 ```
 
 **方式二**：在 `AGENTS.md` 中引用（多工具共享）：
@@ -49,7 +49,7 @@ Skills 列表参见 .antigravity/ 目录。
 # AGENTS.md
 
 本项目使用 superpowers-zh skills 框架。
-Skills 位于 .antigravity/（Antigravity）或 .claude/skills/（Claude Code）目录下。
+Skills 位于 .agents/（Antigravity）或 .claude/skills/（Claude Code）目录下。
 ```
 
 ### 工具映射

package/docs/README.codearts.md

@@ -0,0 +1,49 @@
+# 华为云码道 CodeArts 使用指南
+
+[华为云码道 CodeArts（CodeArts Doer / Snap）](https://www.huaweicloud.com/product/codeartsdoer.html)是华为云出品的 AI 编程助手，支持 CLI、客户端以及 IntelliJ IDEA / VS Code 插件形态。skills 存放在项目的 `.codeartsdoer/skills/` 目录下。
+
+## 一键安装（推荐）
+
+在你的项目根目录运行：
+
+```bash
+npx superpowers-zh
+```
+
+自动检测到 `.codeartsdoer/` 时会安装到 CodeArts。检测不到时显式指定：
+
+```bash
+npx superpowers-zh --tool codearts
+```
+
+安装内容：
+
+- `.codeartsdoer/skills/` — 20 个 skill（每个含 `SKILL.md` 及其 `scripts/` 等附属文件）
+
+## Skill 加载优先级
+
+| 位置 | 说明 |
+|------|------|
+| `.codeartsdoer/skills/` | 项目级，仅当前项目 |
+
+## ⚠️ 关于自动触发
+
+本适配为 **skills-only**：把 skills 放到 `.codeartsdoer/skills/`，依赖 CodeArts 自身的 skill 发现机制加载。
+
+- 如果 CodeArts 会自动扫描并按需触发 `.codeartsdoer/skills/` 下的 skill，则装完重启即可生效。
+- 如果发现**不会自动触发**，可以在对话里**手动点名** skill（例如「用 brainstorming skill 做需求分析」），skill 内容依然可用。
+
+> CodeArts 的 bootstrap / 指令文件约定（类似 `CLAUDE.md` 的自动引导文件）我们尚未验证。如果你是 CodeArts 用户、了解它读取哪个指令文件来自动加载规则，欢迎在 [issue #20](https://github.com/jnMetaCode/superpowers-zh/issues/20) 反馈，我们会补上自动触发的 bootstrap 生成。
+
+## 卸载
+
+```bash
+npx superpowers-zh --uninstall
+```
+
+移除 `.codeartsdoer/skills/` 下由 superpowers-zh 安装的 skill 目录。
+
+## 反馈
+
+- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
+- 项目主页：https://github.com/jnMetaCode/superpowers-zh

package/docs/README.codebuddy.md

@@ -0,0 +1,54 @@
+# CodeBuddy 使用指南
+
+[CodeBuddy](https://copilot.tencent.com)（腾讯云 AI 编程助手 / AI IDE）加载 superpowers-zh skills 的方式与 Claude Code 类似：项目根目录的 `CODEBUDDY.md` 作为 bootstrap 引导，skills 放在 `.codebuddy/skills/` 下。
+
+## 一键安装（推荐）
+
+在你的项目根目录运行：
+
+```bash
+npx superpowers-zh
+```
+
+自动检测到 `.codebuddy/` 或 `CODEBUDDY.md` 时会安装到 CodeBuddy。检测不到时显式指定：
+
+```bash
+npx superpowers-zh --tool codebuddy
+```
+
+安装内容：
+
+- `.codebuddy/skills/` — 20 个 skill（每个含 `SKILL.md`）
+- `CODEBUDDY.md` — bootstrap 引导（已存在则在哨兵注释间追加，不覆盖你的内容）
+
+## Skill 加载优先级
+
+| 位置 | 说明 |
+|------|------|
+| `.codebuddy/skills/` | 项目级，仅当前项目 |
+
+> 目前仅支持项目级安装。CodeBuddy 的用户级（全局）skills 加载路径尚未验证，确认可行后再补 `--global` 支持。
+
+## 使用
+
+1. 安装完成后**重启 CodeBuddy**。
+2. CodeBuddy 读取 `CODEBUDDY.md` 后，会在任务匹配某个 skill 的触发条件时，读取对应的 `.codebuddy/skills/<skill-name>/SKILL.md` 并遵循其流程。
+3. 当任务涉及需求分析、TDD、系统化调试、代码审查等场景时，对应 skill 会被引用。
+
+## 卸载
+
+```bash
+npx superpowers-zh --uninstall
+```
+
+移除 `.codebuddy/skills/` 下的 skills，并按哨兵注释精确切除 `CODEBUDDY.md` 里的 superpowers-zh 段落（不误删你自己的内容）。
+
+## 故障排查
+
+- **skills 没生效**：确认已重启 CodeBuddy；确认 `CODEBUDDY.md` 里存在 `# Superpowers-ZH 中文增强版` 段落。
+- **自动检测不到**：用 `npx superpowers-zh --tool codebuddy` 显式指定。
+
+## 反馈
+
+- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
+- 项目主页：https://github.com/jnMetaCode/superpowers-zh

package/docs/README.kimi.md

@@ -0,0 +1,86 @@
+# Superpowers 中文版 · Kimi Code 指南
+
+在 [Kimi Code](https://github.com/MoonshotAI/kimi-code) 上使用 superpowers-zh 的完整说明。
+
+## 安装
+
+superpowers-zh 通过 Kimi Code 的插件清单 `.kimi-plugin/plugin.json` 集成，**直接指向仓库现有的 `skills/` 目录**——不复制 skill、不建 symlink、不装 hook、无任何运行时依赖。
+
+打开插件管理器：
+
+```text
+/plugins
+```
+
+如果 Kimi 插件市场已收录，进入 `Marketplace` > `Superpowers 中文版` 安装即可。
+
+也可以直接从本仓库安装：
+
+```text
+/plugins install https://github.com/jnMetaCode/superpowers-zh
+```
+
+如需验证尚未发布的改动，显式指定分支：
+
+```text
+/plugins install https://github.com/jnMetaCode/superpowers-zh/tree/main
+```
+
+Kimi Code 在**新会话**才会应用插件变更。安装、更新、启用、禁用或重载插件后，用 `/new` 开一个新会话。
+
+## 工作原理
+
+Kimi 插件清单位于 `.kimi-plugin/plugin.json`，做三件事：
+
+1. 把 Kimi Code 指向仓库现有的 `skills/` 目录；
+2. 通过 `sessionStart.skill` 在会话开始时加载 `using-superpowers`（这是让 skill 在恰当时机自动触发的关键）；
+3. 通过 `skillInstructions` 提供 Kimi 专属的工具映射。
+
+## 工具映射
+
+skill 内容描述的是「动作」而非写死某个运行时的工具名。在 Kimi Code 上它们对应到：
+
+- 「向用户提问」/「问澄清问题」/「给出多选项」→ `AskUserQuestion`
+- 「创建待办」/「在待办清单中标记完成」→ `TodoList`
+- 「分派子智能体」/「Task tool (general-purpose)」→ `Agent`（用 Kimi 的 subagent 类型，如 `coder`/`explore`/`plan`，**不要**传 `general-purpose`）
+- 「调用某个 skill」→ Kimi Code 原生 `Skill` 工具
+- 「读文件」/「写文件」/「改文件」→ `Read` / `Write` / `Edit`
+- 「跑 shell 命令」→ `Bash`
+- 「搜索文件内容」→ `Grep`
+- 「按路径/模式找文件」→ `Glob`
+- 「抓取 URL」→ `FetchURL`
+- 「联网搜索」→ `WebSearch`
+
+完整映射写在清单的 `skillInstructions` 字段里，由 Kimi 在运行时读取。
+
+## 更新
+
+用 Kimi Code 的插件管理器：
+
+```text
+/plugins
+```
+
+选中 Superpowers 中文版更新，更新后用 `/new` 开新会话。
+
+## 排错
+
+### 插件没加载
+
+1. 跑 `/plugins info superpowers-zh` 看诊断信息；
+2. 确认插件已启用；
+3. 安装或更新后用 `/new` 开新会话。
+
+### 直接 GitHub 安装装到了旧版本
+
+对于裸仓库 URL，Kimi Code 会装最新的 GitHub release（若存在）。要在下一个 release 前测试未发布的改动，显式指定分支：
+
+```text
+/plugins install https://github.com/jnMetaCode/superpowers-zh/tree/main
+```
+
+### skill 不触发
+
+1. 用 `/plugins info superpowers-zh` 确认插件已启用；
+2. 用 `/new` 开新会话；
+3. 试验收提示词：`我们来做个 react todo list`。集成正常的话，会在写任何代码之前先加载 `brainstorming`。

package/docs/README.pi.md

@@ -0,0 +1,54 @@
+# Superpowers 中文版 · Pi 指南
+
+在 [Pi](https://github.com/earendil-works/pi)（oh-my-pi）上使用 superpowers-zh 的完整说明。
+
+## 安装
+
+superpowers-zh 通过 Pi 的扩展机制集成，**直接指向仓库现有的 `skills/` 目录**——不复制 skill、不建 symlink、无额外运行时依赖。
+
+集成由 `package.json` 里的 `pi` 字段声明：
+
+```json
+"pi": {
+  "skills": ["./skills"],
+  "extensions": ["./.pi/extensions/superpowers.ts"]
+}
+```
+
+并带 `pi-package` keyword，便于 Pi 发现这是一个 Pi 包。
+
+按 Pi 的包安装方式安装 `superpowers-zh`（参考 Pi 文档的包管理命令），Pi 会读取上述 `pi` 配置，挂载 `skills/` 并加载 `.pi/extensions/superpowers.ts` 扩展。
+
+## 工作原理
+
+`.pi/extensions/superpowers.ts` 注册了 Pi 的生命周期钩子：
+
+1. **`resources_discover`** — 把仓库的 `skills/` 目录贡献给 Pi 的技能系统；
+2. **`session_start` / `session_compact`** — 标记需要重新注入 bootstrap；
+3. **`context`** — 在会话上下文中注入 `using-superpowers` 的内容（去除 frontmatter）+ Pi 工具映射，作为「You have superpowers」bootstrap，让 skill 在恰当时机被遵循；
+4. **`agent_end`** — 一轮结束后停止重复注入。
+
+注入带有唯一标记，已存在时不会重复注入；并且会插入到 compaction summary 之后，避免被压缩流程吞掉。
+
+## 工具映射
+
+Pi 有原生技能系统，但**不暴露** `Skill` 工具。skill 内容描述「动作」，在 Pi 上对应到小写工具：
+
+- 「调用某个 skill」→ Pi 原生技能：用 `read` 加载对应 `SKILL.md`，或由人类显式 `/skill:name`
+- 「读/写/改文件」→ `read` / `write` / `edit`
+- 「跑 shell 命令」→ `bash`
+- 「搜索文件内容」→ `grep`，「按名找文件」→ `find`，「列目录」→ `ls`
+- 「分派子智能体」→ 若装了 `pi-subagents` 的 `subagent` 工具则用之；没有则在本会话内完成或说明能力缺失，**不要**臆造 `Task` 调用
+- 「待办清单」→ 若装了 todo/task 工具则用之；否则用 plan 文件或仓库内 `TODO.md` 跟踪；旧的 `TodoWrite` 引用按此处理
+
+完整映射见 [`skills/using-superpowers/references/pi-tools.md`](../skills/using-superpowers/references/pi-tools.md)，扩展也会把同样的映射注入会话。
+
+## 验证
+
+```bash
+bash tests/pi/run-tests.sh
+```
+
+该测试动态加载扩展并校验：声明了 `pi` 包配置、注册了正确的生命周期钩子（且无 pre-compaction 注入）、`resources_discover` 贡献了 `skills/` 目录、`session_start` 注入了「You have superpowers」+「Pi tool mapping」、pi-tools 参考文档存在。
+
+> 注：扩展是 TypeScript（仅 `import type`，运行时无类型依赖）。Node 22.6–23.5 需 `--experimental-strip-types`（run-tests.sh 已带），23.6+ 默认支持。

package/docs/README.trae.md

@@ -9,16 +9,18 @@ cd /your/project
 npx superpowers-zh
 ```
 
-安装脚本会自动检测 `.trae/` 目录并将 skills 复制到 `.trae/rules/`。
+安装脚本会自动检测 `.trae/` 目录，将各 skill 完整复制到 `.trae/skills/`（含 `SKILL.md` 及其 `scripts/` 等附属文件），并在 `.trae/rules/superpowers-zh.md` 生成一份 bootstrap 规则用于自动触发。
 
 ## 手动安装
 
 ```bash
 git clone https://github.com/jnMetaCode/superpowers-zh.git
-mkdir -p /your/project/.trae/rules
-cp -r superpowers-zh/skills/* /your/project/.trae/rules/
+mkdir -p /your/project/.trae/skills
+cp -r superpowers-zh/skills/* /your/project/.trae/skills/
 ```
 
+> 手动复制只会放好 skill 文件，不会生成 `.trae/rules/` 下的 bootstrap 自动触发规则。建议优先用上面的 `npx superpowers-zh`，否则需要在对话里手动点名 skill 才会激活。
+
 ## 工作原理
 
 Trae 使用 `.rules` 机制管理 AI 行为：
@@ -32,7 +34,7 @@ Trae 使用 `.rules` 机制管理 AI 行为：
 
 ### Skills 适配
 
-superpowers-zh 的 SKILL.md 文件可以直接作为 Trae 的 rules 使用。Trae 会在初始化时加载 `.trae/rules/` 下的所有规则文件。
+安装器把各 skill 放在 `.trae/skills/<skill-name>/`，并在 `.trae/rules/superpowers-zh.md` 写入一份 bootstrap 规则。Trae 初始化时加载 `.trae/rules/` 下的规则，bootstrap 规则会引导 AI 在任务匹配时读取对应的 `.trae/skills/<skill-name>/SKILL.md` 并遵循其流程。
 
 ### 推荐配置
 

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "superpowers-zh",
   "description": "AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "contextFileName": "GEMINI.md"
 }

package/hooks/session-start

@@ -7,13 +7,6 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
 
-# Check if legacy skills directory exists and build warning
-warning_message=""
-legacy_skills_dir="${HOME}/.config/superpowers/skills"
-if [ -d "$legacy_skills_dir" ]; then
-    warning_message="\n\n<important-reminder>IN YOUR FIRST REPLY AFTER SEEING THIS MESSAGE YOU MUST TELL THE USER:⚠️ **WARNING:** Superpowers now uses Claude Code's skills system. Custom skills in ~/.config/superpowers/skills will not be read. Move custom skills to ~/.claude/skills instead. To make this message go away, remove ~/.config/superpowers/skills</important-reminder>"
-fi
-
 # Read using-superpowers content
 using_superpowers_content=$(cat "${PLUGIN_ROOT}/skills/using-superpowers/SKILL.md" 2>&1 || echo "Error reading using-superpowers skill")
 
@@ -31,8 +24,7 @@ escape_for_json() {
 }
 
 using_superpowers_escaped=$(escape_for_json "$using_superpowers_content")
-warning_escaped=$(escape_for_json "$warning_message")
-session_context="<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the full content of your 'superpowers:using-superpowers' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\n\n${using_superpowers_escaped}\n\n${warning_escaped}\n</EXTREMELY_IMPORTANT>"
+session_context="<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the full content of your 'superpowers:using-superpowers' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\n\n${using_superpowers_escaped}\n</EXTREMELY_IMPORTANT>"
 
 # Output context injection as JSON.
 # Cursor hooks expect additional_context (snake_case).
@@ -45,13 +37,13 @@ session_context="<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the
 # See: https://github.com/obra/superpowers/issues/571
 if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
   # Cursor sets CURSOR_PLUGIN_ROOT (may also set CLAUDE_PLUGIN_ROOT)
-  printf '{\n  "additional_context": "%s"\n}\n' "$session_context"
+  printf '{\n  "additional_context": "%s"\n}\n' "$session_context" | cat
 elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ]; then
   # Claude Code sets CLAUDE_PLUGIN_ROOT without COPILOT_CLI
-  printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context"
+  printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context" | cat
 else
   # Copilot CLI (sets COPILOT_CLI=1) or unknown platform — SDK standard format
-  printf '{\n  "additionalContext": "%s"\n}\n' "$session_context"
+  printf '{\n  "additionalContext": "%s"\n}\n' "$session_context" | cat
 fi
 
 exit 0

package/package.json

@@ -1,16 +1,18 @@
 {
   "name": "superpowers-zh",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "engines": {
     "node": ">=20.0.0"
   },
-  "description": "AI 编程超能力中文增强版 — superpowers（159k+ ⭐）完整汉化 + 4 个中国原创 skills，支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Claw Code / Windsurf / Kiro / Gemini CLI / Qoder 等 18 款工具",
+  "description": "AI 编程超能力中文增强版 — superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills，支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Claw Code / Windsurf / Kiro / Gemini CLI / Qoder 等 20 款工具",
   "type": "module",
   "main": ".opencode/plugins/superpowers.js",
   "bin": {
     "superpowers-zh": "bin/superpowers-zh.js"
   },
   "scripts": {
+    "site": "node site/build.mjs",
+    "site:deploy": "node site/build.mjs && wrangler pages deploy site/dist --project-name=superpowers-zh-site",
     "version": "node scripts/sync-plugin-version.js && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json .cursor-plugin/plugin.json .codex-plugin/plugin.json gemini-extension.json"
   },
   "files": [
@@ -24,6 +26,7 @@
     ".codex-plugin/",
     ".opencode/INSTALL.md",
     ".opencode/plugins/",
+    ".pi/extensions/",
     "CLAUDE.md",
     "GEMINI.md",
     "RELEASE-NOTES.md",
@@ -54,17 +57,28 @@
     "hermes-agent",
     "claw-code",
     "qoder",
+    "codebuddy",
+    "codearts",
     "ai-coding",
     "skills",
     "chinese",
     "中文",
     "tdd",
     "debugging",
-    "code-review"
+    "code-review",
+    "pi-package"
   ],
+  "pi": {
+    "skills": [
+      "./skills"
+    ],
+    "extensions": [
+      "./.pi/extensions/superpowers.ts"
+    ]
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/jnMetaCode/superpowers-zh.git"
+    "url": "git+https://github.com/jnMetaCode/superpowers-zh.git"
   },
   "homepage": "https://github.com/jnMetaCode/superpowers-zh",
   "author": "jnMetaCode",

package/skills/brainstorming/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: brainstorming
 description: "在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。"
+version: "1.0.0"
+license: MIT
+metadata:
+  hermes:
+    tags: [design, planning]
 ---
 
 # 头脑风暴：将想法转化为设计

package/skills/brainstorming/scripts/frame-template.html

@@ -9,11 +9,11 @@
      *
      * This template provides a consistent frame with:
      * - OS-aware light/dark theming
-     * - Fixed header and selection indicator bar
+     * - Header branding and connection status
      * - Scrollable main content area
      * - CSS helpers for common UI patterns
      *
-     * Content is injected via placeholder comment in #claude-content.
+     * Content is injected via placeholder comment in #frame-content.
      */
 
     * { box-sizing: border-box; margin: 0; padding: 0; }
@@ -63,34 +63,37 @@
     }
 
     /* ===== FRAME STRUCTURE ===== */
-    .header {
-      background: var(--bg-secondary);
-      padding: 0.5rem 1.5rem;
-      display: flex;
-      justify-content: space-between;
-      align-items: center;
-      border-bottom: 1px solid var(--border);
-      flex-shrink: 0;
+    .brand { display: flex; align-items: center; min-width: 0; overflow: hidden; color: var(--text-secondary); line-height: 1; }
+    .brand a { color: inherit; text-decoration: none; display: flex; align-items: center; gap: 0.5rem; min-width: 0; max-width: 100%; line-height: 1; }
+    .brand-copy { display: block; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; line-height: 1; transform: translateY(-1px); }
+    .brand-logo { display: block; height: 1em; width: auto; max-width: 180px; flex-shrink: 0; filter: invert(1); }
+    @media (prefers-color-scheme: dark) {
+      .brand-logo { filter: none; }
     }
-    .header h1 { font-size: 0.85rem; font-weight: 500; color: var(--text-secondary); }
-    .header .status { font-size: 0.7rem; color: var(--success); display: flex; align-items: center; gap: 0.4rem; }
-    .header .status::before { content: ''; width: 6px; height: 6px; background: var(--success); border-radius: 50%; }
+    .status { font-size: 0.7rem; color: var(--status-color, var(--success)); display: flex; align-items: center; gap: 0.4rem; justify-self: end; white-space: nowrap; line-height: 1; }
+    .status::before { content: ''; width: 6px; height: 6px; background: var(--status-color, var(--success)); border-radius: 50%; }
 
     .main { flex: 1; overflow-y: auto; }
-    #claude-content { padding: 2rem; min-height: 100%; }
+    #frame-content { padding: 2rem; min-height: 100%; }
 
-    .indicator-bar {
+    .header {
       background: var(--bg-secondary);
-      border-top: 1px solid var(--border);
+      border-bottom: 1px solid var(--border);
       padding: 0.5rem 1.5rem;
       flex-shrink: 0;
-      text-align: center;
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) auto;
+      align-items: center;
+      gap: 1rem;
+      min-height: 42px;
     }
-    .indicator-bar span {
+    .header .brand { justify-self: start; width: 100%; font-size: 0.75rem; line-height: 1; }
+    .header .status { grid-column: 2; line-height: 1; }
+    .header span {
       font-size: 0.75rem;
       color: var(--text-secondary);
     }
-    .indicator-bar .selected-text {
+    .header .selected-text {
       color: var(--accent);
       font-weight: 500;
     }
@@ -196,19 +199,15 @@
 </head>
 <body>
   <div class="header">
-    <h1><a href="https://github.com/obra/superpowers" style="color: inherit; text-decoration: none;">Superpowers Brainstorming</a></h1>
-    <div class="status">Connected</div>
+    <!-- BRANDING -->
+    <div class="status">Connecting…</div>
   </div>
 
   <div class="main">
-    <div id="claude-content">
+    <div id="frame-content">
       <!-- CONTENT -->
     </div>
   </div>
 
-  <div class="indicator-bar">
-    <span id="indicator-text">Click an option above, then return to the terminal</span>
-  </div>
-
 </body>
 </html>