Skip to content

Conversation

@OniReimu
Copy link

@OniReimu OniReimu commented Jan 14, 2026

Summary

Implemented comprehensive end-to-end test suite for superpowers-ng features:

  • 2 unit tests for manus pretool hook and Ralph status block parsing
  • 3 integration tests for Ralph status emission, manus+Ralph combined workflow, and manus session resume
  • Helper functions for JSON validation, status block extraction, and file assertions
  • Complete documentation in README with test descriptions and usage

Total runtime: ~6-9 minutes (within 10-15 minute target).

Test Coverage

✓ Manus-styled planning with session persistence
✓ Ralph loop integration with status blocks
✓ Hook system and .active marker behavior
✓ EXIT_SIGNAL logic with active planning

Summary by CodeRabbit

Release Notes

  • New Features

    • Introduced Superpowers-NG with Manus-style persistent planning for long-running, multi-session tasks using file-based memory (task_plan.md, findings.md, progress.md).
    • Added Ralph autonomous loop integration for streamlined workflow automation.
    • Renamed all commands to superpowers-ng-* prefix for clarity.
  • Documentation

    • Updated comprehensive README with planning approaches and integration guides.
    • Added Ralph integration documentation and prompt templates.
  • Breaking Changes

    • Project rebranded from Superpowers to Superpowers-NG; version reset to 0.1.0.

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

OniReimu and others added 14 commits January 13, 2026 14:04
Integrate Manus-style persistent planning for long-running tasks that span
multiple sessions or exceed 50 tool calls. Introduces new manus-planning skill
with 3-file system (task_plan.md, findings.md, progress.md), archive support,
and conditional PreToolUse hooks for automatic plan reminders.

Changes:
- New manus-planning skill with 5-phase workflow and persistent memory
- Brainstorming updated to offer both Native and Manus planning options
- Added PreToolUse hook (manus-pretool.sh) for context-aware plan reminders
- Updated using-superpowers with planning approach guidance
- Rebranded from superpowers to superpowers-ng v0.1.0
- Added comprehensive README highlighting NG features
- Created new RELEASE-NOTES.md focused on v0.1.0 changes

Files:
- skills/manus-planning/SKILL.md (main skill definition)
- skills/manus-planning/templates/ (3 template files)
- commands/manus-plan.md (slash command)
- hooks/manus-pretool.sh (conditional hook script)
- hooks/hooks.json (added PreToolUse hook)
- skills/brainstorming/SKILL.md (planning choice)
- skills/using-superpowers/SKILL.md (planning guidance)
- .claude-plugin/plugin.json (rebranded metadata)
- README.md (complete rewrite for NG)
- RELEASE-NOTES.md (fresh v0.1.0)

Credits: Jesse Vincent (obra/superpowers), Ahmad Othman Ammar Adi (planning-with-files)

Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>
Adds comprehensive integration with Ralph, enabling Superpowers-NG skills to work seamlessly in autonomous loop environments:

- brainstorming: Now checks for existing design.md and skips re-brainstorming in subsequent loops
- manus-planning: Already compatible with Ralph's multi-session nature and --continue flag
- Documentation: Ralph integration guide with PROMPT.md template using official status format
- Examples: 5 concrete scenarios, circuit breaker patterns, anti-patterns, exit criteria

This enables Ralph users to:
- Design once, implement across multiple loops
- Maintain persistent memory via manus-planning files
- Keep TDD discipline throughout autonomous sessions
- Use evidence-based completion signals

Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>
@coderabbitai
Copy link

coderabbitai bot commented Jan 14, 2026

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This PR rebands the Superpowers project to Superpowers-NG (v0.1.0) with new authorship, updates the namespace from "superpowers:" to "superpowers-ng:" across all references, and introduces Manus-style persistent file-based planning with Ralph autonomous loop integration and related hooks infrastructure.

Changes

