hail-hydra-cc 2.3.0 → 2.3.2

package/files/skills/stfu-agents/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: STFU Agents
+description: >
+  Apply internal-thinking compression to every subagent dispatched in this
+  session. Reduces wasted tokens in subagent context windows that the
+  orchestrator never reads. Works on any subagent — Hydra's, third-party,
+  or Claude Code's built-in agents. Opt-in; session-scoped; runtime-only.
+trigger: /hydra:stfu OR /skills stfu-agents OR user says "STFU agents",
+         "shut up agents", "quiet agents", or "compress all agents"
+---
+
+# STFU-Agents Mode
+
+When this skill is active, the orchestrator (Opus) prepends an internal-thinking compression directive to EVERY Task tool dispatch — regardless of which agent.
+
+## Behavior — Orchestrator (Opus)
+
+When dispatching any subagent via the Task tool, prepend this directive to the `prompt` argument:
+
+```
+[INTERNAL-COMPRESSION DIRECTIVE — STFU-Agents mode active]
+Your internal reasoning is billed but never read — only your final summary returns to the orchestrator. Therefore:
+1. Skip preambles ("Let me…", "I'll examine…", "First I need to…")
+2. Skip step announcements ("Step 1:", "Now let me…")
+3. Skip transition prose between tool calls
+4. Skip restatements of tool outputs (they're already in your context)
+5. Act first, summarize at the end
+Maintain whatever output format your role requires. Just keep the path from task → output terse internally.
+```
+
+## Activation
+- `/hydra:stfu`
+- `/skills stfu-agents` or `/skills STFU Agents`
+- Natural language: "STFU agents", "shut up agents", "quiet agents", "compress all agents"
+
+## Scope
+- Hydra's own subagents (already have Tier 3 — harmless reinforcement)
+- Third-party subagents installed by the user
+- Claude Code's built-in subagents (Explore, etc.)
+- User-defined custom subagents
+
+Does NOT apply to:
+- The main orchestrator (Opus) — orchestrator follows SKILL.md's own response rules
+- Direct user-facing responses
+
+## Deactivation
+- `/skills` (clear active skills)
+- Natural language: "verbose agents", "stop STFU"
+
+## When NOT to use
+- Debugging a subagent's behavior (you want to see its reasoning)
+- Teaching the user how subagents work
+- User explicitly asked for verbose mode
+
+## Compatibility
+Purely additive at runtime. No agent files modified. If a subagent ignores the directive, no harm done — falls back to baseline. Coexists with any other skill or framework.
+
+## Risk Disclosure
+STFU-Agents adds a directive to subagents Hydra does not own. While the directive is additive and harmless in principle, it has not been tested against every possible subagent definition. Activate explicitly; deactivate if anything looks off.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hail-hydra-cc",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "description": "Multi-agent orchestration framework for Claude Code. Routes tasks to specialized Haiku/Sonnet subagents while Opus orchestrates — inspired by speculative decoding. ~50% API cost reduction.",
   "bin": {
     "hail-hydra-cc": "bin/cli.js"

package/src/files.js

@@ -1,105 +1,106 @@
-'use strict';
-
-/**
- * All Hydra framework files are bundled inside the npm package under the
- * files/ directory. Reading them at require-time guarantees:
- *  - No network requests — works fully offline
- *  - No write-time escaping headaches for markdown content
- *  - Standard npm bundling via the "files" field in package.json
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const FILES_DIR = path.join(__dirname, '..', 'files');
-
-function readBundled(relPath) {
-  return fs.readFileSync(path.join(FILES_DIR, relPath), 'utf8');
-}
-
-const agents = {
-  'hydra-scout': {
-    content: readBundled('agents/hydra-scout.md'),
-    model: 'Haiku',
-    display: 'hydra-scout (Haiku)    — Codebase exploration',
-  },
-  'hydra-runner': {
-    content: readBundled('agents/hydra-runner.md'),
-    model: 'Haiku',
-    display: 'hydra-runner (Haiku)   — Test execution & validation',
-  },
-  'hydra-scribe': {
-    content: readBundled('agents/hydra-scribe.md'),
-    model: 'Haiku',
-    display: 'hydra-scribe (Haiku)   — Documentation writing',
-  },
-  'hydra-coder': {
-    content: readBundled('agents/hydra-coder.md'),
-    model: 'Sonnet',
-    display: 'hydra-coder (Sonnet)   — Code implementation',
-  },
-  'hydra-analyst': {
-    content: readBundled('agents/hydra-analyst.md'),
-    model: 'Sonnet',
-    display: 'hydra-analyst (Sonnet) — Code review & debugging',
-  },
-  'hydra-guard': {
-    content: readBundled('agents/hydra-guard.md'),
-    model: 'Haiku',
-    display: 'hydra-guard (Haiku)    — Auto-protection & safety',
-  },
-  'hydra-git': {
-    content: readBundled('agents/hydra-git.md'),
-    model: 'Haiku',
-    display: 'hydra-git (Haiku)      — Git operations',
-  },
-  'hydra-sentinel-scan': {
-    content: readBundled('agents/hydra-sentinel-scan.md'),
-    model: 'Haiku',
-    display: 'hydra-sentinel-scan (Haiku) — Fast integration sweep',
-  },
-  'hydra-sentinel': {
-    content: readBundled('agents/hydra-sentinel.md'),
-    model: 'Sonnet',
-    display: 'hydra-sentinel (Sonnet) — Deep integration analysis',
-  },
-  'hydra-preflight': {
-    content: readBundled('agents/hydra-preflight.md'),
-    model: 'Haiku',
-    display: 'hydra-preflight (Haiku) — Environment preflight check',
-  },
-};
-
-const skill = readBundled('SKILL.md');
-
-const references = {
-  'routing-guide': readBundled('references/routing-guide.md'),
-  'model-capabilities': readBundled('references/model-capabilities.md'),
-};
-
-const commands = {
-  'update':   readBundled('commands/hydra/update.md'),
-  'status':   readBundled('commands/hydra/status.md'),
-  'help':     readBundled('commands/hydra/help.md'),
-  'config':   readBundled('commands/hydra/config.md'),
-  'guard':    readBundled('commands/hydra/guard.md'),
-  'quiet':    readBundled('commands/hydra/quiet.md'),
-  'verbose':  readBundled('commands/hydra/verbose.md'),
-  'report':   readBundled('commands/hydra/report.md'),
-  'map':      readBundled('commands/hydra/map.md'),
-  'preflight': readBundled('commands/hydra/preflight.md'),
-  'stats':    readBundled('commands/hydra/stats.md'),
-};
-
-const hooks = {
-  'hydra-check-update': readBundled('hooks/hydra-check-update.js'),
-  'hydra-statusline':   readBundled('hooks/hydra-statusline.js'),
-  'hydra-auto-guard':   readBundled('hooks/hydra-auto-guard.js'),
-  'hydra-notify':       readBundled('hooks/hydra-notify.js'),
-};
-
-const binaryHooks = {
-  'hydra-task-complete.wav': path.join(FILES_DIR, 'hooks', 'hydra-task-complete.wav'),
-};
-
-module.exports = { agents, skill, references, commands, hooks, binaryHooks };
+'use strict';
+
+/**
+ * All Hydra framework files are bundled inside the npm package under the
+ * files/ directory. Reading them at require-time guarantees:
+ *  - No network requests — works fully offline
+ *  - No write-time escaping headaches for markdown content
+ *  - Standard npm bundling via the "files" field in package.json
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const FILES_DIR = path.join(__dirname, '..', 'files');
+
+function readBundled(relPath) {
+  return fs.readFileSync(path.join(FILES_DIR, relPath), 'utf8');
+}
+
+const agents = {
+  'hydra-scout': {
+    content: readBundled('agents/hydra-scout.md'),
+    model: 'Haiku',
+    display: 'hydra-scout (Haiku)    — Codebase exploration',
+  },
+  'hydra-runner': {
+    content: readBundled('agents/hydra-runner.md'),
+    model: 'Haiku',
+    display: 'hydra-runner (Haiku)   — Test execution & validation',
+  },
+  'hydra-scribe': {
+    content: readBundled('agents/hydra-scribe.md'),
+    model: 'Haiku',
+    display: 'hydra-scribe (Haiku)   — Documentation writing',
+  },
+  'hydra-coder': {
+    content: readBundled('agents/hydra-coder.md'),
+    model: 'Sonnet',
+    display: 'hydra-coder (Sonnet)   — Code implementation',
+  },
+  'hydra-analyst': {
+    content: readBundled('agents/hydra-analyst.md'),
+    model: 'Sonnet',
+    display: 'hydra-analyst (Sonnet) — Code review & debugging',
+  },
+  'hydra-guard': {
+    content: readBundled('agents/hydra-guard.md'),
+    model: 'Haiku',
+    display: 'hydra-guard (Haiku)    — Auto-protection & safety',
+  },
+  'hydra-git': {
+    content: readBundled('agents/hydra-git.md'),
+    model: 'Haiku',
+    display: 'hydra-git (Haiku)      — Git operations',
+  },
+  'hydra-sentinel-scan': {
+    content: readBundled('agents/hydra-sentinel-scan.md'),
+    model: 'Haiku',
+    display: 'hydra-sentinel-scan (Haiku) — Fast integration sweep',
+  },
+  'hydra-sentinel': {
+    content: readBundled('agents/hydra-sentinel.md'),
+    model: 'Sonnet',
+    display: 'hydra-sentinel (Sonnet) — Deep integration analysis',
+  },
+  'hydra-preflight': {
+    content: readBundled('agents/hydra-preflight.md'),
+    model: 'Haiku',
+    display: 'hydra-preflight (Haiku) — Environment preflight check',
+  },
+};
+
+const skill = readBundled('SKILL.md');
+
+const references = {
+  'routing-guide': readBundled('references/routing-guide.md'),
+  'model-capabilities': readBundled('references/model-capabilities.md'),
+};
+
+const commands = {
+  'update':   readBundled('commands/hydra/update.md'),
+  'status':   readBundled('commands/hydra/status.md'),
+  'help':     readBundled('commands/hydra/help.md'),
+  'config':   readBundled('commands/hydra/config.md'),
+  'guard':    readBundled('commands/hydra/guard.md'),
+  'quiet':    readBundled('commands/hydra/quiet.md'),
+  'verbose':  readBundled('commands/hydra/verbose.md'),
+  'report':   readBundled('commands/hydra/report.md'),
+  'map':      readBundled('commands/hydra/map.md'),
+  'preflight': readBundled('commands/hydra/preflight.md'),
+  'stats':    readBundled('commands/hydra/stats.md'),
+};
+
+const hooks = {
+  'hydra-check-update': readBundled('hooks/hydra-check-update.js'),
+  'hydra-statusline':   readBundled('hooks/hydra-statusline.js'),
+  'hydra-token-math':   readBundled('hooks/hydra-token-math.js'),
+  'hydra-auto-guard':   readBundled('hooks/hydra-auto-guard.js'),
+  'hydra-notify':       readBundled('hooks/hydra-notify.js'),
+};
+
+const binaryHooks = {
+  'hydra-task-complete.wav': path.join(FILES_DIR, 'hooks', 'hydra-task-complete.wav'),
+};
+
+module.exports = { agents, skill, references, commands, hooks, binaryHooks };