docs(agents): merge release-* playbooks into release.md (init 0009 PR 2.3)

.agents/skills-lock.json

@@ -34,7 +34,7 @@
     "sergeant-mobile-expo": {
       "source": "local",
       "sourceType": "local",
-      "computedHash": "dd1405aa2ed895dd4943a1b3c4a280fbeb037eb2fe2738e128ff0359e01f723c"
+      "computedHash": "3d14e765410a65daaf09bec51e2968956969609c78f9804d9d58b6840c36a47f"
     },
     "sergeant-monorepo-boundaries": {
       "source": "local",
@@ -44,12 +44,12 @@
     "sergeant-review-and-merge": {
       "source": "local",
       "sourceType": "local",
-      "computedHash": "65467d83dc3d2e79865ca9c6d8a854c87f99b8c79b814229a23329a8602155e9"
+      "computedHash": "2068420a7cf9ce9ff1c06a199699bfd1568565c68f8b285b1dd0fd96450a2844"
     },
     "sergeant-server-api": {
       "source": "local",
       "sourceType": "local",
-      "computedHash": "1d0bb37c3685b8eaee6d7d620a78420169d2d7df69ee192dcc25eab32d725e5d"
+      "computedHash": "31b129cb41fd6e3ef4a7bcd1d4547fda71b10092319cc4dd50b81df03f6aafc8"
     },
     "sergeant-start-here": {
       "source": "local",
@@ -59,7 +59,7 @@
     "sergeant-web-ui": {
       "source": "local",
       "sourceType": "local",
-      "computedHash": "e71ed7c155d84fea20ca3622f664c25f410dc39dc6be0eaa8b2c38ff24986bbc"
+      "computedHash": "87269a93b90d6b77f91f7bb545e775f732a02733dc7879aa06969b0d6f20a18b"
     }
   }
 }

.agents/skills/sergeant-mobile-expo/SKILL.md

@@ -34,6 +34,5 @@ Sergeant mobile is not a thin copy of the web app. It uses Expo Router, NativeWi
 
 ## Playbooks
 
-- `docs/playbooks/release-expo-mobile.md` — Expo build and submit.
-- `docs/playbooks/release-mobile-shell.md` — Capacitor mobile-shell release.
+- `docs/playbooks/release.md` — canonical release playbook (Expo and Capacitor shell sections).
 - Catalog: `docs/agents/agent-skills-catalog.md`.

.agents/skills/sergeant-review-and-merge/SKILL.md

@@ -37,7 +37,6 @@ Pay extra attention when the diff touches:
 
 ## Playbooks
 
-- `docs/playbooks/release-web-and-api.md` — coordinated web + server release.
-- `docs/playbooks/release-mobile-shell.md` — mobile-shell coordinated release.
+- `docs/playbooks/release.md` — canonical release playbook (web + API, Capacitor shell, Expo) with decision tree.
 - `docs/playbooks/declare-incident.md` — escalation when a merge regresses prod.
 - Catalog: `docs/agents/agent-skills-catalog.md`.

.agents/skills/sergeant-server-api/SKILL.md

@@ -42,5 +42,5 @@ Server work in Sergeant is contract work. The API is correct only when serialize
 
 - `docs/playbooks/add-api-endpoint.md` — handler + route + api-client + tests in lockstep.
 - `docs/playbooks/add-sql-migration.md` — when the endpoint needs schema changes.
-- `docs/playbooks/release-web-and-api.md` — coordinated server deploy.
+- `docs/playbooks/release.md` — canonical release playbook (web + API section).
 - Catalog: `docs/agents/agent-skills-catalog.md`.

.agents/skills/sergeant-web-ui/SKILL.md

@@ -39,5 +39,5 @@ Sergeant web work is React 18 + Vite PWA + Tailwind with repo-enforced design ru
 
 - `docs/playbooks/add-onboarding-step.md` — when the change touches onboarding.
 - `docs/playbooks/add-feature-flag.md` — when the rollout is gated.
-- `docs/playbooks/release-web-and-api.md` — coordinated web + server release.
+- `docs/playbooks/release.md` — canonical release playbook (web + API section).
 - Catalog: `docs/agents/agent-skills-catalog.md`.

docs/architecture/service-catalog.md

@@ -1,6 +1,6 @@
 # Service Catalog
 
-> **Last validated:** 2026-05-02 by @claude. **Next review:** 2026-07-31.
+> **Last validated:** 2026-05-04 by @Skords-01. **Next review:** 2026-08-02.
 > **Status:** Active
 
 Runtime-oriented inventory for the production surfaces that Sergeant operates today. Use this document to answer four questions fast:
@@ -14,11 +14,11 @@ Runtime-oriented inventory for the production surfaces that Sergeant operates to
 
 | Surface                             | Repo owner                                              | Deploy target                                         | Runtime dependencies                                                       | Critical env vars                                           | Healthcheck / signal                                                   | Alerts / dashboards                                                                                                      | Primary runbook                                                                                                          | Rollback path                                                              | Data sensitivity                                        |
 | ----------------------------------- | ------------------------------------------------------- | ----------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- | ------------------------------------------------------- |
-| Web / PWA (`apps/web`)              | `sergeant-web-ui`                                       | Vercel production deployment                          | `apps/server`, PostHog, Sentry, feature flags, shared packages             | `VITE_API_URL`, Sentry DSN, PostHog key, auth client config | Smoke through home/auth flows, Web Vitals, `/health` dependency on API | [observability/frontend.md](../observability/frontend.md), [observability/dashboards.md](../observability/dashboards.md) | [release-web-and-api.md](../playbooks/release-web-and-api.md)                                                            | Re-promote previous Vercel deployment or disable release via feature flag  | Tier 2: user-facing, auth-adjacent metadata             |
-| API (`apps/server`)                 | `sergeant-server-api`                                   | Railway service                                       | PostgreSQL, Better Auth, Sentry, external APIs, Redis/cache if configured  | `DATABASE_URL`, auth secrets, provider API keys, Sentry DSN | `/health`, auth checks, queue/webhook success rates                    | [observability/runbook.md](../observability/runbook.md), [observability/metrics.md](../observability/metrics.md)         | [release-web-and-api.md](../playbooks/release-web-and-api.md)                                                            | Redeploy previous Railway release, revert env or back out feature flag     | Tier 1: core user and integration data                  |
+| Web / PWA (`apps/web`)              | `sergeant-web-ui`                                       | Vercel production deployment                          | `apps/server`, PostHog, Sentry, feature flags, shared packages             | `VITE_API_URL`, Sentry DSN, PostHog key, auth client config | Smoke through home/auth flows, Web Vitals, `/health` dependency on API | [observability/frontend.md](../observability/frontend.md), [observability/dashboards.md](../observability/dashboards.md) | [release.md § Web + API](../playbooks/release.md#1-web--api)                                                             | Re-promote previous Vercel deployment or disable release via feature flag  | Tier 2: user-facing, auth-adjacent metadata             |
+| API (`apps/server`)                 | `sergeant-server-api`                                   | Railway service                                       | PostgreSQL, Better Auth, Sentry, external APIs, Redis/cache if configured  | `DATABASE_URL`, auth secrets, provider API keys, Sentry DSN | `/health`, auth checks, queue/webhook success rates                    | [observability/runbook.md](../observability/runbook.md), [observability/metrics.md](../observability/metrics.md)         | [release.md § Web + API](../playbooks/release.md#1-web--api)                                                             | Redeploy previous Railway release, revert env or back out feature flag     | Tier 1: core user and integration data                  |
 | PostgreSQL                          | `sergeant-data-and-migrations`                          | Railway Postgres                                      | API, migrations, backup snapshots                                          | `DATABASE_URL`, backup credentials if externalized          | DB connectivity, migration status, restore rehearsal logs              | [observability/runbook.md](../observability/runbook.md)                                                                  | [add-sql-migration.md](../playbooks/add-sql-migration.md), [restore-from-backup.md](../playbooks/restore-from-backup.md) | Roll forward with compensating migration or restore from validated backup  | Tier 1: system of record                                |
-| Mobile shell (`apps/mobile-shell`)  | `sergeant-deploy-and-observability` + `sergeant-web-ui` | iOS TestFlight / App Store, Google Play internal/prod | Web build artifact, Capacitor plugins, store metadata                      | App store signing config, web origin config                 | Install/launch smoke test, auth bootstrap, push/open deep links        | [architecture/platforms.md](./platforms.md)                                                                              | [release-mobile-shell.md](../playbooks/release-mobile-shell.md)                                                          | Promote previous store build or pause rollout in store console             | Tier 2: user-facing shell with cached auth/session data |
-| Expo mobile (`apps/mobile`)         | `sergeant-mobile-expo`                                  | Expo EAS builds / preview channels                    | API, MMKV/local storage, native modules, push notification services        | Expo secrets, API base URL, push credentials                | Launch smoke, auth flow, one primary mobile-only flow                  | [architecture/platforms.md](./platforms.md), [observability/frontend.md](../observability/frontend.md)                   | [release-expo-mobile.md](../playbooks/release-expo-mobile.md)                                                            | Roll back channel update or publish hotfix build                           | Tier 2: user-facing app with local cached state         |
+| Mobile shell (`apps/mobile-shell`)  | `sergeant-deploy-and-observability` + `sergeant-web-ui` | iOS TestFlight / App Store, Google Play internal/prod | Web build artifact, Capacitor plugins, store metadata                      | App store signing config, web origin config                 | Install/launch smoke test, auth bootstrap, push/open deep links        | [architecture/platforms.md](./platforms.md)                                                                              | [release.md § Mobile shell (Capacitor)](../playbooks/release.md#2-mobile-shell-capacitor)                                | Promote previous store build or pause rollout in store console             | Tier 2: user-facing shell with cached auth/session data |
+| Expo mobile (`apps/mobile`)         | `sergeant-mobile-expo`                                  | Expo EAS builds / preview channels                    | API, MMKV/local storage, native modules, push notification services        | Expo secrets, API base URL, push credentials                | Launch smoke, auth flow, one primary mobile-only flow                  | [architecture/platforms.md](./platforms.md), [observability/frontend.md](../observability/frontend.md)                   | [release.md § Expo](../playbooks/release.md#3-expo)                                                                      | Roll back channel update or publish hotfix build                           | Tier 2: user-facing app with local cached state         |
 | Console agents (`apps/console`)     | `sergeant-hubchat`                                      | Railway worker/bot runtime                            | Telegram, OpenAI/Anthropic providers, server APIs, prompt/tool definitions | Bot token, LLM provider keys, API origin                    | Bot responds, tool execution succeeds, logs stay within error budget   | [observability/runbook.md](../observability/runbook.md)                                                                  | [modify-console-agent.md](../playbooks/modify-console-agent.md)                                                          | Disable bot workflow, revert prompt/tool deploy, re-enable previous config | Tier 2: ops and internal data                           |
 | HubChat tools / orchestration       | `sergeant-hubchat`                                      | Web + API combined surface                            | Server tool registry, client action cards, prompt/tool cache               | LLM provider keys, server feature flags, tool config        | Tool invocation succeeds end-to-end; no silent side effects            | [observability/runbook.md](../observability/runbook.md)                                                                  | [add-hubchat-tool.md](../playbooks/add-hubchat-tool.md)                                                                  | Disable tool, revert tool registry, ship server-side hotfix                | Tier 2: user content plus action metadata               |
 | n8n workflows (`ops/n8n-workflows`) | `sergeant-deploy-and-observability`                     | n8n runtime / imported workflow environment           | Webhooks, API endpoints, external SaaS credentials                         | per-workflow provider secrets, webhook tokens               | Workflow runs, retries, dead-letter or manual replay notes             | [modify-n8n-workflow.md](../playbooks/modify-n8n-workflow.md)                                                            | [modify-n8n-workflow.md](../playbooks/modify-n8n-workflow.md)                                                            | Re-import previous manifest or disable trigger                             | Tier 2: integration and automation data                 |

docs/governance/release-policy.md

@@ -1,6 +1,6 @@
 # Release Policy
 
-> **Last validated:** 2026-05-02 by @claude. **Next review:** 2026-07-31.
+> **Last validated:** 2026-05-04 by @Skords-01. **Next review:** 2026-08-02.
 > **Status:** Active
 
 Canonical release policy for Sergeant. This document defines when a normal merge is enough and when a change must be treated as an explicit release event with extra coordination.
@@ -56,7 +56,5 @@ Every coordinated or high-risk release should record:
 
 ## Canonical playbooks
 
-- [release-web-and-api.md](../playbooks/release-web-and-api.md)
-- [release-mobile-shell.md](../playbooks/release-mobile-shell.md)
-- [release-expo-mobile.md](../playbooks/release-expo-mobile.md)
+- [release.md](../playbooks/release.md) — canonical merged playbook (web + API, Capacitor shell, Expo) with decision tree.
 - [hotfix-prod-regression.md](../playbooks/hotfix-prod-regression.md)