{
  "markdown": "# Superpowers-Beads\n\nA fork of [Superpowers](https://github.com/obra/superpowers) that replaces markdown-based spec/plan storage with [Beads](https://github.com/gastownhall/beads) as the single source of truth.\n\n## What's Different\n\nThe original Superpowers stores specs and plans as markdown files in `docs/superpowers/specs/` and `docs/superpowers/plans/`. This fork replaces that with Beads — a distributed graph issue tracker built for AI agents.\n\n### Key changes\n\n- **Specs are beads.** The brainstorming skill creates a root epic bead (`bd create -t epic`) instead of writing a markdown file. The full spec lives in the bead body.\n- **Plans are bead trees.** The writing-plans skill creates child beads for each task, linked with dependency graphs (`bd dep add`). No plan markdown file.\n- **Execution is bead-driven.** The subagent-driven-development, hybrid-execution, and codex-execution skills use `bd ready --parent` / `bd update --assignee` / `bd close --reason` instead of parsing checkboxes in a file.\n- **Progress is live.** Track everything in [beads-ui](https://github.com/mantoni/beads-ui) in real time.\n- **Git stays searchable.** A lightweight summary file is committed to `docs/beads/` for each feature, and all commit messages include bead IDs.\n\n### What's unchanged\n\n6 skills are identical to the original Superpowers: TDD, systematic-debugging, git-worktrees, writing-skills, requesting-code-review, verification-before-completion.\n\n### Skills modified\n\n| Skill | What changed |\n|-------|-------------|\n| brainstorming | Stores specs as epic beads, writes summary file to `docs/beads/` |\n| writing-plans | Creates task beads with `bd dep add` dependencies instead of markdown plan |\n| subagent-driven-development | Same dispatch model, beads for persistent tracking |\n| using-superpowers | Bootstrap mentions beads storage model |\n| hybrid-execution | New skill: routes each task inline or to a subagent based on the plan's Execution annotation |\n| codex-execution | New skill: runs task beads via the codex CLI with per-landing verification and a terminal whole-diff review |\n| handoff | New skill: session close, resume, and explicit night-session preparation via a tagged record on one anchor bead per project — a fresh session reads pointers to durable state, never a transcript |\n\n## Important: Uninstall Original Superpowers First\n\nThis plugin replaces the original Superpowers. Having both installed causes duplicate skills with unpredictable behavior. Uninstall the original before installing this one:\n\n```bash\n/plugin uninstall superpowers\n```\n\nIf both are installed, a warning will appear at the start of every session.\n\n## Requirements\n\n- [Beads CLI](https://github.com/gastownhall/beads) (`bd`) must be installed\n- Initialize beads in your project: `bd init`\n- Optional: [beads-ui](https://github.com/mantoni/beads-ui) for a web dashboard\n\n## Installation\n\n### Claude Code\n\n```bash\n/plugin install superpowers-beads\n```\n\n### From source\n\n```bash\ngit clone https://github.com/rsktash/superpowers.git\ncd superpowers\n# Follow Claude Code plugin installation docs\n```\n\n## The Workflow\n\n1. **brainstorming** — Refines ideas, creates spec as an epic bead, commits summary to `docs/beads/`\n2. **writing-plans** — Decomposes spec into task beads with dependency ordering\n3. **subagent-driven-development**, **hybrid-execution**, or **codex-execution** — Executes tasks via `bd ready` loop; hybrid routes each task inline or to a subagent per its Execution annotation\n4. **using-git-worktrees** (Finishing: Merge Back and Clean Up) — Verifies all tasks closed, closes epic, merges/PRs with bead ID\n\n### Summary file naming\n\n```\ndocs/beads/{date}-{incr}-{bd-id}-{short-title}.md\n```\n\nExample: `docs/beads/2026-04-04-001-bd-a3f8-widget-caching-layer.md`\n\n### Interruption recovery\n\nIf a session is interrupted, the next session recovers by:\n1. Finding the root bead ID from `docs/beads/*-bd-*.md`\n2. Querying `bd show <root-id> --json` for all task statuses\n3. Reading step-progress comments on in-progress tasks\n4. Resuming from where it left off\n\n## Credits\n\nThis is a fork of [Superpowers](https://github.com/obra/superpowers) by [Jesse Vincent](https://blog.fsck.com). The original project and community:\n\n- **Original repo**: https://github.com/obra/superpowers\n- **Discord**: [Join](https://discord.gg/Jd8Vphy9jq) the Superpowers community\n- **Blog post**: [Superpowers for Claude Code](https://blog.fsck.com/2025/10/09/superpowers/)\n\n## License\n\nMIT License — see LICENSE file for details.\n",
  "bytes": 4522,
  "sha": "ee1489b264918e12d194797772cbd5eaffb590dd5bb036f696d61ddb380a6a65",
  "repo_slug": "rsktash/superpowers",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_rsktash_superpowers_superpowers_beads_3c55fa20/readme"
}