Business operating system for Claude Code — 57 skills, 21 agents, smart daemon. Unified inbox (WhatsApp/Email/Slack/Telegram), autonomous PR merge, full-AWS monitoring, revenue (Stripe+RevenueCat), e-commerce (Shopify), marketing (Klaviyo/Meta/GA4), voice (Bland/ElevenLabs), APM (Datadog/NewRelic/OTEL), YOLO mode.
Shell agent-teamsai-agentai-automationanthropicautonomous-agentawsbusiness-operationsclaudeclaude-codeclaude-code-plugindevopsecommerceinbox-zeroklaviyomarketingmcpmorning-briefingpr-automationshopifyterminal
feat(ops-release): AI changelog + ops-sync-docs + wiki maintenance; reconcile doc counts to 57/21 (#587)
Aurora Capital8cb4ad963be0
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonindex 8449df96..3564d5d6 100644--- a/.claude-plugin/marketplace.json+++ b/.claude-plugin/marketplace.json@@ -9,7 +9,7 @@"plugins": [{"name": "ops",- "description": "Business operations command center for Claude Code — 38 skills, 20 agents, smart background daemon. Manage communications (WhatsApp/Email/Slack/Telegram), projects, infrastructure (AWS), revenue (Stripe+RevenueCat), e-commerce, marketing, monitoring (Datadog/New Relic/OTEL), voice, and smart home (Homey Pro). Includes /ops:ops-ar A&R (audio analysis + demo verdict cards), /gtm go-to-market planner, /ops:projects portfolio dashboard, /ops:ops-home control surface, and YOLO autonomous mode with 4 parallel C-suite agents.",+ "description": "Business operations command center for Claude Code — 57 skills, 21 agents, smart background daemon. Manage communications (WhatsApp/Email/Slack/Telegram), projects, infrastructure (AWS), revenue (Stripe+RevenueCat), e-commerce, marketing, monitoring (Datadog/New Relic/OTEL), voice, and smart home (Homey Pro). Includes /ops:ops-ar A&R (audio analysis + demo verdict cards), /gtm go-to-market planner, /ops:projects portfolio dashboard, /ops:ops-home control surface, and YOLO autonomous mode with 4 parallel C-suite agents.","source": "./claude-ops","version": "2.32.0","category": "productivity",diff --git a/README.md b/README.mdindex 8daf31ac..b2e2d46d 100644--- a/README.md+++ b/README.md@@ -4,11 +4,11 @@**Business Operating System for Claude Code**-+--++@@ -103,7 +103,7 @@ claude --plugin-dir ./claude-ops/claude-ops## Commands-All 36 skills, grouped by category:+All 57 skills, grouped by category:| 🧭 Navigation | 📊 Daily Ops || -------------------------------- | -------------------------------------- |@@ -408,7 +408,7 @@ Just [Claude Code](https://claude.ai/code) 1.0+. Everything else is installed au- **`ops-memory-extractor` Claude Code OAuth support** — prefers the OAuth token stored in the macOS Keychain (`Claude Code-credentials`) so memory extraction is billed against the Claude Max subscription instead of the API credit. Falls back to `ANTHROPIC_API_KEY`. The OAuth token is never exported to the shell.- **Persistent WhatsApp `--follow`** — `wacli-keepalive.sh` no longer tears down the follower within 5-20 min of start. `INITIAL_BACKFILL_DELAY=30` lets the follower stabilize before the first `--once` sweep, and a reentrant guard prevents overlapping sweeps.- **MCP auto-reconnect** — `PreToolUse` hook kills and respawns any disconnected MCP server without user prompting.-- **30 skills, 14 agents** — up from 21/12 in v0.6.0. Full list in [`claude-ops/README.md`](./claude-ops/README.md#features).+- **57 skills, 21 agents** — up from 21/12 in v0.6.0. Full list in [`claude-ops/README.md`](./claude-ops/README.md#features).- **Models:** C-suite on **Opus 4.6**, scanners/monitors/fix agents on **Sonnet 4.6**, memory extractor on **Haiku 4.5**.---diff --git a/claude-ops/.claude-plugin/plugin.json b/claude-ops/.claude-plugin/plugin.jsonindex bb06d259..2b23228e 100644--- a/claude-ops/.claude-plugin/plugin.json+++ b/claude-ops/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ops","version": "2.32.0",- "description": "Business operations command center for Claude Code — 39 skills, 21 agents, and a smart background daemon that manage communications (WhatsApp/Email/Slack/Telegram), projects, infrastructure (all AWS services), revenue (Stripe + RevenueCat), e-commerce (Shopify), marketing (Klaviyo/Meta/GA4/GSC), monitoring (Datadog/New Relic/OTEL), and voice (Bland AI/ElevenLabs/Whisper). Includes /ops:ops-ar A&R (audio analysis + demo verdict cards), /gtm go-to-market planner, /ops:projects portfolio dashboard, YOLO mode for autonomous operation with 4 parallel C-suite agents, /ops:ops-home smart home control via Homey Pro, and /ops:ops-unifi UniFi network control (Site Manager + Network + Protect APIs).",+ "description": "Business operations command center for Claude Code — 57 skills, 21 agents, and a smart background daemon that manage communications (WhatsApp/Email/Slack/Telegram), projects, infrastructure (all AWS services), revenue (Stripe + RevenueCat), e-commerce (Shopify), marketing (Klaviyo/Meta/GA4/GSC), monitoring (Datadog/New Relic/OTEL), and voice (Bland AI/ElevenLabs/Whisper). Includes /ops:ops-ar A&R (audio analysis + demo verdict cards), /gtm go-to-market planner, /ops:projects portfolio dashboard, YOLO mode for autonomous operation with 4 parallel C-suite agents, /ops:ops-home smart home control via Homey Pro, and /ops:ops-unifi UniFi network control (Site Manager + Network + Protect APIs).","author": {"name": "Lifecycle Innovations Limited","url": "https://github.com/Lifecycle-Innovations-Limited"diff --git a/claude-ops/README.md b/claude-ops/README.mdindex d5ada49a..7c5c7332 100644--- a/claude-ops/README.md+++ b/claude-ops/README.md@@ -140,8 +140,8 @@ The background memory extractor now prefers the Claude Code OAuth token stored i### Full Plugin Feature Adoption-- All 35 skills: `effort`, `maxTurns`, `disallowedTools`, `model` annotations-- All 18 agents: `memory` (cross-session learning), `initialPrompt`, `isolation`+- All 57 skills: `effort`, `maxTurns`, `disallowedTools`, `model` annotations+- All 21 agents: `memory` (cross-session learning), `initialPrompt`, `isolation`- PreToolUse hooks for WhatsApp health checks and MCP auto-reconnect- Runtime Context loading in every skill (preferences, daemon health, memories, secrets)- CLI/API reference tables in all operational skillsdiff --git a/claude-ops/bin/ops-release b/claude-ops/bin/ops-releaseindex fc3ac6d4..111dca13 100755--- a/claude-ops/bin/ops-release+++ b/claude-ops/bin/ops-release@@ -10,23 +10,34 @@# 2. .claude-plugin/marketplace.json (repo root) .plugins[name==ops].version <- the marketplace registry# 3. package.json (auto-detected: claude-ops/ or repo root) .version# 4. claude-ops/CHANGELOG.md new "## [X.Y.Z] - DATE" section+# (AI-written from the commit range — see --no-ai)+# 5. docs counts/badges ops-sync-docs reconciles every skill/agent+# count + version badge to the real tree (--no-docs)+# 6. GitHub wiki counts/version synced + a Release-Notes entry+# pushed after merge (--no-wiki)## Flow:-# fetch → isolated worktree off origin/main → bump all version files → commit-# → push → open PR to main → (optional) squash-merge --admin → (optional) tag vX.Y.Z+# fetch → isolated worktree off origin/main → bump version files → AI changelog+# → ops-sync-docs → commit → push → PR to main → (optional) squash-merge --admin+# → (optional) tag vX.Y.Z → (optional) wiki sync## Usage:# ops-release [--type patch|minor|major] [--version X.Y.Z]# [--notes "markdown body for the changelog"]+# [--no-ai] [--no-docs] [--no-wiki]# [--no-merge] [--no-tag] [--dry-run] [-h|--help]#-# Defaults: --type patch, auto squash-merge, tag vX.Y.Z.+# Defaults: --type patch, AI changelog, doc-count sync, auto squash-merge, tag,+# wiki sync. --notes overrides the AI changelog. --no-ai falls back to+# commit subjects.# Examples:-# ops-release # patch bump, auto-merge + tag+# ops-release # patch bump, AI changelog, docs+wiki sync, merge+tag# ops-release --type minor # minor bump# ops-release --version 3.0.0 # explicit version+# ops-release --notes "..." # hand-written changelog (skips AI)+# ops-release --no-ai --no-wiki # commit-subject changelog, no wiki push# ops-release --no-merge # open the PR, leave it for review-# ops-release --dry-run # show what would change, touch nothing+# ops-release --dry-run # show what would change (incl. AI changelog), touch nothing## After a release lands, refresh the local install:# /plugin marketplace update ops-marketplace (then update the `ops` plugin)@@ -51,6 +62,7 @@ for cand in "claude-ops/package.json" "package.json"; dodonebump_type="patch"; explicit_ver=""; notes=""; do_merge=1; do_tag=1; dry_run=0+do_ai=1; do_docs=1; do_wiki=1while [ $# -gt 0 ]; docase "$1" in--type) bump_type="$2"; shift 2 ;;@@ -58,8 +70,11 @@ while [ $# -gt 0 ]; do--notes) notes="$2"; shift 2 ;;--no-merge) do_merge=0; shift ;;--no-tag) do_tag=0; shift ;;+ --no-ai) do_ai=0; shift ;;+ --no-docs) do_docs=0; shift ;;+ --no-wiki) do_wiki=0; shift ;;--dry-run) dry_run=1; shift ;;- -h|--help) sed -n '2,32p' "$0"; exit 0 ;;+ -h|--help) sed -n '2,43p' "$0"; exit 0 ;;*) echo "ops-release: unknown arg '$1'" >&2; exit 2 ;;esacdone@@ -90,15 +105,42 @@ fiREL_DATE="$(date +%F)"echo "ops-release: $CUR -> $NEW (type=$bump_type, date=$REL_DATE)"-# ----- changelog body: explicit --notes, else commit subjects since last CHANGELOG bump -----+# ----- changelog body -----+# Priority: explicit --notes > AI-synthesized (Keep a Changelog style) > commit subjects.+ai_used=0if [ -z "$notes" ]; thenprev_marker="$(git -C "$REPO_ROOT" log -1 --format=%H -- "$CHANGELOG" 2>/dev/null || true)"+ commits=""; range=""if [ -n "$prev_marker" ]; then- commits="$(git -C "$REPO_ROOT" log --no-merges --format='- %s' "$prev_marker"..HEAD 2>/dev/null || true)"+ range="$prev_marker..HEAD"+ commits="$(git -C "$REPO_ROOT" log --no-merges --format='- %s' "$range" 2>/dev/null || true)"fi- notes="${commits:-- (no notes provided)}"+ if [ "$do_ai" -eq 1 ] && command -v claude >/dev/null 2>&1 && [ -n "$commits" ]; then+ echo "ops-release: synthesizing changelog with AI (--no-ai to skip)…"+ diffstat="$(git -C "$REPO_ROOT" diff --stat "$range" 2>/dev/null | tail -40 || true)"+ ai_prompt="You are writing the CHANGELOG entry for v$NEW of 'claude-ops', a public open-source Claude Code plugin. Summarize the changes below into Keep-a-Changelog style markdown using only the relevant subset of these headings: '### Added', '### Changed', '### Fixed', '### Removed' (omit empty sections). Write tight, user-facing bullets grouped by theme — not one bullet per commit. Output ONLY the markdown section body (the ### headings and bullets); no '## [version]' header, no preamble, no code fences. Never include personal names, emails, paths under /Users or /home, tokens, or internal hostnames/URLs.++Commits:+$commits++Diffstat:+$diffstat"+ ai_out="$(printf '%s' "$ai_prompt" | claude -p 2>/dev/null || true)"+ ai_out="$(printf '%s\n' "$ai_out" | sed -E '/^```/d')" # strip any stray code fences+ if printf '%s' "$ai_out" | grep -qE '^### (Added|Changed|Fixed|Removed)'; then+ notes="$ai_out"; ai_used=1+ echo "ops-release: AI changelog ready"+ else+ echo "ops-release: AI output unusable — falling back to commit subjects"+ fi+ fi+ [ -z "$notes" ] && notes="${commits:-- (no notes provided)}"+fi+if [ "$ai_used" -eq 1 ]; then+ changelog_section=$'## ['"$NEW"$'] - '"$REL_DATE"$'\n\n'"$notes"$'\n'+else+ changelog_section=$'## ['"$NEW"$'] - '"$REL_DATE"$'\n\n### Changed\n'"$notes"$'\n'fi-changelog_section=$'## ['"$NEW"$'] - '"$REL_DATE"$'\n\n### Changed\n'"$notes"$'\n'if [ "$dry_run" -eq 1 ]; thenecho "--- DRY RUN: would set version $CUR -> $NEW in:"@@ -148,6 +190,11 @@ rm -f "$sec_file"echo "ops-release: bumped plugin.json + marketplace.json$([ -n "$PACKAGE_REL" ] && echo " + $PACKAGE_REL") + CHANGELOG.md"+# 5. reconcile documentation counts/badges to the (now-bumped) tree — deterministic.+if [ "$do_docs" -eq 1 ] && [ -x "$WT/claude-ops/bin/ops-sync-docs" ]; then+ "$WT/claude-ops/bin/ops-sync-docs" "$WT" || echo "ops-release: ops-sync-docs returned non-zero (non-fatal)"+fi+# ----- commit, push, PR -----git -C "$WT" add -Agit -C "$WT" commit --no-verify -m "release: v$NEW" >/dev/null@@ -165,6 +212,45 @@ if [ "$do_merge" -eq 1 ]; thengit -C "$REPO_ROOT" push origin "v$NEW"echo "ops-release: tagged v$NEW"fi++ # ----- wiki: keep the GitHub wiki's counts/version in lockstep + log the release -----+ if [ "$do_wiki" -eq 1 ]; then+ echo "ops-release: syncing wiki (--no-wiki to skip)…"+ wiki_tmp="$(mktemp -d)"+ if git clone --depth 1 "https://github.com/${GH_REPO}.wiki.git" "$wiki_tmp" >/dev/null 2>&1; then+ SK=0; for d in "$WT"/claude-ops/skills/*/; do [ -f "$d/SKILL.md" ] && SK=$((SK+1)); done+ AG=0; for f in "$WT"/claude-ops/agents/*.md; do [ -f "$f" ] && AG=$((AG+1)); done+ for page in "$wiki_tmp"/*.md; do+ [ -f "$page" ] || continue+ sed -E -i.bak \+ -e "s/[0-9]+ skills, [0-9]+ agents/${SK} skills, ${AG} agents/g" \+ -e "s/([Aa]ll )[0-9]+ skills/\1${SK} skills/g" \+ -e "s/([Aa]ll )[0-9]+ agents/\1${AG} agents/g" \+ -e "s#(badge/skills-)[0-9]+-#\1${SK}-#g" \+ -e "s#(badge/agents-)[0-9]+-#\1${AG}-#g" \+ -e "s#(badge/version-)[0-9][0-9.]*-#\1${NEW}-#g" "$page" 2>/dev/null || true+ rm -f "$page.bak"+ done+ relpage="$wiki_tmp/Release-Notes.md"+ { printf '## v%s — %s\n\n%s\n\n' "$NEW" "$REL_DATE" "$notes"; [ -f "$relpage" ] && cat "$relpage"; } >"$relpage.new" && mv "$relpage.new" "$relpage"+ if [ -n "$(git -C "$wiki_tmp" status --porcelain)" ]; then+ git -C "$wiki_tmp" add -A+ git -C "$wiki_tmp" -c user.email="[email protected]" -c user.name="ops-release" \+ commit -m "wiki: sync to v$NEW (counts + release notes)" >/dev/null 2>&1 || true+ if git -C "$wiki_tmp" push origin HEAD >/dev/null 2>&1; then+ echo "ops-release: wiki synced to v$NEW"+ else+ echo "ops-release: wiki push failed (non-fatal — check write access)"+ fi+ else+ echo "ops-release: wiki already in sync"+ fi+ else+ echo "ops-release: wiki clone failed or no wiki yet (non-fatal)"+ fi+ rm -rf "$wiki_tmp"+ fi+echo "ops-release: done. Refresh local install with: /plugin marketplace update ops-marketplace"elseecho "ops-release: PR left open for review (use: gh pr merge $PR_URL --squash --admin)"diff --git a/claude-ops/bin/ops-sync-docs b/claude-ops/bin/ops-sync-docsnew file mode 100755index 00000000..e0d8ae8b--- /dev/null+++ b/claude-ops/bin/ops-sync-docs@@ -0,0 +1,82 @@+#!/usr/bin/env bash+# ops-sync-docs — keep documentation counts in lockstep with the actual tree.+#+# Counts the real skills (claude-ops/skills/<name>/SKILL.md) and agents+# (claude-ops/agents/<name>.md), then rewrites every "<N> skills, <M> agents"+# count, every shields.io skills/agents/version badge, and every "All <N> skills"+# / "All <N> agents" headline so the published docs never drift from reality.+#+# Deterministic (no AI, no network) and idempotent: running it on an already+# in-sync tree changes nothing. It rewrites ONLY current-state count tokens in+# known files — never historical "up from X/Y" changelog prose (that phrasing+# does not match the "All <N>" / "<N> skills, <M> agents" patterns).+#+# ops-release runs this automatically before cutting a release; run it standalone+# after adding/removing a skill or agent:+# claude-ops/bin/ops-sync-docs [--dry-run] [<repo-root>]+#+# Public repo: no personal data. All paths derive from the script location. (Rule 0)++set -euo pipefail++DRY=0; ARG_ROOT=""+for a in "$@"; do+ case "$a" in+ --dry-run) DRY=1 ;;+ *) ARG_ROOT="$a" ;;+ esac+done++SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"+REPO_ROOT="${ARG_ROOT:-$(cd "$SCRIPT_DIR/../.." && pwd)}" # <repo>+PLUGIN_DIR="$REPO_ROOT/claude-ops"+PLUGIN_JSON="$PLUGIN_DIR/.claude-plugin/plugin.json"+MKT_JSON="$REPO_ROOT/.claude-plugin/marketplace.json"++command -v jq >/dev/null 2>&1 || { echo "ops-sync-docs: jq required" >&2; exit 1; }+[[ -f "$PLUGIN_JSON" ]] || { echo "ops-sync-docs: plugin.json not found at $PLUGIN_JSON" >&2; exit 1; }++# ----- ground truth from the tree -----+S=0; for d in "$PLUGIN_DIR"/skills/*/; do [[ -f "$d/SKILL.md" ]] && S=$((S+1)); done+A=0; for f in "$PLUGIN_DIR"/agents/*.md; do [[ -f "$f" ]] && A=$((A+1)); done+V="$(jq -r '.version' "$PLUGIN_JSON")"+[[ "$S" -gt 0 && "$A" -gt 0 ]] || { echo "ops-sync-docs: refusing to write zero counts (S=$S A=$A)" >&2; exit 1; }+echo "ops-sync-docs: tree = ${S} skills, ${A} agents, version ${V}"++changed=0+apply() { # apply <file> <sed -e expr ...>+ local f="$1"; shift+ [[ -f "$f" ]] || return 0+ local tmp; tmp="$(mktemp)"+ sed -E "$@" "$f" > "$tmp" 2>/dev/null || { rm -f "$tmp"; return 0; }+ if ! cmp -s "$f" "$tmp"; then+ echo " $([[ $DRY -eq 1 ]] && echo 'would update' || echo 'updated'): ${f#$REPO_ROOT/}"+ changed=$((changed+1))+ [[ $DRY -eq 1 ]] || cp "$tmp" "$f"+ fi+ rm -f "$tmp"+}++COUNT_E=(-e "s/[0-9]+ skills, [0-9]+ agents/${S} skills, ${A} agents/g")+BADGE_E=(-e "s#(badge/skills-)[0-9]+-#\1${S}-#g"+ -e "s#(badge/agents-)[0-9]+-#\1${A}-#g"+ -e "s#(badge/version-)[0-9][0-9.]*-#\1${V}-#g")+HEAD_E=(-e "s/([Aa]ll )[0-9]+ skills/\1${S} skills/g"+ -e "s/([Aa]ll )[0-9]+ agents/\1${A} agents/g")++# Authoritative metadata (registry + plugin manifest) — count phrase only.+apply "$PLUGIN_JSON" "${COUNT_E[@]}"+apply "$MKT_JSON" "${COUNT_E[@]}"++# READMEs — badges + headlines (root README keeps historical "N skills, M agents" bullets frozen).+apply "$REPO_ROOT/README.md" "${BADGE_E[@]}" "${HEAD_E[@]}"+apply "$PLUGIN_DIR/README.md" "${COUNT_E[@]}" "${BADGE_E[@]}" "${HEAD_E[@]}"++# Reference docs + index — badges + headlines.+apply "$PLUGIN_DIR/docs/skills-reference.md" "${BADGE_E[@]}" "${HEAD_E[@]}"+apply "$PLUGIN_DIR/docs/agents-reference.md" "${BADGE_E[@]}" "${HEAD_E[@]}"+apply "$PLUGIN_DIR/docs/INDEX.md" "${HEAD_E[@]}"++[[ "$changed" -eq 0 ]] && echo " already in sync — nothing to do"+echo "ops-sync-docs: done (${changed} file(s) $([[ $DRY -eq 1 ]] && echo 'would change' || echo 'changed'))"+exit 0diff --git a/claude-ops/docs/INDEX.md b/claude-ops/docs/INDEX.mdindex 3dfaadc9..a3d17388 100644--- a/claude-ops/docs/INDEX.md+++ b/claude-ops/docs/INDEX.md@@ -24,8 +24,8 @@ _Top-level map of every doc file in `claude-ops/docs/`._| Doc | Subject || ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |-| [`agents-reference.md`](agents-reference.md) | Catalog of all 18 agents (4 v2 specialists + 14 v1 scanners/fixers/C-suite). |-| [`skills-reference.md`](skills-reference.md) | Catalog of all 35 skills with usage examples. |+| [`agents-reference.md`](agents-reference.md) | Catalog of all 21 agents (4 v2 specialists + 14 v1 scanners/fixers/C-suite). |+| [`skills-reference.md`](skills-reference.md) | Catalog of all 57 skills with usage examples. || [`daemon-guide.md`](daemon-guide.md) | The v1 ops-daemon (briefing pre-warm, whatsapp-bridge-sync, memory-extractor, etc). || [`docker.md`](docker.md) | Running claude-ops in a container. || [`marketplace-submissions.md`](marketplace-submissions.md) | Publishing your own plugin to the same marketplace. |diff --git a/claude-ops/docs/agents-reference.md b/claude-ops/docs/agents-reference.mdindex 7e6c1302..9307a148 100644--- a/claude-ops/docs/agents-reference.md+++ b/claude-ops/docs/agents-reference.md@@ -2,10 +2,10 @@# Agents Reference-_All 18 agents that power claude-ops — scanners, fixers, C-suite analysts, and the daemon brain_+_All 21 agents that power claude-ops — scanners, fixers, C-suite analysts, and the daemon brain_-[](../CHANGELOG.md)-[](.)+[](../CHANGELOG.md)+[](.)[](.)[](.)[](.)@@ -14,7 +14,7 @@ _All 18 agents that power claude-ops — scanners, fixers, C-suite analysts, and----All 18 agents in claude-ops v2.1.0. Agent files live in `agents/`.+All 21 agents in claude-ops v2.1.0. Agent files live in `agents/`.> [!NOTE]> v2.0 added four pre-installed specialists — `general-purpose` (override), `deploy-fixer`, `build-fixer`, `dependency-auditor`. These power the deploy auto-fix subsystem and are silently routed to via the PreToolUse:Agent hook. See [`agents.md`](agents.md) for the v2 specialist catalog and [`deploy-fix.md`](deploy-fix.md) for the auto-fix subsystem.diff --git a/claude-ops/docs/skills-reference.md b/claude-ops/docs/skills-reference.mdindex b3f38b8d..fffd9556 100644--- a/claude-ops/docs/skills-reference.md+++ b/claude-ops/docs/skills-reference.md@@ -2,10 +2,10 @@# Skills Reference-_All 35 skills available in claude-ops — your business operations command surface (v2.0 added `/ops:deploy-fix`, `/ops:recap`, `/ops:rotate`, `/ops:rotate-setup`; v2.0.6 added `/ops:credentials`; v2.0.8 added multi-workspace Slack)_+_All 57 skills available in claude-ops — your business operations command surface (v2.0 added `/ops:deploy-fix`, `/ops:recap`, `/ops:rotate`, `/ops:rotate-setup`; v2.0.6 added `/ops:credentials`; v2.0.8 added multi-workspace Slack)_-[](../CHANGELOG.md)-[](.)+[](../CHANGELOG.md)+[](.)[](../LICENSE)[](.)diff --git a/claude-ops/skills/ops-release/SKILL.md b/claude-ops/skills/ops-release/SKILL.mdindex 7956ea3e..034b29f1 100644--- a/claude-ops/skills/ops-release/SKILL.md+++ b/claude-ops/skills/ops-release/SKILL.md@@ -1,7 +1,7 @@---name: ops-releasedescription: Publish a new version of the claude-ops ("ops") plugin in one command — bump plugin.json + marketplace.json + package.json, prepend the CHANGELOG, open the release PR, admin squash-merge it to main, and tag vX.Y.Z. Use when shipping a fix/feature that has already merged to main and you want it published so /ops:ops-update can pull it down. This is the publish side; /ops:ops-update is the consume side.-argument-hint: '[--type patch|minor|major] [--version X.Y.Z] [--notes "changelog body"] [--dry-run] [--no-merge] [--no-tag]'+argument-hint: '[--type patch|minor|major] [--version X.Y.Z] [--notes "changelog body"] [--no-ai] [--no-docs] [--no-wiki] [--dry-run] [--no-merge] [--no-tag]'allowed-tools:- Bash- Read@@ -92,8 +92,11 @@ tag. Surface the final line verbatim and then tell the user to pull it down:| ---------------------------- | ------------------------------------------------------------------------- || `--type patch\|minor\|major` | Semver bump from the current version (default `patch`). || `--version X.Y.Z` | Set an exact target version instead of bumping. |-| `--notes "…"` | Markdown body prepended to the CHANGELOG under the new version. Quote it. |-| `--dry-run` | Report only; change nothing. Always run this first. |+| `--notes "…"` | Markdown body prepended to the CHANGELOG under the new version. Quote it. Overrides the AI changelog. |+| `--no-ai` | Skip AI changelog synthesis; fall back to commit subjects under `### Changed`. |+| `--no-docs` | Skip the `ops-sync-docs` count/badge reconciliation step. |+| `--no-wiki` | Skip syncing the GitHub wiki (counts/version + Release-Notes entry). |+| `--dry-run` | Report only; change nothing (still previews the AI changelog). Always run this first. || `--no-merge` | Open the release PR but do NOT admin-merge it (leave for manual review). || `--no-tag` | Skip pushing the `vX.Y.Z` tag. |@@ -102,7 +105,18 @@ tag. Surface the final line verbatim and then tell the user to pull it down:1. `claude-ops/.claude-plugin/plugin.json` — `.version`2. `.claude-plugin/marketplace.json` (repo root) — `.plugins[name==ops].version`3. `claude-ops/package.json` — `.version` (if present)-4. `claude-ops/CHANGELOG.md` — prepends a `## [X.Y.Z] - <date>` block with the notes+4. `claude-ops/CHANGELOG.md` — prepends a `## [X.Y.Z] - <date>` block. By default the+ body is **AI-synthesized** from the commit range in Keep a Changelog style+ (`### Added/Changed/Fixed/Removed`); `--notes` overrides it, `--no-ai` falls back+ to commit subjects.+5. **Docs counts** — runs `bin/ops-sync-docs`, which reconciles every skill/agent+ count, shields.io badge, and version badge across `plugin.json`,+ `marketplace.json`, the READMEs, and `docs/*-reference.md` to the real tree.+ Deterministic and idempotent; never touches historical "up from X/Y" prose.+ Skip with `--no-docs`. (Run `bin/ops-sync-docs` standalone any time you add or+ remove a skill/agent.)+6. **GitHub wiki** — after merge+tag, clones the wiki, syncs its counts/version, and+ prepends a `Release-Notes.md` entry for the new version. Skip with `--no-wiki`.It works inside an **isolated worktree** (`$REPO_ROOT/.worktrees/release/vX.Y.Z`,branched from `origin/main`), so a dirty main checkout never leaks unrelated WIPdiff --git a/claude-ops/skills/ops-update/SKILL.md b/claude-ops/skills/ops-update/SKILL.mdindex e014990b..9cdb38ea 100644--- a/claude-ops/skills/ops-update/SKILL.md+++ b/claude-ops/skills/ops-update/SKILL.md@@ -1,7 +1,7 @@---name: ops-updatedescription: Upgrade the local claude-ops ("ops") plugin to the latest published version in one command — refresh the marketplace catalogue, update the installed plugin (with stale-cache force-reinstall fallback), reapply local cache patches, prune every old cache version, rewrite stale version-pinned paths, run per-version migrations, then prompt to reload. Use when the box is on an older plugin version, after a release, or when the cache looks stale.-argument-hint: '[--dry-run|--force|--to X.Y.Z|--no-prune|--no-patches|--no-rewrite]'+argument-hint: '[--dry-run|--force|--to X.Y.Z|--no-prune|--no-patches|--no-rewrite|--no-localsync]'allowed-tools:- Bash- Read@@ -14,7 +14,7 @@ Upgrades the local **claude-ops** plugin to the newest version published in the`ops-marketplace` catalogue, then leaves the box clean: no stale cache dirs, nodangling version-pinned paths.-The workhorse is **`${CLAUDE_PLUGIN_ROOT}/bin/ops-update`**. It runs an 8-step loop:+The workhorse is **`${CLAUDE_PLUGIN_ROOT}/bin/ops-update`**. It runs a 9-step loop:1. **Refresh catalogue** — `claude plugin marketplace update ops-marketplace` (git-pulls the clone).2. **Resolve target** — newest version from the refreshed `marketplace.json` (or `--to X.Y.Z`).@@ -22,8 +22,9 @@ The workhorse is **`${CLAUDE_PLUGIN_ROOT}/bin/ops-update`**. It runs an 8-step l4. **Reapply patches** — runs idempotent scripts in `scripts/cache-patches/` against the new cache (empty when all fixes are upstream — the desired state).5. **Prune** — deletes every old `cache/ops-marketplace/ops/<ver>/` except the new one.6. **Rewrite** — fixes stale `cache/.../ops/<oldver>/` paths in live configs/scripts/systemd units only (never logs, memory, or transcripts — those use `${CLAUDE_PLUGIN_ROOT}` at runtime so they self-resolve).-7. **Migrate** — runs `ops-post-update-migrate` (idempotent, per-version).-8. **Report** — old→new, what changed, and that a restart / `/reload-plugins` is needed to load it.+7. **Migrate** — runs `ops-post-update-migrate` (idempotent, per-version). It also maintains a stable `cache/.../ops/current/` directory (rsynced from the new version and repointed in `installed_plugins.json`) so Claude Code GC'ing the old versioned dir mid-session never causes "Plugin directory does not exist" hook errors.+8. **Local sync** — if a linked local source checkout of this repo is present under `~/Projects`, fast-forwards its `main` to `origin/main` so a dev clone never silently drifts behind the published release. Acts only on a clean `main` (never clobbers uncommitted WIP, a feature branch, or unpushed commits); a no-op when no checkout exists. Skip with `--no-localsync`.+9. **Report** — old→new, what changed, and that a restart / `/reload-plugins` is needed to load it.## How to run it@@ -72,9 +73,10 @@ Code constraint, not a failure.| `--dry-run` | Report only; change nothing. Always run this first. || `--force` | Force-reinstall even when the CLI claims "already latest" (bug #61954). || `--to X.Y.Z` | Target a specific version instead of the catalogue's newest. |-| `--no-prune` | Keep old cache versions. |-| `--no-patches` | Skip the cache-patch reapply step. |-| `--no-rewrite` | Skip the stale-version-path rewrite step. |+| `--no-prune` | Keep old cache versions. |+| `--no-patches` | Skip the cache-patch reapply step. |+| `--no-rewrite` | Skip the stale-version-path rewrite step. |+| `--no-localsync` | Skip fast-forwarding a linked local source checkout's `main`. |## Mobile / SSH (Rule 7)