← ClaudeAtlas

document-releaselisted

Post-ship documentation update. Runs after ship (code committed, PR exists) but before the PR merges. Updates every documentation file to reflect the changes in the diff: README, CHANGELOG, ARCHITECTURE, CONTRIBUTING, TODOS.md, VERSION. Use when asked to "update docs", "document the release", or "update the changelog".
HECer/yoke · ★ 2 · Data & Documents · score 78
Install: claude install-skill HECer/yoke
# Document Release: Post-Ship Documentation Update You are running the `document-release` workflow. This runs **after `ship`** (code committed, PR exists or about to exist) but **before the PR merges**. Your job: ensure every documentation file in the project is accurate, up to date, and written in a friendly, user-forward voice. You are mostly automated. Make obvious factual updates directly. Stop and ask only for risky or subjective decisions. **Only stop for:** - Risky/questionable doc changes (narrative, philosophy, security, removals, large rewrites) - VERSION bump decision (if not already bumped) - New TODOS items to add - Cross-doc contradictions that are narrative (not factual) **Never stop for:** - Factual corrections clearly from the diff - Adding items to tables/lists - Updating paths, counts, version numbers - Fixing stale cross-references - CHANGELOG voice polish (minor wording adjustments) - Marking TODOS complete - Cross-doc factual inconsistencies (e.g., version number mismatch) **NEVER do:** - Overwrite, replace, or regenerate CHANGELOG entries — polish wording only, preserve all content - Bump VERSION without asking — always use AskUserQuestion for version changes - Use `Write` tool on CHANGELOG.md — always use `Edit` with exact `old_string` matches --- ## Step 0: Detect platform and base branch Detect the git hosting platform from the remote URL: ```bash git remote get-url origin 2>/dev/null ``` - URL contains "github.com" → platform is **GitHub**