@hivehub/rulebook 5.5.1 → 5.7.0

package/templates/hooks/terse-mode-tracker.sh

@@ -1,187 +1,190 @@
-#!/usr/bin/env bash
-# Claude Code UserPromptSubmit hook for rulebook-terse (v5.4.0).
-#
-# Parses slash commands + natural-language activation/deactivation
-# phrases in the user prompt, updates the project-local flag file,
-# and emits a short (~45 token) attention anchor as hookSpecificOutput
-# when a persistent mode is active — keeps the compression register in
-# the model's attention on every user message.
-#
-# Independent sub-skill modes (commit / review) do NOT get the anchor:
-# their own SKILL.md files drive behavior for the single turn they're
-# invoked.
-#
-# Silent-fails on every filesystem error.
-
-set -u
-
-input="$(cat || true)"
-prompt=""
-cwd=""
-if [ -n "$input" ]; then
-  # Parse JSON via node (always available in Claude Code hook env).
-  # Emits two lines: prompt on line 1, cwd on line 2.
-  parsed="$(printf '%s' "$input" | node -e "
-    try {
-      const data = JSON.parse(require('fs').readFileSync(0, 'utf8'));
-      process.stdout.write((data.prompt || '') + '\\n' + (data.cwd || ''));
-    } catch { process.stdout.write('\\n'); }
-  " 2>/dev/null || printf '\n')"
-  prompt="$(printf '%s' "$parsed" | head -n 1)"
-  cwd="$(printf '%s' "$parsed" | tail -n +2)"
-fi
-
-PROJECT_ROOT="${cwd:-${CLAUDE_PROJECT_DIR:-$(pwd)}}"
-FLAG_PATH="${PROJECT_ROOT}/.rulebook/.terse-mode"
-CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/rulebook"
-USER_CONFIG="${CONFIG_DIR}/config.json"
-PROJECT_CONFIG="${PROJECT_ROOT}/.rulebook/rulebook.json"
-
-VALID_MODES_RE='^(off|brief|terse|ultra|commit|review)$'
-MAX_FLAG_BYTES=32
-
-resolve_default_mode() {
-  if [ -n "${RULEBOOK_TERSE_MODE:-}" ]; then
-    local m="$(printf '%s' "$RULEBOOK_TERSE_MODE" | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]')"
-    if [[ "$m" =~ $VALID_MODES_RE ]]; then printf '%s' "$m"; return; fi
-  fi
-  if [ -f "$PROJECT_CONFIG" ]; then
-    local m
-    m="$(node -e "
-      try {
-        const cfg = JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8'));
-        if (cfg.terse && cfg.terse.defaultMode) process.stdout.write(String(cfg.terse.defaultMode));
-      } catch { }
-    " "$PROJECT_CONFIG" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]' || true)"
-    if [ -n "$m" ] && [[ "$m" =~ $VALID_MODES_RE ]]; then printf '%s' "$m"; return; fi
-  fi
-  if [ -f "$USER_CONFIG" ]; then
-    local m
-    m="$(node -e "
-      try {
-        const cfg = JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8'));
-        if (cfg.terse && cfg.terse.defaultMode) process.stdout.write(String(cfg.terse.defaultMode));
-      } catch { }
-    " "$USER_CONFIG" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]' || true)"
-    if [ -n "$m" ] && [[ "$m" =~ $VALID_MODES_RE ]]; then printf '%s' "$m"; return; fi
-  fi
-  printf 'terse'
-}
-
-safe_write_flag() {
-  local content="$1"
-  local dir
-  dir="$(dirname "$FLAG_PATH")"
-  mkdir -p "$dir" 2>/dev/null || return 0
-  [ -L "$dir" ] && return 0
-  [ -L "$FLAG_PATH" ] && return 0
-
-  local tmp
-  tmp="$(mktemp "$dir/.terse-mode.XXXXXX" 2>/dev/null)" || return 0
-  {
-    umask 077
-    printf '%s' "$content" > "$tmp" 2>/dev/null || { rm -f "$tmp"; return 0; }
-  }
-  chmod 600 "$tmp" 2>/dev/null || true
-  mv -f "$tmp" "$FLAG_PATH" 2>/dev/null || rm -f "$tmp"
-}
-
-read_flag() {
-  # Symlink-safe, size-capped, whitelist-validated read.
-  [ ! -f "$FLAG_PATH" ] && return 1
-  [ -L "$FLAG_PATH" ] && return 1
-  local size
-  size="$(wc -c < "$FLAG_PATH" 2>/dev/null || echo "$MAX_FLAG_BYTES")"
-  [ "$size" -gt "$MAX_FLAG_BYTES" ] && return 1
-
-  local raw
-  raw="$(head -c "$MAX_FLAG_BYTES" "$FLAG_PATH" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]')"
-  if [[ "$raw" =~ $VALID_MODES_RE ]]; then
-    printf '%s' "$raw"
-    return 0
-  fi
-  return 1
-}
-
-default_mode="$(resolve_default_mode)"
-lower_prompt="$(printf '%s' "$prompt" | tr '[:upper:]' '[:lower:]')"
-
-# Parse intent. Order matters: deactivation wins over accidental
-# activation, slash commands win over natural-language patterns.
-new_mode=""
-deactivate=0
-
-# Slash commands
-if [[ "$lower_prompt" == /rulebook-terse-commit* ]]; then
-  new_mode="commit"
-elif [[ "$lower_prompt" == /rulebook-terse-review* ]]; then
-  new_mode="review"
-elif [[ "$lower_prompt" == /rulebook-terse ]]; then
-  new_mode="$default_mode"
-elif [[ "$lower_prompt" == /rulebook-terse\ * ]]; then
-  arg="$(printf '%s' "$lower_prompt" | awk '{print $2}')"
-  case "$arg" in
-    off) deactivate=1 ;;
-    brief|terse|ultra|commit|review) new_mode="$arg" ;;
-    *) : ;;  # unknown subcommand → leave state unchanged
-  esac
-fi
-
-# Natural-language deactivation — checked first so "stop terse" wins.
-if [ -z "$new_mode" ] && [ "$deactivate" -eq 0 ]; then
-  if echo "$prompt" | grep -qiE '\b(stop|disable|turn off|deactivate)\b.*\brulebook[- ]?terse\b' \
-     || echo "$prompt" | grep -qiE '\brulebook[- ]?terse\b.*\b(stop|disable|turn off|deactivate)\b' \
-     || echo "$prompt" | grep -qiE '\b(stop|disable) terse\b' \
-     || echo "$prompt" | grep -qiE '\bnormal mode\b'; then
-    deactivate=1
-  fi
-fi
-
-# Natural-language activation
-if [ -z "$new_mode" ] && [ "$deactivate" -eq 0 ]; then
-  if echo "$prompt" | grep -qiE '\b(activate|enable|turn on|start)\b.*\brulebook[- ]?terse\b' \
-     || echo "$prompt" | grep -qiE '\brulebook[- ]?terse\b.*\b(mode|activate|enable|turn on|start)\b' \
-     || echo "$prompt" | grep -qiE '\bbe terse\b' \
-     || echo "$prompt" | grep -qiE '\bterse mode\b' \
-     || echo "$prompt" | grep -qiE '\bless tokens?\b'; then
-    new_mode="$default_mode"
-  fi
-fi
-
-# Apply intent
-if [ "$deactivate" -eq 1 ]; then
-  rm -f "$FLAG_PATH" 2>/dev/null || true
-elif [ -n "$new_mode" ]; then
-  if [ "$new_mode" = "off" ]; then
-    rm -f "$FLAG_PATH" 2>/dev/null || true
-  else
-    safe_write_flag "$new_mode"
-  fi
-fi
-
-# Emit attention anchor for persistent modes only.
-active_mode="$(read_flag || true)"
-case "$active_mode" in
-  brief|terse|ultra)
-    if [ "$active_mode" = "brief" ]; then
-      keep_clause="Keep articles and full sentences."
-    else
-      keep_clause="Fragments OK."
-    fi
-    text="RULEBOOK-TERSE ACTIVE (${active_mode}). Drop filler/hedging/pleasantries. ${keep_clause} Code/tests/commits/security: write full. Quality-gate failures + destructive ops: write full."
-    # Emit hookSpecificOutput JSON via node — universal across platforms.
-    node -e "
-      const text = process.argv[1];
-      process.stdout.write(JSON.stringify({
-        hookSpecificOutput: {
-          hookEventName: 'UserPromptSubmit',
-          additionalContext: text
-        }
-      }));
-    " "$text" 2>/dev/null || true
-    ;;
-  *)
-    # No active persistent mode, or commit/review sub-skill — no anchor.
-    :
-    ;;
-esac
+#!/usr/bin/env bash
+# Claude Code UserPromptSubmit hook for rulebook-terse (v5.6.0).
+#
+# Parses slash commands + natural-language activation/deactivation
+# phrases in the user prompt, updates the project-local flag file,
+# and emits a short (~45 token) attention anchor as hookSpecificOutput
+# when a persistent mode is active.
+#
+# Performance: fast-path bash trigger scan avoids spawning node when the
+# prompt cannot change state. When state can change, a single node call
+# parses stdin + configs and returns a pre-resolved decision
+# (`set:<mode>` / `unset` / `noop`) plus the resolved cwd. Bash only
+# applies filesystem changes after that.
+#
+# Silent-fails on every filesystem error.
+
+set -u
+
+input="$(cat || true)"
+
+# Fast-path trigger scan over raw stdin payload. JSON-escaped string
+# values still match these literal substrings (the trigger words contain
+# no JSON-special characters), so this is a safe coarse filter. If none
+# match, we skip node entirely.
+TRIGGER_RE='(/rulebook-terse|terse mode|be terse|stop terse|disable terse|deactivate terse|turn off terse|enable terse|activate terse|turn on terse|normal mode|less tokens?)'
+prompt_has_trigger=0
+if [ -n "$input" ] && printf '%s' "$input" | grep -qiE "$TRIGGER_RE"; then
+  prompt_has_trigger=1
+fi
+
+VALID_MODES_RE='^(off|brief|terse|ultra|commit|review)$'
+MAX_FLAG_BYTES=32
+
+read_flag() {
+  # Symlink-safe, size-capped, whitelist-validated read.
+  local flag_path="$1"
+  [ ! -f "$flag_path" ] && return 1
+  [ -L "$flag_path" ] && return 1
+  local size
+  size="$(wc -c < "$flag_path" 2>/dev/null || echo "$MAX_FLAG_BYTES")"
+  [ "$size" -gt "$MAX_FLAG_BYTES" ] && return 1
+  local raw
+  raw="$(head -c "$MAX_FLAG_BYTES" "$flag_path" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]')"
+  if [[ "$raw" =~ $VALID_MODES_RE ]]; then
+    printf '%s' "$raw"
+    return 0
+  fi
+  return 1
+}
+
+emit_anchor() {
+  # Hand-construct the JSON. The text below contains no quotes,
+  # backslashes, or control chars, so this is safe.
+  local mode="$1"
+  local keep_clause
+  if [ "$mode" = "brief" ]; then
+    keep_clause="Keep articles and full sentences."
+  else
+    keep_clause="Fragments OK."
+  fi
+  local text="RULEBOOK-TERSE ACTIVE (${mode}). Drop filler/hedging/pleasantries. ${keep_clause} Code/tests/commits/security: write full. Quality-gate failures + destructive ops: write full."
+  printf '{"hookSpecificOutput":{"hookEventName":"UserPromptSubmit","additionalContext":"%s"}}' "$text"
+}
+
+safe_write_flag() {
+  local flag_path="$1"
+  local content="$2"
+  local dir
+  dir="$(dirname "$flag_path")"
+  mkdir -p "$dir" 2>/dev/null || return 0
+  [ -L "$dir" ] && return 0
+  [ -L "$flag_path" ] && return 0
+  local tmp
+  tmp="$(mktemp "$dir/.terse-mode.XXXXXX" 2>/dev/null)" || return 0
+  {
+    umask 077
+    printf '%s' "$content" > "$tmp" 2>/dev/null || { rm -f "$tmp"; return 0; }
+  }
+  chmod 600 "$tmp" 2>/dev/null || true
+  mv -f "$tmp" "$flag_path" 2>/dev/null || rm -f "$tmp"
+}
+
+# Fast exit: no trigger in prompt → state cannot change. Just emit the
+# anchor for the active persistent mode (if any) and return.
+if [ "$prompt_has_trigger" -eq 0 ]; then
+  PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+  active_mode="$(read_flag "${PROJECT_ROOT}/.rulebook/.terse-mode" || true)"
+  case "$active_mode" in
+    brief|terse|ultra) emit_anchor "$active_mode" ;;
+  esac
+  exit 0
+fi
+
+# Slow path: ONE node call does the entire parse + decision logic, then
+# emits two lines: `cwd` and `decision` (one of `set:<mode>`, `unset`,
+# `noop`). Bash only handles filesystem ops after that.
+result="$(printf '%s' "$input" | RULEBOOK_TERSE_MODE="${RULEBOOK_TERSE_MODE:-}" node -e '
+  const fs = require("fs");
+  function readJson(p) { try { return JSON.parse(fs.readFileSync(p, "utf8")); } catch { return null; } }
+  const VALID = /^(off|brief|terse|ultra|commit|review)$/;
+
+  let data = {};
+  try { data = JSON.parse(fs.readFileSync(0, "utf8")); } catch { }
+  const prompt = String(data.prompt || "");
+  const cwd = String(data.cwd || "");
+  const lower = prompt.toLowerCase();
+
+  // Resolve default mode: env > project config > user config > "terse".
+  function norm(s) { return String(s || "").toLowerCase().replace(/\s+/g, ""); }
+  let def = norm(process.env.RULEBOOK_TERSE_MODE);
+  if (!VALID.test(def)) def = "";
+  if (!def && cwd) {
+    const pc = readJson(cwd + "/.rulebook/rulebook.json");
+    const m = norm(pc && pc.terse && pc.terse.defaultMode);
+    if (VALID.test(m)) def = m;
+  }
+  if (!def) {
+    const home = process.env.HOME || process.env.USERPROFILE || "";
+    const xdg = process.env.XDG_CONFIG_HOME || (home ? home + "/.config" : "");
+    if (xdg) {
+      const uc = readJson(xdg + "/rulebook/config.json");
+      const m = norm(uc && uc.terse && uc.terse.defaultMode);
+      if (VALID.test(m)) def = m;
+    }
+  }
+  if (!def) def = "terse";
+
+  // Slash commands.
+  let newMode = "";
+  let deact = false;
+  if (lower.startsWith("/rulebook-terse-commit")) newMode = "commit";
+  else if (lower.startsWith("/rulebook-terse-review")) newMode = "review";
+  else if (lower === "/rulebook-terse") newMode = def;
+  else if (lower.startsWith("/rulebook-terse ")) {
+    const arg = lower.split(/\s+/)[1] || "";
+    if (arg === "off") deact = true;
+    else if (/^(brief|terse|ultra|commit|review)$/.test(arg)) newMode = arg;
+  }
+
+  // Natural-language deactivation (checked first so "stop terse" wins).
+  if (!newMode && !deact) {
+    if (
+      /\b(stop|disable|turn off|deactivate)\b.*\brulebook[- ]?terse\b/i.test(prompt) ||
+      /\brulebook[- ]?terse\b.*\b(stop|disable|turn off|deactivate)\b/i.test(prompt) ||
+      /\b(stop|disable) terse\b/i.test(prompt) ||
+      /\bnormal mode\b/i.test(prompt)
+    ) deact = true;
+  }
+  // Natural-language activation.
+  if (!newMode && !deact) {
+    if (
+      /\b(activate|enable|turn on|start)\b.*\brulebook[- ]?terse\b/i.test(prompt) ||
+      /\brulebook[- ]?terse\b.*\b(mode|activate|enable|turn on|start)\b/i.test(prompt) ||
+      /\bbe terse\b/i.test(prompt) ||
+      /\bterse mode\b/i.test(prompt) ||
+      /\bless tokens?\b/i.test(prompt)
+    ) newMode = def;
+  }
+
+  let decision = "noop";
+  if (deact || newMode === "off") decision = "unset";
+  else if (newMode) decision = "set:" + newMode;
+
+  process.stdout.write(cwd + "\n" + decision);
+' 2>/dev/null || printf '\nnoop')"
+
+# First line = cwd, rest = decision.
+cwd="$(printf '%s' "$result" | sed -n '1p')"
+decision="$(printf '%s' "$result" | sed -n '2p')"
+
+PROJECT_ROOT="${cwd:-${CLAUDE_PROJECT_DIR:-$(pwd)}}"
+FLAG_PATH="${PROJECT_ROOT}/.rulebook/.terse-mode"
+
+case "$decision" in
+  unset)
+    rm -f "$FLAG_PATH" 2>/dev/null || true
+    ;;
+  set:*)
+    new_mode="${decision#set:}"
+    safe_write_flag "$FLAG_PATH" "$new_mode"
+    ;;
+  *)  # noop
+    ;;
+esac
+
+# Emit attention anchor for persistent modes only.
+active_mode="$(read_flag "$FLAG_PATH" || true)"
+case "$active_mode" in
+  brief|terse|ultra) emit_anchor "$active_mode" ;;
+esac

