Generated by Code IQ · v1.0

superpowers
Knowledge Tutorial

Superpowers is a comprehensive workflow engine for AI coding agents that transforms standard software engineering best practices into executable "skills" (markdown files). It separates the development process into distinct phases: an architectural Planning Pipeline to design specifications, and a Subagent-Driven Development engine where a "General Contractor" agent dispatches isolated sub-agents to execute tasks. The system enforces Systematic Discipline, such as Test-Driven Development (TDD) and rigorous debugging protocols, ensuring high-quality, reliable code generation.

6
Chapters
-
Subsystems
Rabbit Holes
▶ Start Reading ⎇ View on GitHub
System Architecture

How the pieces fit

superpowers is organized as connected concepts and components. Start broad, then drill down chapter by chapter.

⚙️
The Skill Definition (Natural Language Programs)
The Skill Definition (Natural Language Programs)
⚙️
The Bootstrap Layer (Context Injection)
The Bootstrap Layer (Context Injection)
⚙️
Skill Discovery & Core Library
Skill Discovery & Core Library
⚙️
The Planning Pipeline (Architectural Phase)
The Planning Pipeline (Architectural Phase)
👥
Subagent-Driven Development (The Manager Pattern)
Subagent-Driven Development (The Manager Pattern)
⚙️
Systematic Discipline (Enforced Best Practices)
Systematic Discipline (Enforced Best Practices)
superpowers — bash
open tutorial
◆ Scanning numbered chapters
◆ Building navigation and Mermaid diagrams
◆ Generating chapter and subsystem pages
✓ 6 chapter pages built
✓ Theme toggle enabled
Repository Overview

Intro and Architecture Diagram

Superpowers is a comprehensive workflow engine for AI coding agents that transforms standard software engineering best practices into executable "skills" (markdown files). It separates the development process into distinct phases: an architectural Planning Pipeline to design specifications, and a Subagent-Driven Development engine where a "General Contractor" agent dispatches isolated sub-agents to execute tasks. The system enforces Systematic Discipline, such as Test-Driven Development (TDD) and rigorous debugging protocols, ensuring high-quality, reliable code generation.

Source Repository: https://github.com/obra/superpowers

flowchart TD A0["The Skill Definition (Natural Language Programs)"] A1["The Bootstrap Layer (Context Injection)"] A2["Subagent-Driven Development (The Manager Pattern)"] A3["The Planning Pipeline (Architectural Phase)"] A4["Systematic Discipline (Enforced Best Practices)"] A5["Skill Discovery & Core Library"] A1 -->|"Uses for lookup"| A5 A5 -->|"Parses and validates"| A0 A1 -->|"Injects 'using-superpowers'..."| A0 A3 -->|"Generates plan for"| A2 A2 -->|"Enforces usage of"| A4 A4 -->|"Is defined as"| A0
Tutorial Chapters

All 6 chapters

Follow sequentially or jump to any topic. Start with The Skill Definition (Natural Language Programs).

About This Project

Generated by Code IQ

This tutorial was automatically generated by Code IQ and rendered with the shared tutorial site builder. It can be produced for any repository tutorial folder that follows the numbered markdown chapter layout.

View Code IQ ↗
python build_site.py '/home/runner/work/Code-IQ/Code-IQ/output/superpowers'

// → 6 chapters
// → source: obra/superpowers