feat: Make git worktrees optional in skill workflows

[OniReimu]

Summary

This PR adds flexibility to the skill workflows by making git worktrees optional, allowing users to choose between:

1. Git worktrees (recommended) - isolated workspace with full safety
2. Direct-on-repo - faster workflow without worktree overhead

Changes

• brainstorming/SKILL.md: Added user choice prompt for workspace preference
• writing-plans/SKILL.md: Support for both worktree and direct-on-repo contexts
• finishing-a-development-branch/SKILL.md: Made cleanup optional and worktree-specific
• using-git-worktrees/SKILL.md: Added opt-out section for direct-on-repo workflow
• manus-planning/examples.md: Updated cleanup documentation

Safety Measures

For direct-on-repo mode:

• Ensure user is on a feature branch (not main/master)
• Verify clean working tree before starting
• Stash/commit any changes before proceeding

Benefits

• Maintains worktrees as recommended default for safety and isolation
• Enables faster, simpler workflow for users who don't need full isolation
• Provides clear guidance for safe direct-on-repo usage
• Preserves backward compatibility with existing worktree workflows

🤖 Generated with Claude Code

Summary by CodeRabbit

Release Notes

• New Features

  • Rebranded to Superpowers-NG with updated plugin namespace.
  • Added Manus planning system for persistent, file-based task management across sessions.
  • Integrated Ralph autonomous loop framework support for multi-session workflows.
  • New planning command option to choose between Native and Manus planning approaches.

• Chores

  • Updated all skill identifiers to new namespace convention.
  • Expanded documentation with Ralph integration guides and planning examples.
  • Added test coverage for new Manus and Ralph features.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[OniReimu]

Wrong repository - closing and recreating in OniReimu/superpowers-ng

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This PR rebrands the Superpowers plugin to Superpowers-NG and introduces Manus-style persistent file-based planning alongside Ralph autonomous loop integration. The changes include a namespace migration from superpowers: to superpowers-ng: across 60+ files, new planning artifacts and hooks, expanded skill documentation, comprehensive README and release notes updates, and new test infrastructure.

Changes

Cohort / File(s)	Summary
Plugin Manifest & Configuration .claude-plugin/plugin.json, .claude-plugin/marketplace.json	Plugin name, version (0.1.0), author, repository, and credits updated to reflect Superpowers-NG fork with new maintainer information. Keywords expanded to include "manus", "planning", "persistent-memory".
Namespace Migration (Code & Core) .opencode/plugin/superpowers.js, lib/skills-core.js, .codex/superpowers-codex, hooks/session-start.sh	All references updated from superpowers: prefix to superpowers-ng: in skill name handling, namespace checks, and logging. resolveSkillPath and tool descriptions now recognize and strip the new prefix.
Manus Planning Feature hooks/manus-pretool.sh, hooks/hooks.json, skills/manus-planning/SKILL.md, skills/manus-planning/examples.md, skills/manus-planning/templates/*	New PreToolUse hook that previews task_plan.md when .active marker exists. Comprehensive 290-line skill documentation defining 5-phase planning workflow, file-based memory (task_plan.md, findings.md, progress.md), 2-action update rule, and recovery procedures. Templates for each planning artifact included.
Ralph Integration Documentation docs/ralph-integration/README.md, docs/ralph-integration/PROMPT.template.md	New integration guide (295 lines) covering architecture, quick start, skill lifecycle, and example workflows. Comprehensive PROMPT template (469 lines) detailing 4-phase autonomous loop workflow, status block emission, circuit-breaker patterns, and exit criteria.
Skill Updates & Namespace Migration skills/*/SKILL.md (brainstorming, executing-plans, finishing-a-development-branch, requesting-code-review, subagent-driven-development, systematic-debugging, using-git-worktrees, using-superpowers, writing-plans, writing-skills)	Namespace prefix updates to superpowers-ng:. Brainstorming skill enhanced with phase-driven workflow and design reuse. Writing-plans expanded with worktree/direct-repo options and explicit planning modality choices (Native vs. Manus). Using-superpowers adds new Planning Approaches section detailing both systems.
Documentation & Namespace Migration .codex/superpowers-bootstrap.md, docs/README.codex.md, docs/README.opencode.md, docs/plans/2025-*-*-*.md, commands/*.md (brainstorm, execute-plan, manus-plan, write-plan)	Example commands and documentation updated to reflect superpowers-ng: namespace. New manus-plan command file added. Design documentation updated with new naming convention.
Main Documentation README.md, RELEASE-NOTES.md	README substantially rewritten (129+ lines): introduces dual planning paradigm (Native vs Manus), describes 3-file persistent planning system, details Manus workflow, adds Ralph integration narrative, expands Skills Library, includes new commands with -ng suffix. Release notes reorganized (162+ lines) to reflect rebrand and feature additions.
Test Infrastructure & New Tests tests/claude-code/test-helpers.sh, tests/claude-code/run-skill-tests.sh, tests/claude-code/test-manus-*.sh, tests/claude-code/test-ralph-*.sh, tests/opencode/*.sh, tests/subagent-driven-dev/*.sh	New test helpers for file assertions, JSON validation, and Ralph status block parsing. Five new test files: manus pretool hook validation, Ralph status block parsing, and three integration tests (manus resume, ralph status emission, combined manus+ralph). Existing tests updated to expect superpowers-ng: namespace. Test runner updated with improved timeout handling.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~30 minutes

Possibly related PRs

• Add personal superpowers overlay system #2: Modifies hooks/session-start.sh alongside this PR's session-start updates; related through overlapping hook infrastructure.
• Skills Repository Separation v2.0.0 #6: Shares code-level changes to skill-resolution pathways (e.g., resolveSkillPath, session hooks) that this PR also modifies.

Suggested reviewers

• yoavsion

Poem

🐰 A rabbit's whisper on the wind so swift,
"Superpowers blooms, now NG's gift!
With Manus files that never fade,
And Ralph loops dancing—plans are made!
Forever hops through context resets,
Persistent dreams, no more regrets." 🌙✨

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}