package/templates/ides/OPENCODE.md

@@ -0,0 +1,63 @@
+<!-- OPENCODE:START -->
+# OpenCode Integration
+
+This project is managed by [@hivellm/rulebook](https://github.com/hivellm/rulebook).
+The OpenCode integration mirrors the Claude Code experience inside the
+[OpenCode](https://opencode.ai) terminal coding agent.
+
+## What Rulebook generates for OpenCode
+
+| File / Path | Purpose |
+|---|---|
+| `opencode.json` | Adds `$schema`, `mcp.rulebook`, and `instructions` (lazy-loads `AGENTS.md`, `AGENTS.override.md`, `.rulebook/specs/*.md`). Preserves all user-defined keys. |
+| `.opencode/commands/<name>.md` | One file per user-invocable Rulebook slash command. |
+| `.opencode/agents/<role>.md` | One file per Rulebook role agent, frontmatter translated. |
+| `.opencode/skills/<name>/SKILL.md` | One directory per Rulebook dev skill, name-normalized to OpenCode's regex. |
+| `.opencode/.rulebook-managed.json` | Sidecar so `rulebook update` knows which keys to refresh. |
+
+## Critical rules
+
+These mirror the rules every other Rulebook-supported tool follows:
+
+1. **Read `AGENTS.md` and `AGENTS.override.md`** before making changes.
+2. **Never revert or discard uncommitted work** — fix forward.
+3. **Edit files sequentially**, not in parallel. For 3+ files, decompose
+   into 1–2 file sub-tasks.
+4. **Run type-check / lint before tests** — diagnostic-first.
+5. **If a fix fails twice, escalate** — research, ask, or open a team.
+6. **Prefer MCP tools** (`mcp__rulebook__*`) over shell commands.
+7. **Capture learnings** at the end of significant work.
+8. **Never archive a task** without docs updated, tests written, and
+   tests passing.
+
+## Model tier mapping
+
+| Rulebook tier | OpenCode model |
+|---|---|
+| `haiku` | `anthropic/claude-haiku-4-5` |
+| `sonnet` | `anthropic/claude-sonnet-4-6` |
+| `opus` | `anthropic/claude-opus-4-7` |
+
+## Permission synthesis
+
+| Role type | `permission.edit` | `permission.bash` |
+|---|---|---|
+| Read-only (researcher, code-reviewer, security-reviewer, accessibility-reviewer, ux-reviewer, performance-engineer) | `deny` | `ask` |
+| All other roles | `allow` | `allow` |
+
+## Isolation
+
+Set `OPENCODE_DISABLE_CLAUDE_CODE=*` if you want OpenCode to ignore a
+`CLAUDE.md` shared with Claude Code, so only `AGENTS.md` is consulted.
+
+## Documentation
+
+- [opencode.ai/docs/rules](https://opencode.ai/docs/rules/)
+- [opencode.ai/docs/config](https://opencode.ai/docs/config/)
+- [opencode.ai/docs/mcp-servers](https://opencode.ai/docs/mcp-servers/)
+- [opencode.ai/docs/commands](https://opencode.ai/docs/commands/)
+- [opencode.ai/docs/agents](https://opencode.ai/docs/agents/)
+- [opencode.ai/docs/skills](https://opencode.ai/docs/skills/)
+- [opencode.ai/docs/permissions](https://opencode.ai/docs/permissions/)
+
+<!-- OPENCODE:END -->

package/templates/skills/cli/opencode/SKILL.md

@@ -1,28 +1,82 @@
----
-name: "Opencode"
-description: "Tool: Open-source AI assistant"
-version: "1.0.0"
-category: "cli"
-author: "Rulebook"
-tags: ["cli", "cli-tool"]
-dependencies: []
-conflicts: []
----
-<!-- OPENCODE:START -->
-# OpenCode Rules
-
-**Tool**: Open-source AI assistant
-
-## Usage
-
-```
-"Follow @AGENTS.md. Implement [feature] with tests."
-```
-
-## Workflow
-
-1. Reference AGENTS.md
-2. Review code
-3. Run quality checks
-
-<!-- OPENCODE:END -->
+---
+name: "Opencode"
+description: "OpenCode (open-source terminal coding agent by SST). Reads AGENTS.md natively. Rulebook generates opencode.json plus .opencode/commands, .opencode/agents, .opencode/skills."
+version: "1.0.0"
+category: "cli"
+author: "Rulebook"
+tags: ["cli", "opencode", "agents", "mcp"]
+dependencies: []
+conflicts: []
+---
+<!-- OPENCODE:START -->
+# OpenCode Rules
+
+**Tool**: [OpenCode](https://opencode.ai) — open-source terminal coding agent.
+
+## Generated surface area
+
+When Rulebook detects OpenCode (`opencode.json` / `.opencode/` / `opencode`
+binary on PATH), it generates:
+
+- `opencode.json` with `$schema`, `mcp.rulebook`, and `instructions`.
+  Existing user keys (model, theme, permission, custom agents) are preserved.
+- `.opencode/commands/<name>.md` for every user-invocable Rulebook slash
+  command, with OpenCode-shaped frontmatter (`description`).
+- `.opencode/agents/<role>.md` for every Rulebook role agent
+  (researcher, implementer, tester, code-reviewer, architect, docs-writer,
+  security-reviewer, build-engineer, team-lead, etc.) with model tier
+  mapped (`haiku → claude-haiku-4-5`, `sonnet → claude-sonnet-4-6`,
+  `opus → claude-opus-4-7`) and a synthesized `permission` block.
+- `.opencode/skills/<normalized-name>/SKILL.md` for every Rulebook dev
+  skill, name-normalized to `[a-z0-9](-[a-z0-9])*` (≤64 chars) and
+  description bounded to ≤1024 chars.
+- `.opencode/.rulebook-managed.json` — sidecar listing managed keys so
+  `rulebook update` knows what to refresh vs. preserve.
+
+## Idempotency
+
+Files carrying the `<!-- RULEBOOK:START -->` marker are managed and
+refreshed on every `rulebook update`. Files without the marker are
+treated as user-owned and left untouched.
+
+## Sequential editing
+
+OpenCode follows the same Rulebook discipline as Claude Code:
+
+- Edit files one at a time.
+- For 3+ files, decompose into 1–2 file sub-tasks.
+- Diagnostic-first: type-check / lint before tests.
+
+## Quality gates
+
+- Type-check / lint must be clean.
+- Tests must pass.
+- Coverage ≥95%.
+- Pre-commit hooks enforce these — never `--no-verify`.
+
+## MCP
+
+`mcp.rulebook` in `opencode.json` exposes `rulebook_task_*`,
+`rulebook_memory_*`, `rulebook_decision_*`, `rulebook_knowledge_*`,
+`rulebook_learn_*`. Prefer MCP tools over shell commands when both
+exist.
+
+## Workflow
+
+1. Reference `AGENTS.md` and `.rulebook/specs/*.md`.
+2. Use `/rulebook-task-create`, `/rulebook-task-list`, `/handoff`.
+3. Delegate to role agents (`@researcher`, `@implementer`, `@tester`).
+4. Run quality checks before committing.
+5. Save learnings (`rulebook_memory_save`, `rulebook_knowledge_add`).
+
+## Documentation
+
+- [opencode.ai/docs/rules](https://opencode.ai/docs/rules/)
+- [opencode.ai/docs/config](https://opencode.ai/docs/config/)
+- [opencode.ai/docs/mcp-servers](https://opencode.ai/docs/mcp-servers/)
+- [opencode.ai/docs/commands](https://opencode.ai/docs/commands/)
+- [opencode.ai/docs/agents](https://opencode.ai/docs/agents/)
+- [opencode.ai/docs/skills](https://opencode.ai/docs/skills/)
+- [opencode.ai/docs/permissions](https://opencode.ai/docs/permissions/)
+
+<!-- OPENCODE:END -->