bigpowers 2.82.4 → 2.83.0

package/.zcode/skills/write-document/SKILL.md

@@ -0,0 +1,255 @@
+---
+name: write-document
+model: sonnet
+description: "Write, organize, and sync high-integrity technical documents using the BMAD methodology. Ensures every document is Bold, Minimal, Actionable, and Durable. Use when creating architectural docs, technical guides, or organizing the specs/ directory."
+---
+
+# Write Document (BMAD)
+
+Create high-signal technical documentation that serves as an expert collaborator for both humans and AI. This skill enforces the BMAD principles to prevent context rot and ensure architectural durability.
+
+**Distinct from `edit-document`:** Use this skill to create a document that does not yet exist. Use `edit-document` when a document already exists and needs restructuring, clarity, or prose improvements.
+
+> **HARD GATE** — Every document must have a clear "Reason for Existence." If a document doesn't provide actionable leverage for a caller or test, do not create it.
+
+## The BMAD Principles
+
+| Principle | Execution |
+| :--- | :--- |
+| **B**old | Make strong assertions. Define clear boundaries and "Never" rules. No "it might" or "usually." |
+| **M**inimal | High-density, low-filler. **Circuit Breaker**: If the file exceeds 300 lines or the session exceeds 20 turns, you MUST run `terse-mode` and compact state before saving. |
+| **A**ctionable | Link every doc to a verifiable outcome. **Architectural Docs**: Verify via Gherkin features (`specs/verifications/features/`) or grep-based structure checks (`grep -c "pattern" file`) that prove the design's *constraints* are present. |
+| **D**urable | Design for the long-term. **Scalability**: Use "Nested Indexing"—root files link to module-level `GEMINI.md` indexes; do not list individual sub-files in the root. |
+
+## Process
+
+### 1. Identify the Artifact Type & Scope
+
+Choose the correct BMAD-BigPowers artifact:
+- **Decision Record (ADR)**: For "Why" decisions (saved to `specs/adr/`).
+- **Context Map**: For system-wide architectural mapping (`specs/tech-architecture/tech-stack.md`).
+- **Technical Guide**: For "How-to" with verification (saved to `<module>/REFERENCE.md`).
+- **Behavioral Feature**: Gherkin-style compliance specs (saved to `specs/verifications/features/`).
+- **Project README**: Project-facing documentation (saved to `README.md` at project root).
+
+**Cross-Cutting Concerns**: If a doc affects multiple modules, place the authoritative source in the lowest common ancestor directory and use "Delegates" (one-line pointers) in sub-directories to maintain the Single Source of Truth without violating the Stepdown Rule.
+
+### 2. Draft with Semantic Velocity
+
+> **STREAM CONTINUITY** — When writing file content, output in continuous chunks of ~200 lines. Do not pause. Continue immediately until complete. If you need time, emit a placeholder comment rather than going silent.
+
+Write the document focusing on "Expert Collaboration":
+- **Instructions over Descriptions**: Tell the reader (human or AI) exactly how to interact with the system.
+- **Provenance Links**: Link to ADRs, Issues, or Commits to preserve intent.
+- **The Stepdown Rule**: Information should descend exactly one level of abstraction. If a root doc needs to explain a leaf-level detail, it must point to a sub-index first.
+
+### Quick README (Project READMEs only)
+
+1. Ask: "Project name? One-sentence description?"
+2. Generate `README.md` at project root using the template in [REFERENCE.md](REFERENCE.md) — no TOC, no second interview round.
+3. Fill gaps from `CLAUDE.md` commands if available; use `TODO` markers otherwise.
+4. Output and suggest `edit-document` for polish.
+
+→ verify: `grep -c "^## " README.md | awk '{if($1>=7) print "OK"}'`
+
+### 3. Apply the 94% Quality Gate
+
+Before finalizing, audit the document against these red flags:
+- [ ] **Filler Language**: Are there pleasantries or "I hope this helps"? (Delete them).
+- [ ] **Ambiguity**: Are there "usually," "often," or "it depends" without specific conditions?
+- [ ] **Dead Ends**: Does the document end without a "Next Step" or "Verification" command?
+- [ ] **Shallow Content**: Does it restate the code without explaining the *intent* or *contracts*?
+
+### 4. Sync and Organize
+
+- **Big Powers Hierarchy**: Place the document in the correct tier (Global -> Project -> Sub-directory). Project READMEs are an exception — they go to project root (`README.md`), not `specs/`.
+- **Nested Indexing**: If adding a module-level doc, ensure the module's `GEMINI.md` is updated. If the module's index is new, add it to the root `GEMINI.md`.
+- **Sync**: Run `scripts/sync-skills.sh` if the document is a `SKILL.md` or affects generated artifacts.
+
+## Rules
+
+- **Minimalism is a requirement**: If a document can be a 5-line table, do not make it a 5-line essay.
+- **Verifiable outcomes**: Every technical document must include at least one `verify:` command. For architecture, this can be a `grep` or `run_shell_command` that validates the existence of required files or patterns.
+- **No speculative docs**: Do not write documentation for features that do not exist yet unless explicitly doing `elaborate-spec`.
+
+
+Suggest next skill: `audit-code` or `sync-skills.sh`.
+
+---
+
+# Project README Template
+
+Combined from dbader/readme-template and jehna/readme-best-practices. No TOC.
+
+## Navigation
+
+| Lines | Section |
+|-------|---------|
+| 1 | Title |
+| 5–16 | Navigation |
+| 18–24 | Sections intro |
+| 26–178 | README section templates (1–15) |
+| 180–183 | Verify |
+
+## Sections
+
+### 1. Title + Badges
+
+```markdown
+# Project Name
+
+![License](https://img.shields.io/badge/License-MIT-yellow.svg)
+![npm version](https://img.shields.io/npm/v/your-package.svg)
+
+```
+
+Fill badges from CLAUDE.md stack info if available. Default to license + version badges.
+
+### 2. Tagline
+
+```markdown
+> One-line description of what this project does and why it matters.
+```
+
+### 3. Description
+
+2-3 paragraphs: what problem it solves, who it's for, and what makes it different.
+
+### 4. Prerequisites
+
+```markdown
+## Prerequisites
+
+- **Runtime**: Node.js v18+ (from CLAUDE.md)
+- **Package manager**: npm (or pnpm/yarn)
+```
+
+Auto-fill from CLAUDE.md commands section when possible.
+
+### 5. Installation
+
+```markdown
+## Installation
+
+```bash
+npm install -g your-package
+# or
+npx your-package
+```
+```
+
+Prefer npx one-shot if applicable; list global install as alternative.
+
+### 6. Usage
+
+```markdown
+## Usage
+
+```bash
+your-command --help
+your-command do-something
+```
+```
+
+Include the most common 1-2 commands. Link to full docs if they exist.
+
+### 7. Features
+
+```markdown
+## Features
+
+- Feature 1: short description
+- Feature 2: short description
+```
+
+3-6 bullet points of what the project does. Derived from the project's purpose.
+
+### 8. Configuration
+
+```markdown
+## Configuration
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `VAR_NAME` | `value` | What it controls |
+```
+
+Use `TODO` markers if unknown.
+
+### 9. Development Setup
+
+```markdown
+## Development
+
+```bash
+git clone <repo-url>
+cd project
+npm install
+```
+```
+
+Auto-fill from CLAUDE.md `Run` and `Build` commands.
+
+### 10. Running Tests
+
+```markdown
+## Tests
+
+```bash
+npm test
+npm run lint
+```
+```
+
+Auto-fill from CLAUDE.md `Test` and `Lint` commands.
+
+### 11. Contributing
+
+```markdown
+## Contributing
+
+1. Fork the repo.
+2. Create a feature branch (`git checkout -b feature/my-thing`).
+3. Commit changes (`git commit -am 'Add my thing'`).
+4. Push (`git push origin feature/my-thing`).
+5. Open a Pull Request.
+```
+
+### 12. Changelog
+
+```markdown
+## Changelog
+
+See [CHANGELOG.md](../../CHANGELOG.md) or [Releases](https://github.com/user/repo/releases).
+```
+
+### 13. Links
+
+```markdown
+## Links
+
+- Repository: https://github.com/user/repo
+- Issue tracker: https://github.com/user/repo/issues
+```
+
+### 14. License
+
+```markdown
+## License
+
+MIT — see [LICENSE](../../LICENSE) for details.
+```
+
+Detect from CLAUDE.md or project LICENSE file.
+
+### 15. Credits (optional)
+
+```markdown
+## Credits
+
+Built with [bigpowers](https://github.com/danielvm-git/bigpowers).
+```
+
+## Verify
+
+After generation, run: `grep -c "^## " README.md` — expect ≥ 7 section headings.

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+# [2.83.0](https://github.com/danielvm-git/bigpowers/compare/v2.82.4...v2.83.0) (2026-07-24)
+
+
+### Bug Fixes
+
+* **ci:** resolve compliance and YAML gates from run 30100865008 ([2d9298b](https://github.com/danielvm-git/bigpowers/commit/2d9298b6feedf1c974b993338b5a3bfeb167583a))
+* **installer:** correct Claude hook path and gate install-helpers ([6a359e8](https://github.com/danielvm-git/bigpowers/commit/6a359e8ca30dab804eb471ea20a50dadd7e2c807))
+* **install:** finish Wave 0 closeout for e77/e78 ([a78faab](https://github.com/danielvm-git/bigpowers/commit/a78faab56c3c1b5573ba1584e0ed7c06dae2462f))
+* **install:** land e77/e78 Wave 0 code closeout ([6abcb7b](https://github.com/danielvm-git/bigpowers/commit/6abcb7be9a7cbe0a0a16765a98bb9b5c243f67c7))
+* **install:** restore Claude guard-git lib symlink path ([402abb3](https://github.com/danielvm-git/bigpowers/commit/402abb3d7c42b7442574e4f5657007c917878470))
+
+
+### Features
+
+* **e61:** Hermes Agent integration — adapter + install hub ([#84](https://github.com/danielvm-git/bigpowers/issues/84)) ([2028854](https://github.com/danielvm-git/bigpowers/commit/20288540ff5fb5488e3863e34b8f52da43cb2c85))
+* **e64:** Gemini CLI integration — adapter + install hub ([#88](https://github.com/danielvm-git/bigpowers/issues/88)) ([d5a7715](https://github.com/danielvm-git/bigpowers/commit/d5a77156b407e5d5722dd3799ff194bd28d47a03))
+* **e69:** MiMo Code integration — adapter + install hub ([#87](https://github.com/danielvm-git/bigpowers/issues/87)) ([c0a759a](https://github.com/danielvm-git/bigpowers/commit/c0a759ad269ecc031c6496ee2c22574061cec13f))
+* **e74:** Antigravity CLI integration — Wave A + B ([#89](https://github.com/danielvm-git/bigpowers/issues/89)) ([9e18e04](https://github.com/danielvm-git/bigpowers/commit/9e18e044c9441354b5ed7b717ce77ddf62ea46b7))
+* **e76:** ZCode integration — adapter + install hub ([#85](https://github.com/danielvm-git/bigpowers/issues/85)) ([0bb09b3](https://github.com/danielvm-git/bigpowers/commit/0bb09b307c58112a19933d8a81783a5a7df9ecf6))
+
 ## [2.82.4](https://github.com/danielvm-git/bigpowers/compare/v2.82.3...v2.82.4) (2026-07-24)
 
 

package/bin/setup.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 // story: e60s01
+// story: e74s02
 // bigpowers setup — interactive installer
 // Combines GSD simplicity with BMAD visual polish.
 
@@ -39,7 +40,7 @@ ${c.cyan('╚══════════════════════
 // ── Tool definitions ─────────────────────────────────────────────────────────
 const TOOLS = [
   { id: 'claude', name: 'Claude Code', globalPath: '~/.claude', localPath: '.claude' },
-  { id: 'antigravity', name: 'Antigravity', globalPath: '~/.gemini/antigravity', localPath: '.gemini/antigravity' },
+  { id: 'antigravity', name: 'Antigravity', globalPath: '~/.gemini/antigravity-cli/skills', localPath: '.agents/skills' },
   { id: 'augment', name: 'Augment', globalPath: '~/.augment', localPath: '.augment' },
   { id: 'cline', name: 'Cline', globalPath: '.clinerules', localPath: '.clinerules' },
   { id: 'codebuddy', name: 'CodeBuddy', globalPath: '~/.codebuddy', localPath: '.codebuddy' },
@@ -48,14 +49,16 @@ const TOOLS = [
   { id: 'cursor', name: 'Cursor', globalPath: '~/.cursor', localPath: '.cursor' },
   { id: 'gemini', name: 'Gemini', globalPath: '~/.gemini', localPath: '.gemini' },
   { id: 'hermes', name: 'Hermes Agent', globalPath: '~/.hermes', localPath: '.hermes' },
+  { id: 'mimo', name: 'MiMo Code', globalPath: '~/.mimocode', localPath: '.mimocode' },
   { id: 'kilo', name: 'Kilo', globalPath: '~/.config/kilo', localPath: '.config/kilo' },
   { id: 'opencode', name: 'OpenCode', globalPath: '~/.config/opencode', localPath: '.config/opencode' },
+  { id: 'pi', name: 'pi', globalPath: '~/.pi/agent/skills', localPath: '.pi/agent/skills' },
   { id: 'qwen', name: 'Qwen Code', globalPath: '~/.qwen', localPath: '.qwen' },
   { id: 'trae', name: 'Trae', globalPath: '~/.trae', localPath: '.trae' },
   { id: 'windsurf', name: 'Windsurf', globalPath: '~/.codeium/windsurf', localPath: '.codeium/windsurf' },
+  { id: 'zcode', name: 'ZCode', globalPath: '~/.zcode', localPath: '.zcode' },
 ];
-const ALL_ID = '__all__';
-const SUPPORTED_IDS = new Set(['claude', 'gemini', 'pi', 'cursor', 'codex']);
+const SUPPORTED_IDS = new Set(['claude', 'gemini', 'pi', 'hermes', 'mimo', 'zcode', 'cursor', 'codex', 'antigravity', 'agy']);
 const UNSUPPORTED_HINT = '(TODO)';
 
 // ── clack helpers (lazy ESM import from CJS) ─────────────────────────────────
@@ -159,7 +162,7 @@ async function main() {
   }
 
   if (mode === 'uninstall') {
-    await handleUninstall(clack);
+    await handleUninstall();
     return;
   }
 
@@ -271,6 +274,12 @@ async function main() {
     const detail = r.ok ? c.dim(r.path) : c.red(r.error);
     console.log(`  ${icon} ${r.name} — ${detail}`);
   }
+  if (selectedTools.includes('cursor') && results.some((r) => r.name === 'Cursor' && r.ok)) {
+    console.log(
+      `  ${c.dim('NOTE: Cursor does not scan ~/.cursor/rules globally — also symlink into each project:')}`
+    );
+    console.log(`  ${c.dim('  ln -sfn ' + path.join(ROOT, '.cursor', 'rules') + ' .cursor/rules')}`);
+  }
   console.log('');
 
   const allOk = results.every((r) => r.ok);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.82.4",
+  "version": "2.83.0",
   "description": "73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "main": "index.js",
   "scripts": {

package/scripts/adapters/agy.sh

@@ -1,6 +1,49 @@
 #!/usr/bin/env bash
 # story: e37s09
+# story: e74s01
+# story: e74s02
+# Antigravity CLI (agy) — skills at .agents/skills/ (workspace) and
+# ~/.gemini/antigravity-cli/skills/ (global). See RESEARCH-ANTIGRAVITY.md.
+
+AGY_SKILLS="${AGY_SKILLS:-.agents/skills}"
+AGY_HOOKS_GLOBAL="${AGY_HOOKS_GLOBAL:-$HOME/.gemini/config/hooks.json}"
+AGY_HOOKS_WORKSPACE="${AGY_HOOKS_WORKSPACE:-.agents/hooks.json}"
+
+render_skill() {
+  if declare -f render_agy_skill >/dev/null 2>&1; then
+    render_agy_skill
+    return
+  fi
+  local out="${AGY_SKILLS}/${IR_NAME}"
+  mkdir -p "$out"
+  cp "${SKILL_MD_PATH:-}" "$out/SKILL.md" 2>/dev/null || {
+    {
+      echo "---"
+      echo "name: $IR_NAME"
+      [[ -n "${IR_MODEL:-}" ]] && echo "model: $IR_MODEL"
+      echo "description: \"$IR_DESC_ESCAPED\""
+      echo "---"
+      echo ""
+      echo "${IR_BODY_SKILL:-$IR_BODY}"
+    } > "$out/SKILL.md"
+  }
+}
+
 wire_context() {
   source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
-  wire_context_mode symlink "${1:-CLAUDE.md}"
+  wire_context_mode symlink "${1:-AGENTS.md}"
 }
+
+# If stdin is a pipe/redirect, read the SkillIR JSON and render
+if [[ ! -t 0 ]]; then
+  JSON_INPUT=$(cat)
+  if [[ -n "$JSON_INPUT" ]]; then
+    IR_NAME=$(echo "$JSON_INPUT" | jq -r '.name')
+    IR_MODEL=$(echo "$JSON_INPUT" | jq -r '.model // empty')
+    IR_DESCRIPTION=$(echo "$JSON_INPUT" | jq -r '.description')
+    IR_BODY=$(echo "$JSON_INPUT" | jq -r '.body')
+    IR_BODY_SKILL=$(echo "$JSON_INPUT" | jq -r '.body_agy_skill // .body')
+    IR_DESC_ESCAPED=$(echo "$IR_DESCRIPTION" | sed 's/\\/\\\\/g; s/\"/\\"/g')
+    render_skill
+  fi
+fi

package/scripts/adapters/gemini.sh

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 # story: e48s15
 # story: e37s05 e37s07
+# story: e64s01
 
 render_skill() {
   if declare -f render_gemini_skill >/dev/null 2>&1; then
@@ -36,6 +37,88 @@ wire_context() {
   wire_context_mode symlink "${1:-GEMINI.md}"
 }
 
+GEMINI_HOOK_EVENTS=(
+  BeforeTool AfterTool BeforeAgent AfterAgent BeforeModel
+  BeforeToolSelection AfterModel SessionStart SessionEnd Notification PreCompress
+)
+
+gemini_hooks_dir() {
+  echo "${GEMINI_HOOKS_DIR:-${GEMINI_EXT_DIR:-.gemini/extensions/bigpowers}/hooks}"
+}
+
+list_hook_events() {
+  printf '%s\n' "${GEMINI_HOOK_EVENTS[@]}"
+}
+
+gemini_required_hook_files() {
+  cat <<'EOF'
+session-start
+run-hook.cmd
+HOOKS.md
+hooks-manifest.json
+settings.json.example
+before-tool-git-guard.sh
+before-tool-rtk.sh
+before-tool-token-mgmt.sh
+EOF
+}
+
+validate_hook_templates() {
+  local hookdir missing=0 rel
+  hookdir="$(gemini_hooks_dir)"
+  if [[ ! -d "$hookdir" ]]; then
+    echo "FAIL: hook dir missing: $hookdir" >&2
+    return 1
+  fi
+  while IFS= read -r rel; do
+    [[ -n "$rel" ]] || continue
+    if [[ ! -f "$hookdir/$rel" ]]; then
+      echo "FAIL: missing $hookdir/$rel" >&2
+      missing=1
+    fi
+  done < <(gemini_required_hook_files)
+  local count
+  count="$(list_hook_events | wc -l | tr -d ' ')"
+  if [[ "$count" != "11" ]]; then
+    echo "FAIL: expected 11 hook events, got $count" >&2
+    missing=1
+  fi
+  return "$missing"
+}
+
+render_hooks_manifest() {
+  if declare -f render_gemini_hooks_manifest >/dev/null 2>&1; then
+    render_gemini_hooks_manifest
+    return
+  fi
+  local hookdir
+  hookdir="$(gemini_hooks_dir)"
+  mkdir -p "$hookdir"
+  cat > "$hookdir/hooks-manifest.json" <<'JSON'
+{
+  "schema_version": 1,
+  "target": "gemini",
+  "events_total": 11,
+  "events": [
+    "BeforeTool", "AfterTool", "BeforeAgent", "AfterAgent", "BeforeModel",
+    "BeforeToolSelection", "AfterModel", "SessionStart", "SessionEnd",
+    "Notification", "PreCompress"
+  ]
+}
+JSON
+}
+
+# CLI: bash scripts/adapters/gemini.sh --validate-hooks
+if [[ "${1:-}" == "--validate-hooks" ]]; then
+  validate_hook_templates && echo "PASS: gemini hook templates"
+  exit $?
+fi
+
+if [[ "${1:-}" == "--list-hook-events" ]]; then
+  list_hook_events
+  exit 0
+fi
+
 # If stdin is a pipe/redirect, read the SkillIR JSON and render
 if [[ ! -t 0 ]]; then
   JSON_INPUT=$(cat)

package/scripts/adapters/hermes.sh

@@ -1,10 +1,62 @@
 #!/usr/bin/env bash
 # story: e37s10
+# story: e61s01
+# Hermes Agent skill adapter — renders .hermes/skills/<name>/SKILL.md from SkillIR.
+
+hermes_is_unsafe_skill_name() {
+  local name="$1"
+  [[ -z "$name" || "$name" == "null" || "$name" == *"/"* || "$name" == *".."* ]]
+}
+
+hermes_sanitize_name() {
+  local name="$1"
+  if hermes_is_unsafe_skill_name "$name"; then
+    echo "hermes: invalid skill name: ${name:-<empty>}" >&2
+    return 1
+  fi
+  printf '%s' "$name"
+}
+
 render_skill() {
+  if declare -f render_hermes_skill >/dev/null 2>&1; then
+    render_hermes_skill
+    return
+  fi
+
+  local safe_name
+  safe_name=$(hermes_sanitize_name "${IR_NAME:-}") || return 1
   local out="${HERMES_SKILLS:-.hermes/skills}"
-  mkdir -p "$out/${IR_NAME:-_stub}" 2>/dev/null || true
+  mkdir -p "$out/$safe_name"
+
+  if [[ -n "${SKILL_MD_PATH:-}" && -f "$SKILL_MD_PATH" ]]; then
+    cp "$SKILL_MD_PATH" "$out/$safe_name/SKILL.md"
+    return 0
+  fi
+
+  {
+    echo "---"
+    echo "name: $safe_name"
+    [[ -n "${IR_MODEL:-}" && "$IR_MODEL" != "null" ]] && echo "model: $IR_MODEL"
+    echo "description: \"${IR_DESC_ESCAPED:-}\""
+    echo "---"
+    echo ""
+    echo "${IR_BODY:-}"
+  } > "$out/$safe_name/SKILL.md"
 }
+
 wire_context() {
   source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
   wire_context_mode config-bridge ".hermes/config.yaml" "instructions" "AGENTS.md"
 }
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]] && [[ ! -t 0 ]]; then
+  JSON_INPUT=$(cat)
+  if [[ -n "$JSON_INPUT" ]]; then
+    IR_NAME=$(echo "$JSON_INPUT" | jq -r '.name')
+    IR_MODEL=$(echo "$JSON_INPUT" | jq -r '.model')
+    IR_DESCRIPTION=$(echo "$JSON_INPUT" | jq -r '.description')
+    IR_BODY=$(echo "$JSON_INPUT" | jq -r '.body')
+    IR_DESC_ESCAPED=$(echo "$IR_DESCRIPTION" | sed 's/\\/\\\\/g; s/\"/\\"/g')
+    render_skill
+  fi
+fi

package/scripts/adapters/mimo.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# story: e69s01
+
+render_skill() {
+  if declare -f render_mimo_skill >/dev/null 2>&1; then
+    render_mimo_skill
+    return
+  fi
+  local out="${MIMO_SKILLS:-.mimocode/skills}/$IR_NAME"
+  mkdir -p "$out"
+  cp "${SKILL_MD_PATH:-}" "$out/SKILL.md" 2>/dev/null || {
+    {
+      echo "---"
+      echo "name: $IR_NAME"
+      [[ -n "$IR_MODEL" ]] && echo "model: $IR_MODEL"
+      echo "description: \"$IR_DESC_ESCAPED\""
+      echo "---"
+      echo ""
+      echo "${IR_BODY_SKILL:-$IR_BODY}"
+    } > "$out/SKILL.md"
+  }
+}
+
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  wire_context_mode symlink "${1:-AGENTS.md}"
+}
+
+# If stdin is a pipe/redirect, read the SkillIR JSON and render
+if [[ ! -t 0 ]]; then
+  JSON_INPUT=$(cat)
+  if [[ -n "$JSON_INPUT" ]]; then
+    IR_NAME=$(echo "$JSON_INPUT" | jq -r '.name')
+    IR_MODEL=$(echo "$JSON_INPUT" | jq -r '.model // empty')
+    IR_DESCRIPTION=$(echo "$JSON_INPUT" | jq -r '.description')
+    IR_BODY=$(echo "$JSON_INPUT" | jq -r '.body')
+    IR_BODY_SKILL=$(echo "$JSON_INPUT" | jq -r '.body_mimo_skill // .body')
+    IR_DESC_ESCAPED=$(echo "$IR_DESCRIPTION" | sed 's/\\/\\\\/g; s/\"/\\"/g')
+    render_skill
+  fi
+fi

package/scripts/adapters/zcode.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# story: e76s01
+# ZCode skill adapter — renders SKILL.md to ~/.zcode/skills/<name>/.
+
+render_skill() {
+  local skills_dir="${ZCODE_SKILLS:-.zcode/skills}"
+  mkdir -p "${skills_dir}/${IR_NAME}"
+  {
+    echo "---"
+    echo "name: $IR_NAME"
+    [[ -n "${IR_MODEL:-}" ]] && echo "model: $IR_MODEL"
+    echo "description: \"$IR_DESC_ESCAPED\""
+    echo "---"
+    echo ""
+    echo "$IR_BODY"
+  } > "${skills_dir}/${IR_NAME}/SKILL.md"
+}
+
+wire_context() {
+  source "$(dirname "${BASH_SOURCE[0]}")/../lib/context-wire.sh"
+  local dest="${ZCODE_AGENTS:-.zcode/AGENTS.md}"
+  mkdir -p "$(dirname "$dest")"
+  wire_context_mode symlink "$dest" "" "" "" "${1:-AGENTS.md}"
+}
+
+# If stdin is a pipe/redirect, read the SkillIR JSON and render
+if [[ ! -t 0 ]]; then
+  JSON_INPUT=$(cat)
+  if [[ -n "$JSON_INPUT" ]]; then
+    IR_NAME=$(echo "$JSON_INPUT" | jq -r '.name')
+    IR_MODEL=$(echo "$JSON_INPUT" | jq -r '.model // empty')
+    IR_DESCRIPTION=$(echo "$JSON_INPUT" | jq -r '.description')
+    IR_BODY=$(echo "$JSON_INPUT" | jq -r '.body')
+    IR_DESC_ESCAPED=$(echo "$IR_DESCRIPTION" | sed 's/\\/\\\\/g; s/\"/\\"/g')
+    render_skill
+  fi
+fi

package/scripts/hooks/hermes/gateway/session-log/HOOK.yaml

@@ -0,0 +1,5 @@
+name: session-log
+description: Observe agent lifecycle events (bigpowers template — copy to ~/.hermes/hooks/)
+events:
+  - agent:start
+  - agent:end

package/scripts/hooks/hermes/gateway/session-log/handler.py

@@ -0,0 +1,7 @@
+# story: e61s01
+# Gateway hook template — copy directory to ~/.hermes/hooks/session-log/
+# Docs: https://hermes-agent.nousresearch.com/docs/user-guide/features/hooks
+
+async def handle(event_type: str, context: dict) -> None:
+    """Observer-only; errors are caught by Hermes and never crash the agent."""
+    _ = event_type, context

package/scripts/hooks/hermes/plugin/guard-git-plugin.py

@@ -0,0 +1,14 @@
+# story: e61s01
+# Plugin hook template — install as a Hermes plugin (CLI + gateway).
+# Docs: https://hermes-agent.nousresearch.com/docs/developer-guide/plugins
+
+DANGEROUS = {"terminal", "write_file", "patch"}
+
+
+def warn_dangerous(tool_name, **kwargs):
+    if tool_name in DANGEROUS:
+        print(f"⚠ Executing potentially sensitive tool: {tool_name}")
+
+
+def register(ctx):
+    ctx.register_hook("pre_tool_call", warn_dangerous)