repo-release

Codex form of the /repo:release command. Other commands appear as $repo-<verb> skills. Helper scripts and .claude/ paths below are relative to the repository root and exist when the Claude Code surface is installed alongside this one.

$repo-release — Cut a Release

Guide a careful, interactive release of this repository. Every phase requires confirmation before proceeding — do not rush, and never push or tag without an explicit yes. The version-bearing files and the bump tool are discovered at release time, never hardcoded, so this works in any repo.

Usage

$repo-release                  # Interactive release from the default branch

Phase 0 — Load project release policy

Before Phase 1, load the repo's release policy if it has one. This is the single supported way for a project to inject its own procedural steps (gates, extra manifest edits, post-release deploys) at named phase boundaries without forking this command — see Extension points — per-project release policy below for the full seam contract and semantics. Projects migrating off Loom's removed /loom:release skill re-home their policy here.

The policy lives in one file at the repo root: .repo/release-policy.md. Each seam is an H2 section headed ## seam: <name>. Read it, then validate the declared seam names and surface any that don't bind, so a typo'd or orphaned seam fails loudly instead of silently doing nothing:

POLICY_FILE=".repo/release-policy.md"
KNOWN_SEAMS="pre-flight pre-changelog-style pre-apply pre-push post-push pre-github-release post-summary"
AUGMENT_ONLY="post-push post-summary"   # no default action → '(replace)' is meaningless
if [ ! -f "$POLICY_FILE" ]; then
  echo "(no $POLICY_FILE — running with the built-in phases only, no behavior change)"
else
  echo "Project release policy: $POLICY_FILE"
  # Enumerate declared seams from '## seam: <name>' headers (dropping an optional
  # '(replace)' suffix) and check each against the known set.
  grep -E '^##[[:space:]]+seam:[[:space:]]*' "$POLICY_FILE" | while IFS= read -r header; do
    name="$(printf '%s' "$header" | sed -E 's/^##[[:space:]]+seam:[[:space:]]*//; s/[[:space:]]*\(replace\)[[:space:]]*$//; s/[[:space:]]+$//')"
    mode="augment"
    printf '%s' "$header" | grep -Eq '\(replace\)[[:space:]]*$' && mode="replace"
    case " $KNOWN_SEAMS " in
      *" $name "*)
        case " $AUGMENT_ONLY " in
          *" $name "*)
            if [ "$mode" = replace ]; then
              echo "  WARNING: seam '$name' is augment-only — '(replace)' is meaningless here and will be ignored"
            else
              echo "  bound: $name (augment)"
            fi ;;
          *) echo "  bound: $name ($mode)" ;;
        esac ;;
      *)
        echo "  WARNING: unknown seam '$name' — it matches no phase boundary and will NOT run. Fix the name (see the seam table) or remove the section." ;;
    esac
  done
fi