Implementation Strategy

Overview

Use this skill before editing code when the task changes runtime behavior or anything that might look like a compatibility concern. The goal is to keep implementations simple while protecting real released contracts and genuinely supported external state.

Quick start

1. Identify the surface you are changing: released public API, unreleased branch-local API, internal helper, persisted schema, wire protocol, CLI/config/env surface, or docs/examples only.
2. Determine the latest release boundary from origin first, and only fall back to local tags when remote tags are unavailable:

   LATEST_RELEASE_TAG="$(
     git ls-remote --tags --refs origin 'v*' 2>/dev/null |
       awk -F/ '{print $3}' |
       sort -V -r |
       head -n1
   )"
   if [ -z "$LATEST_RELEASE_TAG" ]; then
     LATEST_RELEASE_TAG="$(git tag -l 'v*' --sort=-v:refname | head -n1)"