Cohort / File(s) Summary
Plugin Configuration & Metadata
.claude-plugin/plugin.json, README.md, RELEASE-NOTES.md
Updated project name to superpowers-ng, version reset to 0.1.0, authorship changed to OniReimu, added credits array, updated homepage/repository URLs, expanded keywords, and rewrote documentation to emphasize Manus planning as flagship feature
Namespace Prefix Standardization (Core)
.codex/superpowers-bootstrap.md, .codex/superpowers-codex, .opencode/plugin/superpowers.js, lib/skills-core.js
Updated namespace detection and handling from "superpowers:" to "superpowers-ng:" in skill resolution, bootstrap logic, and prefix parsing across plugin engines
Namespace Prefix Standardization (Commands)
commands/brainstorm.md, commands/execute-plan.md, commands/write-plan.md
Updated command skill references from "superpowers:..." to "superpowers-ng:..." identifiers
Manus Planning Skill
skills/manus-planning/SKILL.md, skills/manus-planning/examples.md, skills/manus-planning/templates/...
New persistent planning system with 3-file pattern (task_plan.md, findings.md, progress.md), phased workflow, templates, examples, and multi-session recovery procedures
Skills Namespace Updates
skills/{brainstorming,executing-plans,requesting-code-review,subagent-driven-development,systematic-debugging,using-superpowers,writing-plans,writing-skills}/SKILL.md
Updated required sub-skill invocations to use "superpowers-ng:" prefix and added new planning guidance; brainstorming added Phase 0 design detection
Ralph Integration Documentation
docs/ralph-integration/README.md, docs/ralph-integration/PROMPT.template.md
New Ralph loop integration guide covering architecture, status emission format, skill lifecycle, file management, and comprehensive prompt template
Hooks Infrastructure
hooks/hooks.json, hooks/manus-pretool.sh, hooks/session-start.sh
Added new PreToolUse hook group with manus-pretool.sh for conditional plan context injection based on .active marker; updated session-start namespace reference
Documentation & Examples
docs/README.codex.md, docs/README.opencode.md, docs/plans/2025-*.md
Updated example skill references to use superpowers-ng: namespace across design docs and implementation guides
Test Infrastructure
tests/claude-code/{README.md,run-skill-tests.sh,test-helpers.sh}, tests/claude-code/test-{manus-*,ralph-*}.sh
Added new test helpers (assert_file_exists, assert_file_contains, assert_valid_json, extract_ralph_status, verify_ralph_status_block) and integration tests for Manus resumption, Ralph status emission, and combined workflows
Existing Test Updates
tests/{opencode,claude-code,subagent-driven-dev}/*.sh
Updated skill namespace references from "superpowers:" to "superpowers-ng:" in test assertions and command invocations

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant Claude
    participant Hook as manus-pretool<br/>(PreToolUse)
    participant Files as docs/manus/<br/>(Persistent)
    participant Task as Task Execution

    User->>Claude: Start/Resume Task
    Claude->>Hook: PreToolUse Hook Triggered
    alt .active marker exists
        Hook->>Files: Read task_plan.md (first 30 lines)
        Files-->>Hook: Plan preview
        Hook-->>Claude: Inject plan reminder context
    else .active marker absent
        Hook-->>Claude: Empty context {}
    end
    Claude->>Files: Read task_plan.md, findings.md
    Claude->>Task: Execute phase actions
    Task->>Files: Update progress.md with results
    Claude->>Files: Update findings.md, task_plan.md
    alt Phase complete
        Claude->>Files: Mark phase status
    else Task complete
        Claude->>Files: Remove .active marker
        Claude-->>User: Announce completion
    end
Loading

Estimated Code Review Effort

🎯 4 (Complex) | ⏱️ ~60 minutes

The changes span heterogeneous edits across 50+ files with mixed complexity: consistent namespace replacements (repetitive but requiring verification), substantial new Manus planning logic with multi-phase workflows and recovery procedures (~290 lines), new hooks infrastructure with JSON/Bash integration, comprehensive Ralph integration documentation, and multiple integration test suites. Dense logic in new Manus skill templates and examples necessitates careful review for workflow correctness.

Possibly Related PRs

Poem

🐰 A fork springs forth with wings anew,
From superpowers to superpowers-ng true,
Manus planning weaves its persistent thread,
Three files remember what must be said,
Ralph loops unite with lasting grace, 🌱

✨ Finishing touches
  • 📝 Generate docstrings


📜 Recent review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b9e1649 and 57936ca.

📒 Files selected for processing (53)
  • .claude-plugin/plugin.json
  • .codex/superpowers-bootstrap.md
  • .codex/superpowers-codex
  • .opencode/plugin/superpowers.js
  • README.md
  • RELEASE-NOTES.md
  • commands/brainstorm.md
  • commands/execute-plan.md
  • commands/manus-plan.md
  • commands/write-plan.md
  • docs/README.codex.md
  • docs/README.opencode.md
  • docs/plans/2025-11-22-opencode-support-design.md
  • docs/plans/2025-11-22-opencode-support-implementation.md
  • docs/plans/2025-11-28-skills-improvements-from-user-feedback.md
  • docs/ralph-integration/PROMPT.template.md
  • docs/ralph-integration/README.md
  • hooks/hooks.json
  • hooks/manus-pretool.sh
  • hooks/session-start.sh
  • lib/skills-core.js
  • skills/brainstorming/SKILL.md
  • skills/executing-plans/SKILL.md
  • skills/manus-planning/SKILL.md
  • skills/manus-planning/examples.md
  • skills/manus-planning/templates/findings.md
  • skills/manus-planning/templates/progress.md
  • skills/manus-planning/templates/task_plan.md
  • skills/requesting-code-review/SKILL.md
  • skills/subagent-driven-development/SKILL.md
  • skills/subagent-driven-development/code-quality-reviewer-prompt.md
  • skills/systematic-debugging/SKILL.md
  • skills/using-superpowers/SKILL.md
  • skills/writing-plans/SKILL.md
  • skills/writing-skills/SKILL.md
  • skills/writing-skills/testing-skills-with-subagents.md
  • tests/claude-code/README.md
  • tests/claude-code/run-skill-tests.sh
  • tests/claude-code/test-helpers.sh
  • tests/claude-code/test-manus-pretool-hook.sh
  • tests/claude-code/test-manus-ralph-combined-integration.sh
  • tests/claude-code/test-manus-resume-integration.sh
  • tests/claude-code/test-ralph-status-blocks.sh
  • tests/claude-code/test-ralph-status-emission-integration.sh
  • tests/claude-code/test-subagent-driven-development-integration.sh
  • tests/opencode/test-priority.sh
  • tests/opencode/test-skills-core.sh
  • tests/opencode/test-tools.sh
  • tests/subagent-driven-dev/go-fractals/plan.md
  • tests/subagent-driven-dev/go-fractals/scaffold.sh
  • tests/subagent-driven-dev/run-test.sh
  • tests/subagent-driven-dev/svelte-todo/plan.md
  • tests/subagent-driven-dev/svelte-todo/scaffold.sh

✏️ Tip: You can disable this entire section by setting review_details to false in your review settings.


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

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

@OniReimu
Copy link
Author

Wrong target repository - creating PR to fork instead

@OniReimu OniReimu closed this Jan 14, 2026
@OniReimu OniReimu deleted the OniReimu/worcester branch January 14, 2026 06:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant