From sd0x-dev-flow
Generates and updates feature release runbooks from existing docs and codebase. Use for operational runbooks, release handbooks, deployment checklists, pre-release preparation.
npx claudepluginhub sd0xdev/sd0x-dev-flow --plugin sd0x-dev-flowThis skill is limited to using the following tools:
- Keywords: runbook, release runbook, deployment handbook, release handbook, operational guide, pre-release checklist, rollback plan
Creates runbooks and configurations for technical documentation including API docs, user guides, architecture docs, and automation. Provides step-by-step guidance, best practices, and production-ready outputs.
Coordinates subagents to write production-ready Runbooks covering deployment, rollback, monitoring, and fault handling from upstream docs like PRD/HLD/LLD. Use post-LLD.
Provides checklist workflow for production release prep: validation, versioning, changelog/docs updates, builds, deployment checklists, and rollback plans.
Share bugs, ideas, or general feedback.
| Scenario | Alternative |
|---|---|
| Incident response runbook | v2 (not yet implemented) |
| Code review | /codex-review-fast |
| Architecture design | /architecture |
| Tech spec writing | /tech-spec |
| Request tracking | /create-request |
/runbook # Auto-detect feature, create or update
/runbook <feature-keyword> # Specify feature
/runbook --update # Force update mode
/runbook --check # Read-only staleness validation
/runbook --request <path|title> # Specify target request (multi-request features)
sequenceDiagram
participant U as User
participant S as /runbook
participant FR as Feature Resolver
participant CB as Codebase
participant RB as runbook-release.md
U->>S: /runbook [feature] [--update|--check] [--request path]
S->>FR: node scripts/resolve-feature-cli.js
FR-->>S: {key, doc_inventory, canonical_docs}
S->>S: Mode dispatch + Request selection
alt Create Mode
S->>CB: Read canonical docs + active requests
S->>CB: Scoped discovery (4-priority cascade)
S->>RB: Write runbook-release.md from template
else Update Mode
S->>RB: Read existing runbook + provenance
S->>CB: Compare current state vs provenance SHAs
S->>RB: Edit changed sections only
else Check Mode
S->>RB: Read existing runbook + provenance
S->>CB: Validate per-section SHAs
S-->>U: Report: Fresh/Stale/Missing/Unknown
end
Resolve feature using the 5-level cascade:
# If positional feature arg provided, pass as --feature
if [ -n "$FEATURE_ARG" ]; then
FEATURE_JSON=$(node scripts/resolve-feature-cli.js --feature "$FEATURE_ARG" 2>/dev/null || echo '{}')
else
FEATURE_JSON=$(node scripts/resolve-feature-cli.js 2>/dev/null || echo '{}')
fi
| Source | Mapping |
|---|---|
/runbook auth | FEATURE_ARG=auth → --feature auth (two separate argv tokens) |
/runbook (no arg) | No --feature, resolver uses branch/diff/fallback |
/runbook --check | No --feature, parse flags only |
| Step | Action |
|---|---|
| 1 | Parse $ARGUMENTS for feature key or --check/--update/--request flags |
| 2 | Run feature resolver, get key, doc_inventory, canonical_docs |
| 3 | Check for runbook-release.md specifically in feature directory (not any runbook-*.md) |
| 4 | Determine mode: create (runbook-release.md absent) / update (runbook-release.md exists) / check (--check flag) |
Note: Mode dispatch keys off the specific file
runbook-release.md, not any runbook-typed doc indoc_inventory. A feature may haverunbook-deploy.md(a different topic) without triggering update mode for the release runbook.
| Condition | Behavior |
|---|---|
--request specified | Use specified request |
| Single active request | Auto-select |
| Multiple active requests | AskUserQuestion: list requests, let user choose |
| No active requests | Use most recent request (warn) |
Use scoped discovery cascade — narrow to wide, with confidence degradation:
| Priority | Scope | Confidence |
|---|---|---|
| 1 | Request Related Files paths | High |
| 2 | Canonical docs (tech-spec, architecture) | High |
| 3 | Feature-local paths (docs/features/{feature}/) | Medium |
| 4 | Repo-wide grep | Low (tag results) |
See references/discovery-heuristics.md for per-section mapping.
When mining configs/workflows/logs into committed markdown:
| Prohibited | Replacement |
|---|---|
| API keys, tokens, secrets | ${ENV_VAR_NAME} placeholder |
| Webhook URLs with credentials | <webhook-url> symbolic reference |
| Internal-only endpoints | <internal-endpoint> placeholder |
| Database connection strings | ${DATABASE_URL} placeholder |
canonical_docs map (tech_spec, architecture, requirements)references/template.md<!-- runbook-provenance --> manifest with source SHAsdocs/features/{feature}/runbook-release.mdrunbook-release.md and parse <!-- runbook-provenance --> blocksources[].sha against git hash-object <file>--check)Read-only validation — does not modify the runbook file.
runbook-release.md and parse provenance manifestsources[].sha against current git hash-objectreferences/check-output.md)| Mode | Output | Location |
|---|---|---|
| Create | New runbook | docs/features/{feature}/runbook-release.md |
| Update | Updated sections | Same file, incremental edit |
| Check | Console report | stdout only (no file modification) |
resolve-feature-cli.jsdoc_inventory (ancillary/runbook type)references/template.md)--check mode is read-only (no file writes)This skill produces .md output. Per @rules/auto-loop.md:
| Event | Action |
|---|---|
Create/Update writes .md | /codex-review-doc auto-triggered |
| Check mode (no writes) | No review needed |
| File | Purpose |
|---|---|
references/template.md | 9-section runbook template with provenance block |
references/discovery-heuristics.md | Scoped discovery cascade and per-section mapping |
references/check-output.md | --check mode output template and verdict logic |
Input: /runbook
Action: Auto-detect feature → create runbook-release.md → /codex-review-doc
Input: /runbook auth --check
Action: Read auth/runbook-release.md → validate provenance SHAs → output report
Input: /runbook --update --request docs/features/auth/requests/2026-04-01-login-fix.md
Action: Read existing runbook → diff stale sections → update → /codex-review-doc