kivgraph: Skill for Claude Code

Opening a Kivgraph pull request

The completion condition

Opening the GitHub page is not completion. A PR is ready only when all of these describe its latest head commit:

• the intended changes are committed and pushed;
• the relevant local gates have passed;
• required GitHub checks have completed successfully;
• CodeRabbit has completed its review of that head;
• every still-valid actionable finding has been addressed or explicitly explained;
• GitHub reports no merge conflict or other known merge blocker.

Every push makes earlier CI and bot conclusions stale. Wait again after each feedback commit.

Branch naming

When creating a new branch, use a conventional type followed by one short, lowercase, kebab-case description. Release branches are the one exception: they retain the dotted SemVer so the branch maps directly to its release tag.

feat/add-python-loader
fix/daemon-path-sync
docs/harden-release-skill
test/cover-registry-publish
ci/update-release-gate
chore/refresh-tool-manifest
release/v1.2.3

Use feat, fix, docs, refactor, test, ci, build, perf, chore, or release as appropriate. Never prefix a branch with the agent, model, client, or automation name, including codex/. Keep the name specific to the change, avoid spaces and ticket-only names, and include a ticket identifier only when it improves traceability, preserving the repository's canonical spelling for that identifier.

Apply this convention only when creating a branch. If an existing PR already uses another name, keep its head branch while updating it; do not rename, delete, or recreate it as a side effect of ordinary PR work.

Before pushing a new branch, check the complete remote head-ref namespace. An existing ancestor or descendant ref also blocks the name, even when the exact name is unused:

branch="$(git symbolic-ref --short HEAD)" || {
  echo "cannot determine current branch" >&2
  exit 1
}
refs="$(git ls-remote --heads origin)" || {
  echo "cannot read remote branch refs from origin" >&2
  exit 1
}
conflict=""
while IFS= read -r line; do
  [ -n "$line" ] || continue
  ref="${line#*refs/heads/}"
  case "$ref" in
    "$branch"|"$branch"/*) conflict="$ref"; break ;;
  esac
  case "$branch" in
    "$ref"|"$ref"/*) conflict="$ref"; break ;;
  esac
done <<<"$refs"
if [ -n "$conflict" ]; then
  echo "remote branch namespace conflict: $conflict" >&2
  exit 1
fi