# bootstrap-recommend-superpowers

## Goal
`project-bootstrap` writes `use superpowers` into the new project's `CLAUDE.md` (Step 5 template), but that trigger only fires if the `superpowers@claude-plugins-official` plugin is installed. On a fresh machine the plugin is often absent, so the trigger silently no-ops. Add a Step 5.6 that detects the plugin via `~/.claude/plugins/installed_plugins.json` and, when missing, prints a recommendation with the exact install command + upstream link. Strictly informational — never auto-installs.

## Key files
- `skills/project-bootstrap/SKILL.md` — add Step 5.6 between 5.5 (manifest) and 6 (commit); bump frontmatter `version: 1.0.0 → 1.1.0`
- `skills/project-bootstrap/README.md` — extend the steps overview to mention the new check
- `~/.claude/plugins/installed_plugins.json` — detection source

## Decisions log
- 2026-04-28: Place check at Step 5.6 (right after manifest, before commit). Reason: CLAUDE.md just got `use superpowers`, so the recommendation lands while context is fresh. Alternative — fold into Step 0 detect — rejected: Step 0 is meant to be quick + read-only summary; threading plugin checks there bloats the no-op happy path.
- 2026-04-28: Detection by file read, not by `/plugin list`. Reason: slash commands aren't callable from inside a skill; the JSON file is the source of truth Claude Code itself reads. Same approach as `setup-context7` Phase 1.
- 2026-04-28: Recommendation, not auto-install. Reason: `/plugin install` is interactive and per `setup-context7` we can't drive slash commands from a skill. Even if we could, auto-installing a plugin without consent is overreach.
- 2026-04-28: Limit scope to `superpowers` only. User explicitly asked for that one. Generic "recommended plugins" framework is feature creep — defer until there's a second item.

## Open questions
- [ ] None — done.

## Completed steps
- [x] Confirm plugin install path / JSON shape from local `installed_plugins.json`
- [x] Pick insertion point (Step 5.6)
- [x] Pick detection method (file read of `installed_plugins.json`)
- [x] Patch `SKILL.md` (Step 5.6 + frontmatter `version: 1.1.0`)
- [x] Update `README.md` workflow numbering
- [x] Reinstall to `~/.claude/skills/project-bootstrap/`
- [x] Rebuild `dist/project-bootstrap.skill`
- [x] Append wiki log entry
- [x] Commit

## Notes
- Plugin install command (canonical, from `installed_plugins.json` key): `/plugin install superpowers@claude-plugins-official`
- Upstream: https://github.com/anthropics/claude-plugins-official
- Cross-platform path: `~/.claude/plugins/installed_plugins.json` resolves identically on Windows / Linux / macOS.