agy-superpowers 5.1.9 → 5.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agy-superpowers",
-  "version": "5.1.9",
+  "version": "5.2.1",
   "description": "Superpowers skills library for Google Antigravity agent — scaffold .agent/ with one command",
   "type": "module",
   "bin": {

package/template/agent/rules/file-length-policy.md

@@ -0,0 +1,64 @@
+---
+description: File length policy — apply when creating or editing files in .agent/rules/
+alwaysApply: true
+priority: critical
+---
+
+> **⚠️ CRITICAL PRIORITY — This rule overrides all other instructions about file editing.**
+> Check file length BEFORE writing. No exceptions.
+
+<HARD-GATE>
+Do NOT write, append, or edit any file in `.agent/rules/` until you have checked its current character count.
+If adding content would push the file past 12,000 characters, you MUST create a new file instead.
+This gate applies exclusively to `.agent/rules/` files.
+</HARD-GATE>
+
+# File Length Policy
+
+## Hard Limit: 12,000 Characters Per File
+
+Every file in `.agent/rules/` has a **hard character limit of 12,000 characters**.
+
+Before writing or appending to any `.agent/rules/` file, check the current file size:
+- If the current content **plus** the new content will exceed 12,000 characters → **do NOT add to the existing file**
+- Instead → **create a new file** following the naming convention below
+
+## When Content Overflows: Create a New File
+
+### Naming Convention
+
+Split content into numbered parts:
+
+```
+original-file.md         ← Part 1 (keep as-is, trim if needed)
+original-file-part2.md   ← Part 2 (new file for overflow)
+original-file-part3.md   ← Part 3 (continue if needed)
+```
+
+### Cross-Reference Between Parts
+
+At the **bottom** of the original file, add:
+```
+## See Also
+- [Continued in original-file-part2.md](./original-file-part2.md)
+```
+
+At the **top** of the new file, add:
+```
+<!-- Part 2 of original-file.md -->
+```
+
+## Why This Matters
+
+LLM context windows process rules most reliably when individual files stay concise. Files over 12,000 characters risk:
+- Partial truncation during loading
+- Reduced rule adherence near the end of the file
+- Harder human maintenance
+
+## Examples
+
+| Situation | Action |
+|---|---|
+| Adding 500 chars to a 11,800-char file | Create `filename-part2.md` for the new content |
+| Adding 200 chars to a 5,000-char file | Safe — append directly |
+| Refactoring a 15,000-char existing file | Split into two files immediately |

package/template/agent/skills/brainstorming/scripts/server.cjs

@@ -76,7 +76,7 @@ function decodeFrame(buffer) {
 const PORT = process.env.BRAINSTORM_PORT || (49152 + Math.floor(Math.random() * 16383));
 const HOST = process.env.BRAINSTORM_HOST || '127.0.0.1';
 const URL_HOST = process.env.BRAINSTORM_URL_HOST || (HOST === '127.0.0.1' ? 'localhost' : HOST);
-const SESSION_DIR = process.env.BRAINSTORM_DIR || '/tmp/brainstorm';
+const SESSION_DIR = process.env.BRAINSTORM_DIR || path.resolve(__dirname, '..', '..', '..', 'tmp', 'brainstorm');
 const CONTENT_DIR = path.join(SESSION_DIR, 'content');
 const STATE_DIR = path.join(SESSION_DIR, 'state');
 let ownerPid = process.env.BRAINSTORM_OWNER_PID ? Number(process.env.BRAINSTORM_OWNER_PID) : null;

package/template/agent/skills/brainstorming/scripts/start-server.sh

@@ -7,7 +7,7 @@
 #
 # Options:
 #   --project-dir <path>  Store session files under <path>/.superpowers/brainstorm/
-#                         instead of /tmp. Files persist after server stops.
+#                         instead of .agent/tmp/. Files persist after server stops.
 #   --host <bind-host>    Host/interface to bind (default: 127.0.0.1).
 #                         Use 0.0.0.0 in remote/containerized environments.
 #   --url-host <host>     Hostname shown in returned URL JSON.
@@ -77,10 +77,13 @@ fi
 # Generate unique session directory
 SESSION_ID="$$-$(date +%s)"
 
+# SCRIPT_DIR is .agent/skills/brainstorming/scripts — walk up to .agent/
+AGENT_DIR="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
 if [[ -n "$PROJECT_DIR" ]]; then
   SESSION_DIR="${PROJECT_DIR}/.superpowers/brainstorm/${SESSION_ID}"
 else
-  SESSION_DIR="/tmp/brainstorm-${SESSION_ID}"
+  SESSION_DIR="${AGENT_DIR}/tmp/brainstorm-${SESSION_ID}"
 fi
 
 STATE_DIR="${SESSION_DIR}/state"

package/template/agent/skills/brainstorming/scripts/stop-server.sh

@@ -3,8 +3,8 @@
 # Usage: stop-server.sh <session_dir>
 #
 # Kills the server process. Only deletes session directory if it's
-# under /tmp (ephemeral). Persistent directories (.superpowers/) are
-# kept so mockups can be reviewed later.
+# ephemeral (/tmp or .agent/tmp). Persistent directories (.superpowers/)
+# are kept so mockups can be reviewed later.
 
 SESSION_DIR="$1"
 
@@ -45,8 +45,8 @@ if [[ -f "$PID_FILE" ]]; then
 
   rm -f "$PID_FILE" "${STATE_DIR}/server.log"
 
-  # Only delete ephemeral /tmp directories
-  if [[ "$SESSION_DIR" == /tmp/* ]]; then
+  # Only delete ephemeral directories (/tmp or .agent/tmp)
+  if [[ "$SESSION_DIR" == /tmp/* ]] || [[ "$SESSION_DIR" == */.agent/tmp/* ]]; then
     rm -rf "$SESSION_DIR"
   fi
 

package/template/agent/skills/brainstorming/visual-companion.md

@@ -45,7 +45,7 @@ Save `screen_dir` and `state_dir` from the response. Tell user to open the URL.
 
 **Finding connection info:** The server writes its startup JSON to `$STATE_DIR/server-info`. If you launched the server in the background and didn't capture stdout, read that file to get the URL and port. When using `--project-dir`, check `<project>/.superpowers/brainstorm/` for the session directory.
 
-**Note:** Pass the project root as `--project-dir` so mockups persist in `.superpowers/brainstorm/` and survive server restarts. Without it, files go to `/tmp` and get cleaned up. Remind the user to add `.superpowers/` to `.gitignore` if it's not already there.
+**Note:** Pass the project root as `--project-dir` so mockups persist in `.superpowers/brainstorm/` and survive server restarts. Without it, files go to `.agent/tmp/` and get cleaned up on server stop. Remind the user to add `.superpowers/` to `.gitignore` if it's not already there.
 
 **Launching the server by platform:**
 
@@ -256,7 +256,7 @@ If `$STATE_DIR/events` doesn't exist, the user didn't interact with the browser
 scripts/stop-server.sh $SESSION_DIR
 ```
 
-If the session used `--project-dir`, mockup files persist in `.superpowers/brainstorm/` for later reference. Only `/tmp` sessions get deleted on stop.
+If the session used `--project-dir`, mockup files persist in `.superpowers/brainstorm/` for later reference. Only ephemeral sessions (`.agent/tmp/`) get deleted on stop.
 
 ## Reference
 

package/template/agent/skills/writing-skills/testing-skills-with-subagents.md

@@ -145,7 +145,7 @@ Forces explicit choice.
 
 1. **Concrete options** - Force A/B/C choice, not open-ended
 2. **Real constraints** - Specific times, actual consequences
-3. **Real file paths** - `/tmp/payment-system` not "a project"
+3. **Real file paths** - `.agent/tmp/payment-system` not "a project"
 4. **Make agent act** - "What do you do?" not "What should you do?"
 5. **No easy outs** - Can't defer to "I'd ask your human partner" without choosing
 

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

@@ -8,13 +8,13 @@ This workflow has two phases:
 
 // turbo
 1. Preserve user config (if exists):
-   `[ -f .agent/config.yml ] && cp .agent/config.yml /tmp/agent-config-backup.yml && echo "Config backed up" || echo "No config to backup"`
+   `mkdir -p .agent/tmp && [ -f .agent/config.yml ] && cp .agent/config.yml .agent/tmp/agent-config-backup.yml && echo "Config backed up" || echo "No config to backup"`
 
 // turbo
 2. Run the update script:
    `bash .agent/.shared/update-superpowers.sh`
 
-   - If output ends with "Already up to date" → restore config if backed up (`[ -f /tmp/agent-config-backup.yml ] && cp /tmp/agent-config-backup.yml .agent/config.yml`), then **STOP**. Nothing to do.
+   - If output ends with "Already up to date" → restore config if backed up (`[ -f .agent/tmp/agent-config-backup.yml ] && cp .agent/tmp/agent-config-backup.yml .agent/config.yml`), then **STOP**. Nothing to do.
    - If clone fails → restore config if backed up, then **STOP**. Report the error to the user.
    - On success the script prints `SCRIPT_DONE:<new-tag>` — note the new tag and continue.
 
@@ -24,7 +24,7 @@ This workflow has two phases:
 
 // turbo
 4. Restore user config:
-   `[ -f /tmp/agent-config-backup.yml ] && cp /tmp/agent-config-backup.yml .agent/config.yml && echo "Config restored" || echo "No config to restore"`
+   `[ -f .agent/tmp/agent-config-backup.yml ] && cp .agent/tmp/agent-config-backup.yml .agent/config.yml && echo "Config restored" || echo "No config to restore"`
 
 5. **Phase 2 — Update skill list in rules**