entwurf: Skill for Claude Code

entwurf-release

Repository: ~/repos/gh/entwurf.

This skill is the shared release-operation SSOT that replaces the former .pi/prompts/prepare-release.md and .pi/prompts/make-release.md files. Claude Code discovers it natively under .claude/skills/; pi discovers the same file through .pi/settings.json and its "skills": ["../.claude/skills"] entry.

Invocation

# Claude Code - stable example
/entwurf-release land 0.12.8
/entwurf-release prepare 0.12.8
/entwurf-release make 0.12.8
/entwurf-release publish 0.12.8 /absolute/path/to/candidate.tgz latest

# pi - prerelease/repair example
/skill:entwurf-release land 0.12.8-repair.1
/skill:entwurf-release prepare 0.12.8-repair.1
/skill:entwurf-release make 0.12.8-repair.1
/skill:entwurf-release publish 0.12.8-repair.1 /absolute/path/to/candidate.tgz repair

Natural-language requests map to the same four modes.

• land pushes an already reviewed pre-version HEAD and waits for the required exact-SHA CI jobs. It never edits, versions, tags, or publishes.
• prepare edits release records, runs deterministic and LIVE gates, and creates the release-prep commit. It never pushes, tags, or publishes.
• make pushes the prepared HEAD, waits for exact-SHA CI, creates and accepts one preserved candidate, then tags, stamps, and creates the GitHub release. It never runs npm publish.
• publish publishes only the already accepted preserved candidate under an explicitly supplied dist-tag and proves the registry-installed result.

The invocation authorizes only the named mode. prepare is not land authorization. make is not publish authorization. If the mode, version, or a mode-specific required argument is missing, ask for it and stop.

Shared version contract

Accept a normal SemVer release or prerelease. Reject a leading v.

VERSION="<user argument>"
case "$VERSION" in
  "") echo "ABORT: version required (for example 0.12.8 or 0.12.8-repair.0)"; exit 1 ;;
  v*) echo "ABORT: drop the leading 'v'"; exit 1 ;;
esac
if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-9A-Za-z-]+)*)?$ ]]; then
  echo "ABORT: version must be SemVer, optionally with a prerelease suffix"
  exit 1
fi