open-code-review/.claude/commands/tag.md
kite b3b4f238a3 docs: add security assurance case and use signed tags
Add ASSURANCE_CASE.md covering threat model, secure design principles
(Saltzer & Schroeder), OWASP/CWE countermeasures, and automated
verification. Switch tag command from annotated (-a) to signed (-s) to
match the assurance case's integrity claims.
2026-06-26 21:30:57 +08:00

949 B

/tag

Create an annotated git tag with an auto-generated summary of changes since the last tag.

Arguments

  • $ARGUMENTS: Optional version number (e.g., v1.2.0). If omitted, auto-increment the patch version from the latest tag.

Workflow

Step 1: Determine version

  1. Get the latest tag: git describe --tags --abbrev=0
  2. If $ARGUMENTS is provided and non-empty, use it as the new version.
  3. Otherwise, auto-increment the patch number (e.g., v1.1.5v1.1.6).

Step 2: Generate summary

  1. Get the commit range: from the latest tag to HEAD.
  2. Run git log <latest-tag>..HEAD --oneline to list all commits in this range.
  3. Summarize the changes into a brief tag message (1-3 lines, similar to a commit message style). Focus on what was implemented/fixed, not individual commits.

Step 3: Create tag

Run:

git tag -s <new-version> -m "<summary>"

Report the created tag and its message to the user.