# Project Instructions

## Superpowers Skills (MANDATORY)

This project uses the [obra/superpowers](https://github.com/obra/superpowers) skill collection, installed in `.agents/skills/`. These skills MUST be used in every session on this project.

Follow the `using-superpowers` meta-skill at the start of any task: **invoke the relevant skill BEFORE any response or action** — if there is even a 1% chance a skill applies, use it.

### Skill routing

| Task | Skill to invoke first |
| --- | --- |
| Starting / routing any task | `using-superpowers` |
| "Let's build X" / new feature idea | `brainstorming`, then `writing-plans` |
| Executing an agreed plan | `executing-plans` |
| "Fix this bug" / something broken | `systematic-debugging` |
| Writing or changing tests-first | `test-driven-development` |
| Before claiming work is done | `verification-before-completion` |
| Asking for / handling code review | `requesting-code-review` / `receiving-code-review` |
| Parallel independent work | `dispatching-parallel-agents` / `subagent-driven-development` |
| Finishing up a branch | `finishing-a-development-branch` |

Other installed skills: `using-git-worktrees`, `writing-skills`.

Update to the latest version with: `git clone --depth 1 https://github.com/obra/superpowers` and copy `skills/*` over `.agents/skills/`.
