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: docs/, README.md, CHANGELOG.md, and module-specific docs.

Reference Files

• references/docs-sync-spec.md: script behavior, output format, and fallback protocol.