skill-doc-sync

1> **Host: Codex CLI** — This skill was designed for Claude Code and adapted for Codex.
2> Cross-reference commands use installed skill names in Codex rather than `/octo:*` slash commands.
3> Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it.
4> For host tool equivalents, see `skills/blocks/codex-host-adapter.md`.
5 
6 
7# Post-Ship Documentation Synchronization
8 
9Automated documentation synchronization for the Deliver phase. After code is committed and a PR is created, this skill reads all `.md` files in the project, cross-references the diff, auto-updates factual content, checks cross-doc consistency, and updates the PR body.
10 
11 
12## Caps
13 
14- **Max 30 doc files scanned** — skip files beyond the cap, warn the user
15- **Never clobber CHANGELOG** — append only, never delete existing entries
16- **Ask user before changing narrative/philosophy sections** — risky changes require confirmation
17 
18 
19## Step 1: Discover Docs
20 
21Find all `.md` files in the project root (max depth 2), skipping `node_modules/` and `.git/`.
22 
23```bash
24# Discover all markdown files (max depth 2, skip noise directories)
25DOC_FILES=$(find . -maxdepth 2 -name '*.md' \
26  -not -path './node_modules/*' \
27  -not -path './.git/*' \
28  -not -path './vendor/*' \
29  -not -path './.claude/*' \
30  2>/dev/null | head -30)
31 
32DOC_COUNT=$(echo "$DOC_FILES" | wc -l | tr -d ' ')
33echo "Found $DOC_COUNT doc files to scan (cap: 30)"
34…