An agentic skills framework & software development methodology that works.
Add comprehensive v2.0.0 release notes
Jesse Vincenta39561bd410e
diff --git a/RELEASE-NOTES-v2.0.0.md b/RELEASE-NOTES-v2.0.0.mdnew file mode 100644index 000000000..3578289b7--- /dev/null+++ b/RELEASE-NOTES-v2.0.0.md@@ -0,0 +1,221 @@+# Superpowers v2.0.0 Release Notes++## Breaking Changes++### Skills Repository Separation++**The biggest change:** Skills no longer live in the plugin. They've been moved to a separate repository at [obra/superpowers-skills](https://github.com/obra/superpowers-skills).++**What this means for you:**++- **First install:** Plugin automatically clones skills to `~/.config/superpowers/skills/`+- **Forking:** During setup, you'll be offered the option to fork the skills repo (if `gh` is installed)+- **Updates:** Skills auto-update on session start (fast-forward when possible)+- **Contributing:** Work on branches, commit locally, submit PRs to upstream+- **No more shadowing:** Old two-tier system (personal/core) replaced with single-repo branch workflow++**Migration:**++If you have an existing installation:+1. Your old `~/.config/superpowers/.git` will be backed up to `~/.config/superpowers/.git.bak`+2. Old skills will be backed up to `~/.config/superpowers/skills.bak`+3. Fresh clone of obra/superpowers-skills will be created at `~/.config/superpowers/skills/`++### Removed Features++- **Personal superpowers overlay system** - Replaced with git branch workflow+- **setup-personal-superpowers hook** - Replaced by initialize-skills.sh++## New Features++### Skills Repository Infrastructure++**Automatic Clone & Setup** (`lib/initialize-skills.sh`)+- Clones obra/superpowers-skills on first run+- Offers fork creation if GitHub CLI is installed+- Sets up upstream/origin remotes correctly+- Handles migration from old installation++**Auto-Update**+- Fetches from tracking remote on every session start+- Auto-merges with fast-forward when possible+- Notifies when manual sync needed (branch diverged)+- Uses pulling-updates-from-skills-repository skill for manual sync++### New Skills++**Problem-Solving Skills** (`skills/problem-solving/`)+- **collision-zone-thinking** - Force unrelated concepts together for emergent insights+- **inversion-exercise** - Flip assumptions to reveal hidden constraints+- **meta-pattern-recognition** - Spot universal principles across domains+- **scale-game** - Test at extremes to expose fundamental truths+- **simplification-cascades** - Find insights that eliminate multiple components+- **when-stuck** - Dispatch to right problem-solving technique++**Research Skills** (`skills/research/`)+- **tracing-knowledge-lineages** - Understand how ideas evolved over time++**Architecture Skills** (`skills/architecture/`)+- **preserving-productive-tensions** - Keep multiple valid approaches instead of forcing premature resolution++### Skills Improvements++**using-skills (formerly getting-started)**+- Renamed from getting-started to using-skills+- Complete rewrite with imperative tone (v4.0.0)+- Front-loaded critical rules+- Added "Why" explanations for all workflows+- Always includes /SKILL.md suffix in references+- Clearer distinction between rigid rules and flexible patterns++**writing-skills**+- Cross-referencing guidance moved from using-skills+- Added token efficiency section (word count targets)+- Improved CSO (Claude Search Optimization) guidance++**sharing-skills**+- Updated for new branch-and-PR workflow (v2.0.0)+- Removed personal/core split references++**pulling-updates-from-skills-repository** (new)+- Complete workflow for syncing with upstream+- Replaces old "updating-skills" skill++### Tools Improvements++**find-skills**+- Now outputs full paths with /SKILL.md suffix+- Makes paths directly usable with Read tool+- Updated help text++**skill-run**+- Moved from scripts/ to skills/using-skills/+- Improved documentation++### Plugin Infrastructure++**Session Start Hook**+- Now loads from skills repository location+- Shows full skills list at session start+- Prints skills location info+- Shows update status (updated successfully / behind upstream)+- Moved "skills behind" warning to end of output++**Environment Variables**+- `SUPERPOWERS_SKILLS_ROOT` set to `~/.config/superpowers/skills`+- Used consistently throughout all paths++## Bug Fixes++- Fixed duplicate upstream remote addition when forking+- Fixed find-skills double "skills/" prefix in output+- Removed obsolete setup-personal-superpowers call from session-start+- Fixed path references throughout hooks and commands++## Documentation++### README+- Updated for new skills repository architecture+- Prominent link to superpowers-skills repo+- Updated auto-update description+- Fixed skill names and references+- Updated Meta skills list++### Testing Documentation+- Added comprehensive testing checklist (`docs/TESTING-CHECKLIST.md`)+- Created local marketplace config for testing+- Documented manual testing scenarios++## Technical Details++### File Changes++**Added:**+- `lib/initialize-skills.sh` - Skills repo initialization and auto-update+- `docs/TESTING-CHECKLIST.md` - Manual testing scenarios+- `.claude-plugin/marketplace.json` - Local testing config++**Removed:**+- `skills/` directory (82 files) - Now in obra/superpowers-skills+- `scripts/` directory - Now in obra/superpowers-skills/skills/using-skills/+- `hooks/setup-personal-superpowers.sh` - Obsolete++**Modified:**+- `hooks/session-start.sh` - Use skills from ~/.config/superpowers/skills+- `commands/brainstorm.md` - Updated paths to SUPERPOWERS_SKILLS_ROOT+- `commands/write-plan.md` - Updated paths to SUPERPOWERS_SKILLS_ROOT+- `commands/execute-plan.md` - Updated paths to SUPERPOWERS_SKILLS_ROOT+- `README.md` - Complete rewrite for new architecture++### Commit History++This release includes:+- 20+ commits for skills repository separation+- PR #1: Amplifier-inspired problem-solving and research skills+- PR #2: Personal superpowers overlay system (later replaced)+- Multiple skill refinements and documentation improvements++## Upgrade Instructions++### Fresh Install++```bash+# In Claude Code+/plugin marketplace add obra/superpowers-marketplace+/plugin install superpowers@superpowers-marketplace+```++The plugin handles everything automatically.++### Upgrading from v1.x++1. **Backup your personal skills** (if you have any):+ ```bash+ cp -r ~/.config/superpowers/skills ~/superpowers-skills-backup+ ```++2. **Update the plugin:**+ ```bash+ /plugin update superpowers+ ```++3. **On next session start:**+ - Old installation will be backed up automatically+ - Fresh skills repo will be cloned+ - If you have GitHub CLI, you'll be offered the option to fork++4. **Migrate personal skills** (if you had any):+ - Create a branch in your local skills repo+ - Copy your personal skills from backup+ - Commit and push to your fork+ - Consider contributing back via PR++## What's Next++### For Users++- Explore the new problem-solving skills+- Try the branch-based workflow for skill improvements+- Contribute skills back to the community++### For Contributors++- Skills repository is now at https://github.com/obra/superpowers-skills+- Fork → Branch → PR workflow+- See skills/meta/writing-skills/SKILL.md for TDD approach to documentation++## Known Issues++None at this time.++## Credits++- Problem-solving skills inspired by Amplifier patterns+- Community contributions and feedback+- Extensive testing and iteration on skill effectiveness++---++**Full Changelog:** https://github.com/obra/superpowers/compare/dd013f6...main+**Skills Repository:** https://github.com/obra/superpowers-skills+**Issues:** https://github.com/obra/superpowers/issues