npm - workerssuper - Versions diffs - 5.0.4 - Mend

workerssuper 5.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (135) hide show

package/.claude-plugin/marketplace.json +20 -0
package/.claude-plugin/plugin.json +13 -0
package/.codex/INSTALL.md +67 -0
package/.cursor-plugin/plugin.json +18 -0
package/.gitattributes +18 -0
package/.github/FUNDING.yml +3 -0
package/.github/ISSUE_TEMPLATE/bug_report.md +52 -0
package/.github/ISSUE_TEMPLATE/config.yml +5 -0
package/.github/ISSUE_TEMPLATE/feature_request.md +34 -0
package/.github/ISSUE_TEMPLATE/platform_support.md +23 -0
package/.github/PULL_REQUEST_TEMPLATE.md +87 -0
package/.opencode/INSTALL.md +83 -0
package/.opencode/plugins/superpowers.js +107 -0
package/CHANGELOG.md +13 -0
package/CODE_OF_CONDUCT.md +128 -0
package/GEMINI.md +2 -0
package/LICENSE +21 -0
package/README.md +187 -0
package/RELEASE-NOTES.md +1057 -0
package/agents/code-reviewer.md +48 -0
package/commands/brainstorm.md +5 -0
package/commands/execute-plan.md +5 -0
package/commands/write-plan.md +5 -0
package/docs/README.codex.md +126 -0
package/docs/README.opencode.md +130 -0
package/docs/plans/2025-11-22-opencode-support-design.md +294 -0
package/docs/plans/2025-11-22-opencode-support-implementation.md +1095 -0
package/docs/plans/2025-11-28-skills-improvements-from-user-feedback.md +711 -0
package/docs/plans/2026-01-17-visual-brainstorming.md +571 -0
package/docs/superpowers/plans/2026-01-22-document-review-system.md +301 -0
package/docs/superpowers/plans/2026-02-19-visual-brainstorming-refactor.md +523 -0
package/docs/superpowers/plans/2026-03-11-zero-dep-brainstorm-server.md +479 -0
package/docs/superpowers/specs/2026-01-22-document-review-system-design.md +136 -0
package/docs/superpowers/specs/2026-02-19-visual-brainstorming-refactor-design.md +162 -0
package/docs/superpowers/specs/2026-03-11-zero-dep-brainstorm-server-design.md +118 -0
package/docs/testing.md +303 -0
package/docs/windows/polyglot-hooks.md +212 -0
package/gemini-extension.json +6 -0
package/hooks/hooks-cursor.json +10 -0
package/hooks/hooks.json +16 -0
package/hooks/run-hook.cmd +46 -0
package/hooks/session-start +57 -0
package/package.json +5 -0
package/skills/brainstorming/SKILL.md +164 -0
package/skills/brainstorming/scripts/frame-template.html +214 -0
package/skills/brainstorming/scripts/helper.js +88 -0
package/skills/brainstorming/scripts/server.cjs +338 -0
package/skills/brainstorming/scripts/start-server.sh +153 -0
package/skills/brainstorming/scripts/stop-server.sh +55 -0
package/skills/brainstorming/spec-document-reviewer-prompt.md +49 -0
package/skills/brainstorming/visual-companion.md +286 -0
package/skills/dispatching-parallel-agents/SKILL.md +182 -0
package/skills/executing-plans/SKILL.md +70 -0
package/skills/finishing-a-development-branch/SKILL.md +200 -0
package/skills/receiving-code-review/SKILL.md +213 -0
package/skills/requesting-code-review/SKILL.md +105 -0
package/skills/requesting-code-review/code-reviewer.md +146 -0
package/skills/subagent-driven-development/SKILL.md +277 -0
package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +26 -0
package/skills/subagent-driven-development/implementer-prompt.md +113 -0
package/skills/subagent-driven-development/spec-reviewer-prompt.md +61 -0
package/skills/systematic-debugging/CREATION-LOG.md +119 -0
package/skills/systematic-debugging/SKILL.md +296 -0
package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -0
package/skills/systematic-debugging/condition-based-waiting.md +115 -0
package/skills/systematic-debugging/defense-in-depth.md +122 -0
package/skills/systematic-debugging/find-polluter.sh +63 -0
package/skills/systematic-debugging/root-cause-tracing.md +169 -0
package/skills/systematic-debugging/test-academic.md +14 -0
package/skills/systematic-debugging/test-pressure-1.md +58 -0
package/skills/systematic-debugging/test-pressure-2.md +68 -0
package/skills/systematic-debugging/test-pressure-3.md +69 -0
package/skills/test-driven-development/SKILL.md +371 -0
package/skills/test-driven-development/testing-anti-patterns.md +299 -0
package/skills/using-git-worktrees/SKILL.md +218 -0
package/skills/using-superpowers/SKILL.md +115 -0
package/skills/using-superpowers/references/codex-tools.md +25 -0
package/skills/using-superpowers/references/gemini-tools.md +33 -0
package/skills/verification-before-completion/SKILL.md +139 -0
package/skills/writing-plans/SKILL.md +145 -0
package/skills/writing-plans/plan-document-reviewer-prompt.md +49 -0
package/skills/writing-skills/SKILL.md +655 -0
package/skills/writing-skills/anthropic-best-practices.md +1150 -0
package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
package/skills/writing-skills/graphviz-conventions.dot +172 -0
package/skills/writing-skills/persuasion-principles.md +187 -0
package/skills/writing-skills/render-graphs.js +168 -0
package/skills/writing-skills/testing-skills-with-subagents.md +384 -0
package/tests/brainstorm-server/package-lock.json +36 -0
package/tests/brainstorm-server/package.json +10 -0
package/tests/brainstorm-server/server.test.js +424 -0
package/tests/brainstorm-server/windows-lifecycle.test.sh +351 -0
package/tests/brainstorm-server/ws-protocol.test.js +392 -0
package/tests/claude-code/README.md +158 -0
package/tests/claude-code/analyze-token-usage.py +168 -0
package/tests/claude-code/run-skill-tests.sh +187 -0
package/tests/claude-code/test-document-review-system.sh +177 -0
package/tests/claude-code/test-helpers.sh +202 -0
package/tests/claude-code/test-subagent-driven-development-integration.sh +314 -0
package/tests/claude-code/test-subagent-driven-development.sh +165 -0
package/tests/explicit-skill-requests/prompts/action-oriented.txt +3 -0
package/tests/explicit-skill-requests/prompts/after-planning-flow.txt +17 -0
package/tests/explicit-skill-requests/prompts/claude-suggested-it.txt +11 -0
package/tests/explicit-skill-requests/prompts/i-know-what-sdd-means.txt +8 -0
package/tests/explicit-skill-requests/prompts/mid-conversation-execute-plan.txt +3 -0
package/tests/explicit-skill-requests/prompts/please-use-brainstorming.txt +1 -0
package/tests/explicit-skill-requests/prompts/skip-formalities.txt +3 -0
package/tests/explicit-skill-requests/prompts/subagent-driven-development-please.txt +1 -0
package/tests/explicit-skill-requests/prompts/use-systematic-debugging.txt +1 -0
package/tests/explicit-skill-requests/run-all.sh +70 -0
package/tests/explicit-skill-requests/run-claude-describes-sdd.sh +100 -0
package/tests/explicit-skill-requests/run-extended-multiturn-test.sh +113 -0
package/tests/explicit-skill-requests/run-haiku-test.sh +144 -0
package/tests/explicit-skill-requests/run-multiturn-test.sh +143 -0
package/tests/explicit-skill-requests/run-test.sh +136 -0
package/tests/opencode/run-tests.sh +163 -0
package/tests/opencode/setup.sh +73 -0
package/tests/opencode/test-plugin-loading.sh +72 -0
package/tests/opencode/test-priority.sh +198 -0
package/tests/opencode/test-tools.sh +104 -0
package/tests/skill-triggering/prompts/dispatching-parallel-agents.txt +8 -0
package/tests/skill-triggering/prompts/executing-plans.txt +1 -0
package/tests/skill-triggering/prompts/requesting-code-review.txt +3 -0
package/tests/skill-triggering/prompts/systematic-debugging.txt +11 -0
package/tests/skill-triggering/prompts/test-driven-development.txt +7 -0
package/tests/skill-triggering/prompts/writing-plans.txt +10 -0
package/tests/skill-triggering/run-all.sh +60 -0
package/tests/skill-triggering/run-test.sh +88 -0
package/tests/subagent-driven-dev/go-fractals/design.md +81 -0
package/tests/subagent-driven-dev/go-fractals/plan.md +172 -0
package/tests/subagent-driven-dev/go-fractals/scaffold.sh +45 -0
package/tests/subagent-driven-dev/run-test.sh +106 -0
package/tests/subagent-driven-dev/svelte-todo/design.md +70 -0
package/tests/subagent-driven-dev/svelte-todo/plan.md +222 -0
package/tests/subagent-driven-dev/svelte-todo/scaffold.sh +46 -0

