Release Guide — Ops Update Guide Generator

When to use

• Preparing to release a new version
• Need to document what changed between refs
• Creating operational update guide
• Communicating version updates to Ops team

Skip when

• No git repository available
• Single file change (too small for formal guide)
• Customer-facing release notes only (use simpler template)

Inputs

• BASE_REF (string, required): e.g. main, v1.0.0
• TARGET_REF (string, required): e.g. HEAD, v1.1.0
• VERSION (string, optional): auto-detected from tags if not provided
• LANGUAGE (enum, optional, default en): en, pt-br, both
• MODE (enum, optional, default STRICT_NO_TOUCH): STRICT_NO_TOUCH, TEMP_CLONE_FOR_FRESH_REFS