agy-superpowers 5.0.5

package/template/agent/workflows/update-superpowers.md

@@ -0,0 +1,47 @@
+---
+description: Update superpowers to the latest GitHub release and sync .agent/ files
+---
+
+This workflow has two phases:
+- **Phase 1 (script):** version check, clone, rebuild symlinks, sync agents + commands→workflows with path fixes, save state
+- **Phase 2 (AI):** update the skill list in rules only — no content rewriting
+
+// turbo
+1. Run the update script:
+   `bash .agent/.shared/update-superpowers.sh`
+
+   - If output ends with "Already up to date" → **STOP**. Nothing to do.
+   - If clone fails → **STOP**. Report the error to the user.
+   - On success the script prints `SCRIPT_DONE:<new-tag>` — note the new tag and continue.
+
+2. **Phase 2 — Update skill list in rules**
+
+   List all skill folders now present in `.agent/skills/`.
+   Open `.agent/rules/superpowers.md` and update **only the skills table**:
+   - Add a row for any skill not already listed (use its SKILL.md `description` field as the "When to Use" value).
+   - Prefix any skill that no longer exists with ⚠️ and a note "(removed upstream)".
+   - Preserve all other content in the file exactly as-is.
+
+   If no skills were added or removed → skip, note "rules: no changes needed".
+
+3. **Phase 2 — New skills check**
+
+   For any skill in `.agent/skills/` that has no corresponding workflow in `.agent/workflows/`:
+   - Read its `SKILL.md` `description` field.
+   - Report it to the user: "New skill available: `<name>` — `<description>`. Create a workflow?"
+   - Do NOT auto-create. Let the user decide.
+
+// turbo
+4. Commit all changes from Phase 2:
+   `git add .agent/ && git commit -m "chore: sync .agent/ with superpowers <new-tag>"`
+   (Skip commit if nothing changed.)
+
+5. Print summary:
+   ```
+   ✅ Superpowers updated: <old-tag> → <new-tag>
+   📦 Skills: <old-count> → <new-count>  (+new_skill / -removed_skill)
+   📋 Agents synced: <list>
+   🔄 Workflows synced from commands: <list or "none">
+   🔄 Rules updated: <yes/no>
+   ⚠️  New skills needing workflows: <list or "none">
+   ```

package/template/agent/workflows/write-plan.md

@@ -0,0 +1,17 @@
+---
+description: Write a detailed implementation plan from an approved design - uses superpowers writing-plans skill
+---
+
+Read and follow the `writing-plans` skill completely:
+
+// turbo
+1. Read the skill: `view_file` `.agent/skills/writing-plans/SKILL.md`
+
+2. Locate the most recent design doc in `docs/superpowers/specs/` as the foundation
+
+3. Execute the full skill process:
+   - Break the design into tasks of 2-5 minutes each
+   - Each task must include: exact file paths, complete code, and verification steps
+   - Save the plan to `docs/superpowers/plans/YYYY-MM-DD-<topic>-plan.md`
+   - Commit the plan to git
+   - Wait for user approval before execution begins