package/docs/plans/2026-01-17-visual-brainstorming.md ADDED Viewed

@@ -0,0 +1,571 @@
+# Visual Brainstorming Companion Implementation Plan
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+**Goal:** Give Claude a browser-based visual companion for brainstorming sessions - show mockups, prototypes, and interactive choices alongside terminal conversation.
+**Architecture:** Claude writes HTML to a temp file. A local Node.js server watches that file and serves it with an auto-injected helper library. User interactions flow via WebSocket to server stdout, which Claude sees in background task output.
+**Tech Stack:** Node.js, Express, ws (WebSocket), chokidar (file watching)
+---
+## Task 1: Create the Server Foundation
+**Files:**
+- Create: `lib/brainstorm-server/index.js`
+- Create: `lib/brainstorm-server/package.json`
+**Step 1: Create package.json**
+```json
+{
+  "name": "brainstorm-server",
+  "version": "1.0.0",
+  "description": "Visual brainstorming companion server for Claude Code",
+  "main": "index.js",
+  "dependencies": {
+    "chokidar": "^3.5.3",
+    "express": "^4.18.2",
+    "ws": "^8.14.2"
+  }
+}
+```
+**Step 2: Create minimal server that starts**
+```javascript
+const express = require('express');
+const http = require('http');
+const WebSocket = require('ws');
+const chokidar = require('chokidar');
+const fs = require('fs');
+const path = require('path');
+const PORT = process.env.BRAINSTORM_PORT || 3333;
+const SCREEN_FILE = process.env.BRAINSTORM_SCREEN || '/tmp/brainstorm/screen.html';
+const SCREEN_DIR = path.dirname(SCREEN_FILE);
+// Ensure screen directory exists
+if (!fs.existsSync(SCREEN_DIR)) {
+  fs.mkdirSync(SCREEN_DIR, { recursive: true });
+}
+// Create default screen if none exists
+if (!fs.existsSync(SCREEN_FILE)) {
+  fs.writeFileSync(SCREEN_FILE, `<!DOCTYPE html>
+<html>
+<head>
+  <title>Brainstorm Companion</title>
+  <style>
+    body { font-family: system-ui, sans-serif; padding: 2rem; max-width: 800px; margin: 0 auto; }
+    h1 { color: #333; }
+    p { color: #666; }
+  </style>
+</head>
+<body>
+  <h1>Brainstorm Companion</h1>
+  <p>Waiting for Claude to push a screen...</p>
+</body>
+</html>`);
+}
+const app = express();
+const server = http.createServer(app);
+const wss = new WebSocket.Server({ server });
+// Track connected browsers for reload notifications
+const clients = new Set();
+wss.on('connection', (ws) => {
+  clients.add(ws);
+  ws.on('close', () => clients.delete(ws));
+  ws.on('message', (data) => {
+    // User interaction event - write to stdout for Claude
+    const event = JSON.parse(data.toString());
+    console.log(JSON.stringify({ type: 'user-event', ...event }));
+  });
+});
+// Serve current screen with helper.js injected
+app.get('/', (req, res) => {
+  let html = fs.readFileSync(SCREEN_FILE, 'utf-8');
+  // Inject helper script before </body>
+  const helperScript = fs.readFileSync(path.join(__dirname, 'helper.js'), 'utf-8');
+  const injection = `<script>\n${helperScript}\n</script>`;
+  if (html.includes('</body>')) {
+    html = html.replace('</body>', `${injection}\n</body>`);
+  } else {
+    html += injection;
+  }
+  res.type('html').send(html);
+});
+// Watch for screen file changes
+chokidar.watch(SCREEN_FILE).on('change', () => {
+  console.log(JSON.stringify({ type: 'screen-updated', file: SCREEN_FILE }));
+  // Notify all browsers to reload
+  clients.forEach(ws => {
+    if (ws.readyState === WebSocket.OPEN) {
+      ws.send(JSON.stringify({ type: 'reload' }));
+    }
+  });
+});
+server.listen(PORT, '127.0.0.1', () => {
+  console.log(JSON.stringify({ type: 'server-started', port: PORT, url: `http://localhost:${PORT}` }));
+});
+```
+**Step 3: Run npm install**
+Run: `cd lib/brainstorm-server && npm install`
+Expected: Dependencies installed
+**Step 4: Test server starts**
+Run: `cd lib/brainstorm-server && timeout 3 node index.js || true`
+Expected: See JSON with `server-started` and port info
+**Step 5: Commit**
+```bash
+git add lib/brainstorm-server/
+git commit -m "feat: add brainstorm server foundation"
+```
+---
+## Task 2: Create the Helper Library
+**Files:**
+- Create: `lib/brainstorm-server/helper.js`
+**Step 1: Create helper.js with event auto-capture**
+```javascript
+(function() {
+  const WS_URL = 'ws://' + window.location.host;
+  let ws = null;
+  let eventQueue = [];
+  function connect() {
+    ws = new WebSocket(WS_URL);
+    ws.onopen = () => {
+      // Send any queued events
+      eventQueue.forEach(e => ws.send(JSON.stringify(e)));
+      eventQueue = [];
+    };
+    ws.onmessage = (msg) => {
+      const data = JSON.parse(msg.data);
+      if (data.type === 'reload') {
+        window.location.reload();
+      }
+    };
+    ws.onclose = () => {
+      // Reconnect after 1 second
+      setTimeout(connect, 1000);
+    };
+  }
+  function send(event) {
+    event.timestamp = Date.now();
+    if (ws && ws.readyState === WebSocket.OPEN) {
+      ws.send(JSON.stringify(event));
+    } else {
+      eventQueue.push(event);
+    }
+  }
+  // Auto-capture clicks on interactive elements
+  document.addEventListener('click', (e) => {
+    const target = e.target.closest('button, a, [data-choice], [role="button"], input[type="submit"]');
+    if (!target) return;
+    // Don't capture regular link navigation
+    if (target.tagName === 'A' && !target.dataset.choice) return;
+    e.preventDefault();
+    send({
+      type: 'click',
+      text: target.textContent.trim(),
+      choice: target.dataset.choice || null,
+      id: target.id || null,
+      className: target.className || null
+    });
+  });
+  // Auto-capture form submissions
+  document.addEventListener('submit', (e) => {
+    e.preventDefault();
+    const form = e.target;
+    const formData = new FormData(form);
+    const data = {};
+    formData.forEach((value, key) => { data[key] = value; });
+    send({
+      type: 'submit',
+      formId: form.id || null,
+      formName: form.name || null,
+      data: data
+    });
+  });
+  // Auto-capture input changes (debounced)
+  let inputTimeout = null;
+  document.addEventListener('input', (e) => {
+    const target = e.target;
+    if (!target.matches('input, textarea, select')) return;
+    clearTimeout(inputTimeout);
+    inputTimeout = setTimeout(() => {
+      send({
+        type: 'input',
+        name: target.name || null,
+        id: target.id || null,
+        value: target.value,
+        inputType: target.type || target.tagName.toLowerCase()
+      });
+    }, 500); // 500ms debounce
+  });
+  // Expose for explicit use if needed
+  window.brainstorm = {
+    send: send,
+    choice: (value, metadata = {}) => send({ type: 'choice', value, ...metadata })
+  };
+  connect();
+})();
+```
+**Step 2: Verify helper.js is syntactically valid**
+Run: `node -c lib/brainstorm-server/helper.js`
+Expected: No syntax errors
+**Step 3: Commit**
+```bash
+git add lib/brainstorm-server/helper.js
+git commit -m "feat: add browser helper library for event capture"
+```
+---
+## Task 3: Write Tests for the Server
+**Files:**
+- Create: `tests/brainstorm-server/server.test.js`
+- Create: `tests/brainstorm-server/package.json`
+**Step 1: Create test package.json**
+```json
+{
+  "name": "brainstorm-server-tests",
+  "version": "1.0.0",
+  "scripts": {
+    "test": "node server.test.js"
+  }
+}
+```
+**Step 2: Write server tests**
+```javascript
+const { spawn } = require('child_process');
+const http = require('http');
+const WebSocket = require('ws');
+const fs = require('fs');
+const path = require('path');
+const assert = require('assert');
+const SERVER_PATH = path.join(__dirname, '../../lib/brainstorm-server/index.js');
+const TEST_PORT = 3334;
+const TEST_SCREEN = '/tmp/brainstorm-test/screen.html';
+// Clean up test directory
+function cleanup() {
+  if (fs.existsSync(path.dirname(TEST_SCREEN))) {
+    fs.rmSync(path.dirname(TEST_SCREEN), { recursive: true });
+  }
+}
+async function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+async function fetch(url) {
+  return new Promise((resolve, reject) => {
+    http.get(url, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => resolve({ status: res.statusCode, body: data }));
+    }).on('error', reject);
+  });
+}
+async function runTests() {
+  cleanup();
+  // Start server
+  const server = spawn('node', [SERVER_PATH], {
+    env: { ...process.env, BRAINSTORM_PORT: TEST_PORT, BRAINSTORM_SCREEN: TEST_SCREEN }
+  });
+  let stdout = '';
+  server.stdout.on('data', (data) => { stdout += data.toString(); });
+  server.stderr.on('data', (data) => { console.error('Server stderr:', data.toString()); });
+  await sleep(1000); // Wait for server to start
+  try {
+    // Test 1: Server starts and outputs JSON
+    console.log('Test 1: Server startup message');
+    assert(stdout.includes('server-started'), 'Should output server-started');
+    assert(stdout.includes(TEST_PORT.toString()), 'Should include port');
+    console.log('  PASS');
+    // Test 2: GET / returns HTML with helper injected
+    console.log('Test 2: Serves HTML with helper injected');
+    const res = await fetch(`http://localhost:${TEST_PORT}/`);
+    assert.strictEqual(res.status, 200);
+    assert(res.body.includes('brainstorm'), 'Should include brainstorm content');
+    assert(res.body.includes('WebSocket'), 'Should have helper.js injected');
+    console.log('  PASS');
+    // Test 3: WebSocket connection and event relay
+    console.log('Test 3: WebSocket relays events to stdout');
+    stdout = ''; // Reset stdout capture
+    const ws = new WebSocket(`ws://localhost:${TEST_PORT}`);
+    await new Promise(resolve => ws.on('open', resolve));
+    ws.send(JSON.stringify({ type: 'click', text: 'Test Button' }));
+    await sleep(100);
+    assert(stdout.includes('user-event'), 'Should relay user events');
+    assert(stdout.includes('Test Button'), 'Should include event data');
+    ws.close();
+    console.log('  PASS');
+    // Test 4: File change triggers reload notification
+    console.log('Test 4: File change notifies browsers');
+    const ws2 = new WebSocket(`ws://localhost:${TEST_PORT}`);
+    await new Promise(resolve => ws2.on('open', resolve));
+    let gotReload = false;
+    ws2.on('message', (data) => {
+      const msg = JSON.parse(data.toString());
+      if (msg.type === 'reload') gotReload = true;
+    });
+    // Modify the screen file
+    fs.writeFileSync(TEST_SCREEN, '<html><body>Updated</body></html>');
+    await sleep(500);
+    assert(gotReload, 'Should send reload message on file change');
+    ws2.close();
+    console.log('  PASS');
+    console.log('\nAll tests passed!');
+  } finally {
+    server.kill();
+    cleanup();
+  }
+}
+runTests().catch(err => {
+  console.error('Test failed:', err);
+  process.exit(1);
+});
+```
+**Step 3: Run tests**
+Run: `cd tests/brainstorm-server && npm install ws && node server.test.js`
+Expected: All tests pass
+**Step 4: Commit**
+```bash
+git add tests/brainstorm-server/
+git commit -m "test: add brainstorm server integration tests"
+```
+---
+## Task 4: Add Visual Companion to Brainstorming Skill
+**Files:**
+- Modify: `skills/brainstorming/SKILL.md`
+- Create: `skills/brainstorming/visual-companion.md` (supporting doc)
+**Step 1: Create the supporting documentation**
+Create `skills/brainstorming/visual-companion.md`:
+```markdown
+# Visual Companion Reference
+## Starting the Server
+Run as a background job:
+```bash
+node ${PLUGIN_ROOT}/lib/brainstorm-server/index.js
+```
+Tell the user: "I've started a visual companion at http://localhost:3333 - open it in a browser."
+## Pushing Screens
+Write HTML to `/tmp/brainstorm/screen.html`. The server watches this file and auto-refreshes the browser.
+## Reading User Responses
+Check the background task output for JSON events:
+```json
+{"type":"user-event","type":"click","text":"Option A","choice":"optionA","timestamp":1234567890}
+{"type":"user-event","type":"submit","data":{"notes":"My feedback"},"timestamp":1234567891}
+```
+Event types:
+- **click**: User clicked button or `data-choice` element
+- **submit**: User submitted form (includes all form data)
+- **input**: User typed in field (debounced 500ms)
+## HTML Patterns
+### Choice Cards
+```html
+<div class="options">
+  <button data-choice="optionA">
+    <h3>Option A</h3>
+    <p>Description</p>
+  </button>
+  <button data-choice="optionB">
+    <h3>Option B</h3>
+    <p>Description</p>
+  </button>
+</div>
+```
+### Interactive Mockup
+```html
+<div class="mockup">
+  <header data-choice="header">App Header</header>
+  <nav data-choice="nav">Navigation</nav>
+  <main data-choice="main">Content</main>
+</div>
+```
+### Form with Notes
+```html
+<form>
+  <label>Priority: <input type="range" name="priority" min="1" max="5"></label>
+  <textarea name="notes" placeholder="Additional thoughts..."></textarea>
+  <button type="submit">Submit</button>
+</form>
+```
+### Explicit JavaScript
+```html
+<button onclick="brainstorm.choice('custom', {extra: 'data'})">Custom</button>
+```
+```
+**Step 2: Add visual companion section to brainstorming skill**
+Add after "Key Principles" in `skills/brainstorming/SKILL.md`:
+```markdown
+## Visual Companion (Optional)
+When brainstorming involves visual elements - UI mockups, wireframes, interactive prototypes - use the browser-based visual companion.
+**When to use:**
+- Presenting UI/UX options that benefit from visual comparison
+- Showing wireframes or layout options
+- Gathering structured feedback (ratings, forms)
+- Prototyping click interactions
+**How it works:**
+1. Start the server as a background job
+2. Tell user to open http://localhost:3333
+3. Write HTML to `/tmp/brainstorm/screen.html` (auto-refreshes)
+4. Check background task output for user interactions
+The terminal remains the primary conversation interface. The browser is a visual aid.
+**Reference:** See `visual-companion.md` in this skill directory for HTML patterns and API details.
+```
+**Step 3: Verify the edits**
+Run: `grep -A5 "Visual Companion" skills/brainstorming/SKILL.md`
+Expected: Shows the new section
+**Step 4: Commit**
+```bash
+git add skills/brainstorming/
+git commit -m "feat: add visual companion to brainstorming skill"
+```
+---
+## Task 5: Add Server to Plugin Ignore (Optional Cleanup)
+**Files:**
+- Check if `.gitignore` needs node_modules exclusion for lib/brainstorm-server
+**Step 1: Check current gitignore**
+Run: `cat .gitignore 2>/dev/null || echo "No .gitignore"`
+**Step 2: Add node_modules if needed**
+If not already present, add:
+```
+lib/brainstorm-server/node_modules/
+```
+**Step 3: Commit if changed**
+```bash
+git add .gitignore
+git commit -m "chore: ignore brainstorm-server node_modules"
+```
+---
+## Summary
+After completing all tasks:
+1. **Server** at `lib/brainstorm-server/` - Node.js server that watches HTML file and relays events
+2. **Helper library** auto-injected - captures clicks, forms, inputs
+3. **Tests** at `tests/brainstorm-server/` - verifies server behavior
+4. **Brainstorming skill** updated with visual companion section and `visual-companion.md` reference doc
+**To use:**
+1. Start server as background job: `node lib/brainstorm-server/index.js &`
+2. Tell user to open `http://localhost:3333`
+3. Write HTML to `/tmp/brainstorm/screen.html`
+4. Check task output for user events