Skip to content

Port upstream improvements from superpowers - #42

Merged
RomarQ merged 5 commits into
mainfrom
port-upstream-improvements
Apr 13, 2026
Merged

Port upstream improvements from superpowers#42
RomarQ merged 5 commits into
mainfrom
port-upstream-improvements

Conversation

@RomarQ

@RomarQ RomarQ commented Apr 13, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Brainstorm server reliability: validate owner PID at startup (WSL/SSH resilience), fix EPERM handling for cross-user scenarios, separate content/state directories for cleaner session management
  • Graceful server shutdown: stop-server.sh now retries with SIGKILL fallback and verifies the process actually stopped
  • Inline spec self-review: replace subagent spec review dispatch loop with quick inline checks (placeholders, consistency, scope, ambiguity), validated upstream as more effective
  • Shell portability: portable shebangs (#!/usr/bin/env bash), Windows/Git Bash auto-foreground detection
  • Documentation: add subagent context paragraphs to dispatching-parallel-agents and subagent-driven-development skills, update visual-companion.md for content/state separation and Windows platform

Port reliability, architecture, and documentation improvements:

- Brainstorm server: validate owner PID at startup, fix EPERM handling,
  separate content/state directories for cleaner session management
- stop-server.sh: graceful shutdown with SIGKILL fallback and verification
- start-server.sh: content/state directory structure, Windows/Git Bash
  auto-foreground detection, portable shebang
- Brainstorming SKILL: replace subagent spec review loop with inline
  self-review (validated upstream as more effective)
- Add subagent context paragraphs to dispatching-parallel-agents and
  subagent-driven-development skills
- visual-companion.md: update for content/state separation, add Windows
  platform instructions
RomarQ added 2 commits April 13, 2026 11:30
The agent receives screen_dir and state_dir from server output but
stop-server.sh expects the parent session directory. Use dirname to
derive it from state_dir rather than referencing an undefined variable.
SESSION_DIR is clear enough from context in the doc. The agent can
derive it from the JSON example showing screen_dir and state_dir
as children of the session directory.
@RomarQ RomarQ changed the title Port upstream improvements from obra/superpowers Port upstream improvements from superpowers Apr 13, 2026
RomarQ added 2 commits April 13, 2026 11:34
- Use 4-space indentation to match project shfmt config (-i 4 -ci)
- Replace unused loop variable 'i' with '_' to fix SC2034
Fixes pre-existing markdownlint MD012 violation.
@RomarQ
RomarQ merged commit 41ddaae into main Apr 13, 2026
6 checks passed
@RomarQ
RomarQ deleted the port-upstream-improvements branch April 13, 2026 11:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant