docs: clarify plugin version bump conventions with semver guidelines

Add semver level guidance (patch/minor/major) and once-per-branch
rule to avoid redundant bumps while ensuring the bump level matches
the scope of accumulated changes.

Assisted-by: Claude:claude-opus-4-6

Author: cblecker

CLAUDE.md

@@ -44,7 +44,15 @@ structure.
 
 - Use kebab-case for all names
 - Use `${CLAUDE_PLUGIN_ROOT}` for portable paths in hooks/MCP configs
-- When editing plugin files (other than README.md or CLAUDE.md), bump the version in that plugin's `.claude-plugin/plugin.json`
+- When editing plugin files (other than README.md or CLAUDE.md), bump the version in
+  that plugin's `.claude-plugin/plugin.json` following semver:
+  - **patch**: bug fixes, typo corrections, minor wording changes
+  - **minor**: new skills, commands, hooks, agents, or backward-compatible behavior changes
+  - **major**: breaking changes (renamed/removed skills, changed hook behavior, restructured plugin)
+- Only bump once per PR branch. Before bumping, check `git diff main -- <plugin>/.claude-plugin/plugin.json`
+  to see if the version was already bumped. Skip if it was, unless the accumulated
+  changes now warrant a higher semver level (e.g., patch already bumped but a new
+  skill was added — upgrade to minor)
 - Use plugin-dev skills: `/plugin-dev:create-plugin`, `/plugin-dev:skill-reviewer`, `/plugin-dev:plugin-validator`
 
 ## Documentation

pr-review-toolkit/skills/review-pr/SKILL.md

@@ -170,23 +170,23 @@ only when line is present.
 
 1. `{file}[:{line}]` -- **{title}**
    {description}
-   _Verified: {verificationRationale}_
+   {if verificationStatus = "verified"}_Verified: {verificationRationale}_{end if}
 
 ### Important Issues
 
 {for each finding where status = "new" and effective severity = important}
 
 2. `{file}[:{line}]` -- **{title}**
    {description}
-   _Verified: {verificationRationale}_
+   {if verificationStatus = "verified"}_Verified: {verificationRationale}_{end if}
 
 ### Suggestions
 
 {for each finding where status = "new" and effective severity = suggestion}
 
 3. `{file}[:{line}]` -- **{title}**
    {description}
-   _Verified: {verificationRationale}_
+   {if verificationStatus = "verified"}_Verified: {verificationRationale}_{end if}
 
 ### Partial Overlaps
 
@@ -195,7 +195,7 @@ only when line is present.
 4. `{file}[:{line}]` -- **{title}**
    Extends existing review comment: {existingCoverage}.
    New insight: {delta}.
-   _Verified: {verificationRationale}_
+   {if verificationStatus = "verified"}_Verified: {verificationRationale}_{end if}
 
 ### Strengths
 
@@ -224,7 +224,8 @@ Key formatting rules:
 - **No `[severity/confidence]` tags** — severity is conveyed by section
   header; confidence is implicit (low-confidence findings were filtered
   during analysis; false positives were removed by verification)
-- **Verification line in italics** per finding — shows what was checked
+- **Verification line in italics** only for verified findings — omit
+  entirely when `verificationStatus` is `unverified`
 - **Only actionable findings are numbered** — Strengths and Previous
   Review Status are informational only
 - **Duplicates omitted** — if any, add a one-line note: "N findings