{
  "markdown": "# Superpowers DeepSeek v4\n\n**Superpowers DeepSeek v4** is an agentic methodology and composable skills library for coding agents. It evolved from ideas in [obra/superpowers](https://github.com/obra/superpowers) but is **maintained independently**. Skills, hooks, install paths, and release cadence **are not guaranteed to match** the upstream project. Report issues and open pull requests **in this repository** if you use this variant.\n\n## Quickstart\n\nInstall for your harness: [Claude Code](#claude-code) · [Codex CLI](#codex-cli) · [Codex App](#codex-app) · [Factory Droid](#factory-droid) · [Gemini CLI](#gemini-cli) · [OpenCode](#opencode) · [Cursor](#cursor) · [GitHub Copilot CLI](#github-copilot-cli)\n\n## How it works\n\nWhen you start building something, the agent does not immediately jump into code. It steps back, clarifies intent, and turns the conversation into a design you can read in sections. After you approve the design, it produces an implementation plan that a careful junior engineer could follow. It emphasizes red/green TDD, YAGNI, and DRY. When you say go, skills like **subagent-driven-development** drive execution with reviews and checkpoints. Skills are designed to trigger automatically—no manual “turn on superpowers” step.\n\n## Installation\n\nUse **this repository** (`gylove1994/superpowers-deepseek-v4`) when copying install commands below. If you want the **upstream** [obra/superpowers](https://github.com/obra/superpowers) plugin instead, follow that project’s README; behavior and skills may differ.\n\n### Claude Code (this repo — recommended)\n\nFrom a clone of this repository, register the local marketplace and install the project-scoped plugin (see [.claude-plugin/marketplace.json](.claude-plugin/marketplace.json)):\n\n```bash\ncd /path/to/superpowers-deepseek-v4\n/plugin marketplace add ./\n/plugin install superpowers-deepseek-v4@gylove1994-superpowers-deepseek-v4 --scope project\n```\n\nOr add `--scope user` if you want it available in every project.\n\n#### Upstream reference (official Superpowers plugin)\n\nAnthropic’s catalog entry is not this fork. To install **upstream** Superpowers only:\n\n```bash\n/plugin install superpowers@claude-plugins-official\n```\n\n### Codex CLI\n\nUse the [official Codex plugin marketplace](https://github.com/openai/plugins). Search for Superpowers and install; confirm the package points at **this** repo if you intend to use DeepSeek v4–oriented skills.\n\n```bash\n/plugins\n# search: superpowers\n```\n\n### Codex App\n\nSame marketplace as Codex CLI: Plugins → find Superpowers → install. Verify source matches the repository you intend.\n\n### Factory Droid\n\n```bash\ndroid plugin marketplace add https://github.com/gylove1994/superpowers-deepseek-v4\ndroid plugin install superpowers@superpowers\n```\n\n(Adjust plugin id if your marketplace entry uses a different name.)\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/gylove1994/superpowers-deepseek-v4\ngemini extensions update superpowers\n```\n\n### OpenCode\n\nOpenCode has its own install path. Use the copy of **this** repo’s instructions:\n\n```text\nFetch and follow instructions from https://raw.githubusercontent.com/gylove1994/superpowers-deepseek-v4/main/.opencode/INSTALL.md\n```\n\nMore detail: [.opencode/INSTALL.md](.opencode/INSTALL.md) and [docs/README.opencode.md](docs/README.opencode.md).\n\n### Cursor\n\nIn Cursor Agent chat:\n\n```text\n/add-plugin superpowers\n```\n\nOr search the marketplace for this project’s listing, if published.\n\n### GitHub Copilot CLI\n\nThe default community marketplace ships the **upstream** Superpowers plugin. To use **this** repository, add a marketplace or install path that references `https://github.com/gylove1994/superpowers-deepseek-v4` (see GitHub Copilot CLI plugin docs for `marketplace add` / `plugin install` with a custom source). Example pattern if you mirror this repo into a marketplace entry:\n\n```bash\ncopilot plugin marketplace add <YOUR_MARKETPLACE_OR_PATH_TO_THIS_REPO>\ncopilot plugin install superpowers@<YOUR_ENTRY>\n```\n\nVerify the resolved plugin URL points at this fork before relying on DeepSeek v4–oriented behavior.\n\n## The Basic Workflow\n\n1. **brainstorming** — Before code: questions, alternatives, design in readable chunks; saves the design doc.\n2. **confirming-worktree-before-edit** → **using-git-worktrees** — Session bootstrap (before using-superpowers): confirm worktree preference once per session before any project file write (source, spec, plan, config), then isolated branch/workspace and clean test baseline when accepted.\n3. **writing-plans** — Turns the approved design into small tasks with paths and verification.\n4. **subagent-driven-development** or **executing-plans** — Executes the plan with reviews or batch checkpoints.\n5. **test-driven-development** — RED–GREEN–REFACTOR; failures first, minimal code, then refactor.\n6. **requesting-code-review** — Between tasks; severity and blockers.\n7. **finishing-a-development-branch** — Done: tests, merge/PR/keep/discard, worktree cleanup.\n\nThe agent is expected to invoke relevant skills before and during work—this is workflow, not optional flavor text.\n\n## What's Inside\n\n### Skills library (high level)\n\n**Testing** — **test-driven-development**\n\n**Debugging** — **systematic-debugging**, **verification-before-completion**\n\n**Collaboration** — **brainstorming**, **writing-plans**, **executing-plans**, **dispatching-parallel-agents**, **requesting-code-review**, **receiving-code-review**, **confirming-worktree-before-edit**, **using-git-worktrees**, **finishing-a-development-branch**, **subagent-driven-development**\n\n**Meta** — **writing-skills**, **using-superpowers**\n\n## Philosophy\n\n- Test-driven development first\n- Systematic investigation over guessing\n- Simplicity as a goal\n- Verify before claiming done\n\nBackground on the original Superpowers announcement: [blog.fsck.com (Oct 2025)](https://blog.fsck.com/2025/10/09/superpowers/).\n\n## Contributing\n\nContributions go through **this** repository. New skills and cross-harness behavior are reviewed strictly (see [CLAUDE.md](CLAUDE.md) and the PR template). Typical flow:\n\n1. Fork or branch from this repo  \n2. Use the `writing-skills` skill for skill changes  \n3. Open **one** focused PR with the template fully filled  \n\n## Updating\n\nPlugin and harness updates vary by tool; some update automatically when you refresh marketplace or git-backed installs.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n## Community & attribution\n\nMaintained by [gylove1994](https://github.com/gylove1994). The original **Superpowers** project was created by [Jesse Vincent](https://blog.fsck.com) and [Prime Radiant](https://primeradiant.com). This fork appreciates that lineage; it does not imply endorsement or feature parity.\n\n- **Issues (this project):** https://github.com/gylove1994/superpowers-deepseek-v4/issues  \n- **Upstream project (reference):** https://github.com/obra/superpowers  \n\nDiscord and release lists aimed at the upstream community may still be useful for general discussion; they are not the support channel for **this** fork’s behavior.\n",
  "bytes": 7066,
  "sha": "3b05a8647bd68eacf0d97b76e1a2ae5cc11e840eecb8624834f788d2a8a1fa61",
  "repo_slug": "gylove1994/superpowers-deepseek-v4",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_gylove1994_superpowers_deepseek_v4_7cabf0b3/readme"
}