<!-- Role: landing - orient and route in under a minute. Does NOT belong here: any fact that can rot (counts, versions, capability lists) - every claim lives on the page that owns it. -->


beads-superpowers gives AI coding agents composable skills that enforce process discipline - TDD, systematic debugging, design before code, code review - plus a persistent issue tracker that carries context across sessions. The skills come from [Superpowers](https://github.com/obra/superpowers); the tracker from [Beads](https://github.com/gastownhall/beads).

## Where to start

- **[Getting Started](/beads-superpowers/getting-started/)** - install the plugin and `bd`, per harness, then run your first session.
- **[Example Workflow](/beads-superpowers/workflow/)** - the orchestrator that routes a request through the pipeline, from triage to finish.
- **[Philosophy](/beads-superpowers/philosophy/)** - why the plugin behaves the way it does: the design decisions behind it, not the day-to-day mechanics.
- **[Memory & Sessions](/beads-superpowers/memory/)** - what happens to memory across a session's life: injection, curation, the knowledge store.
- **[Methodology](/beads-superpowers/methodology/)** - the problem each upstream project solved, and how the two combine into one mechanism.
- **[Skills Reference](/beads-superpowers/skills/)** - the full per-skill reference: what each skill does and when it triggers.
- **[Research](/beads-superpowers/research/)** - the literature and the project's own measurements behind each design choice.
- **[Tips & Tricks](/beads-superpowers/tips/)** - day-to-day operational tips: the `bd` cheat sheet and fixes for common issues.

Ready to try it? [Getting Started](/beads-superpowers/getting-started/) covers install and your first `bd init`.