codex-docs-change-sync

name	codex-docs-change-sync
description	Use when code changes may require documentation updates; maps git diff to candidate docs without auto-editing documentation.
load_priority	lazy

TL;DR

Map code changes to affected documentation via map_changes_to_docs.py. Report-only by default, no auto-edit. Scope: auto-detect staged -> unstaged -> last commit. Fallback: manual diff inspection.

Codex Docs Change Sync

Purpose

Identify documentation that is likely affected by code changes.

Activation

1. Activate during workflow docs steps.
2. Activate on explicit $codex-docs-change-sync.

Script Invocation

• Use map_changes_to_docs.py for report-only docs impact mapping.
• See skills/.system/REGISTRY.md for full script paths.

Script Invocation Discipline

1. Always run --help before invoking map_changes_to_docs.py.
2. Treat the script as a black-box mapper and prefer direct execution over source inspection.
3. Read script source only when customization or bug fixing is required.

Enhanced Diff Scope

If scope is not specified, use auto mode:

1. staged changes
2. unstaged changes
3. last commit

Report which scope was selected.

Behavior

1. Run script and parse JSON output.
2. Report changed files and candidate docs with reason/confidence.
3. Keep MVP in report-only mode; do not auto-edit docs unless user requests it.

Fallback

If script cannot run, inspect diffs manually and report likely docs using the conventions in references/mapping-rules.md (path→doc mapping, reference-search patterns, always-include rules): start from docs/, README.md, CHANGELOG.md, and module-specific docs.

Reference Files

• references/docs-sync-spec.md: script behavior, output format, and fallback protocol.
• references/mapping-rules.md: default code→docs mapping conventions, reference-search patterns, always-include rules, and confidence levels (the human-readable spec behind the script and the manual fallback).