{
  "markdown": "# Lab8-Powers\n\nLab-8 fork of [Superpowers](https://github.com/obra/superpowers) — first-principles design, mandatory clean-slate evaluation, built-in code review & verification, core skills library.\n\nA complete software development workflow for your coding agents, built on top of composable \"skills\" and initial instructions that make sure your agent uses them.\n\n## What's Different from Superpowers\n\n- **Mandatory clean-slate evaluation** — every brainstorming session presents three approaches: (a) extend existing code, (b) refactor then build, and (c) clean-slate build. Without this, incremental changes silently accumulate into band-aids and workarounds. The clean-slate option forces you to think about what proper code looks like before deciding whether to extend what's there.\n- **Built-in code review & verification** — integrated code review agents and verification-before-completion checks ensure work meets requirements before you claim it's done.\n- **Required documentation sections** — specs must include architecture diagrams, file trees, connection maps, and design rationale. No more vague specs.\n- **First-principles design step** — before proposing approaches, the agent describes what the ideal implementation would look like if built from scratch today, using the codebase's own conventions.\n\n## How It Works\n\nIt starts from the moment you fire up your coding agent. As soon as it sees that you're building something, it steps back and asks you what you're really trying to do.\n\nOnce it's teased a spec out of the conversation, it shows it to you in chunks short enough to actually read and digest.\n\nAfter you've signed off on the design, your agent puts together an implementation plan that's clear enough for an enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing to follow. It emphasizes true red/green TDD, YAGNI (You Aren't Gonna Need It), and DRY.\n\nNext up, once you say \"go\", it launches a *subagent-driven-development* process, having agents work through each engineering task, inspecting and reviewing their work, and continuing forward.\n\nBecause the skills trigger automatically, you don't need to do anything special. Your coding agent just has powers.\n\n## Installation\n\n### Claude Code\n\n```bash\nclaude plugin add nambo35/lab8-powers\n```\n\n### Verify Installation\n\nStart a new session and ask for something that should trigger a skill (e.g., \"help me plan this feature\" or \"let's debug this issue\"). The agent should automatically invoke the relevant skill.\n\n## The Basic Workflow\n\n1. **brainstorming** — Refines ideas through questions, runs first-principles design, presents 3 approaches (extend / refactor / clean-slate), saves design document with required diagrams and connection maps.\n\n2. **using-git-worktrees** — Creates isolated workspace on a new branch, runs project setup, verifies clean test baseline.\n\n3. **writing-plans** — Breaks work into bite-sized tasks with exact file paths, complete code, and verification steps. Includes dependency/connection maps and holistic clean-slate review.\n\n4. **subagent-driven-development** or **executing-plans** — Dispatches fresh subagent per task with two-stage review (spec compliance, then code quality), or executes in batches with human checkpoints.\n\n5. **test-driven-development** — Enforces RED-GREEN-REFACTOR: write failing test, watch it fail, write minimal code, watch it pass, commit.\n\n6. **requesting-code-review** — Reviews against plan, reports issues by severity. Critical issues block progress.\n\n7. **verification-before-completion** — Runs verification commands and confirms output before making any success claims.\n\n8. **finishing-a-development-branch** — Verifies tests, presents options (merge/PR/keep/discard), cleans up worktree.\n\n**Skills trigger automatically.** Mandatory workflows, not suggestions.\n\n## Skills Library\n\n**Design & Planning**\n- **brainstorming** — First-principles design with mandatory clean-slate evaluation\n- **writing-plans** — Implementation plans with dependency maps and clean-slate review\n- **executing-plans** — Batch execution with human checkpoints\n- **dispatching-parallel-agents** — Concurrent subagent workflows\n- **subagent-driven-development** — Fast iteration with two-stage review\n\n**Testing & Verification**\n- **test-driven-development** — RED-GREEN-REFACTOR cycle\n- **systematic-debugging** — 4-phase root cause process\n- **verification-before-completion** — Evidence before assertions\n\n**Code Review**\n- **requesting-code-review** — Pre-review checklist with severity levels\n- **receiving-code-review** — Technical rigor over performative agreement\n\n**Git & Workflow**\n- **using-git-worktrees** — Isolated development branches\n- **finishing-a-development-branch** — Merge/PR decision workflow\n\n**Meta**\n- **writing-skills** — Create new skills following best practices\n- **using-lab8-powers** — Introduction to the skills system\n\n## Philosophy\n\n- **First-principles design** — Understand the ideal before proposing approaches\n- **Mandatory clean-slate option** — Incremental changes silently become band-aids. Always evaluate what proper code looks like before deciding to extend\n- **Test-Driven Development** — Write tests first, always\n- **Evidence over claims** — Verify before declaring success\n- **Complexity reduction** — Simplicity as primary goal\n\nBased on [Superpowers](https://github.com/obra/superpowers) by [Jesse Vincent](https://blog.fsck.com).\n\n## License\n\nMIT License - see LICENSE file for details\n",
  "bytes": 5517,
  "sha": "e2757b7c926efc4274b98e5f809e888609907f78e41067c0ff82801a96c322b4",
  "repo_slug": "nambo35/lab8-powers",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_nambo35_lab8_powers_b409570a/readme"
}