From 5a6b2a4c8b0b3bd4b1f4c471c888decda1ed6d46 Mon Sep 17 00:00:00 2001
From: Defame1297 <gitea@rkdr.net>
Date: Sun, 28 Jun 2026 15:21:35 +0000
Subject: [PATCH] fix(agent-author): require plugin version bump after agent
 changes

## Why
Same gap as skill-author: no instruction to bump the plugin version after
creating or modifying an agent inside a plugin.

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 plugins/kyberforge/.claude-plugin/plugin.json    | 2 +-
 plugins/kyberforge/plugin.json                   | 2 +-
 plugins/kyberforge/skills/agent-author/README.md | 2 +-
 plugins/kyberforge/skills/agent-author/SKILL.md  | 5 +++++
 4 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/plugins/kyberforge/.claude-plugin/plugin.json b/plugins/kyberforge/.claude-plugin/plugin.json
index f330d02..b2e79f0 100644
--- a/plugins/kyberforge/.claude-plugin/plugin.json
+++ b/plugins/kyberforge/.claude-plugin/plugin.json
@@ -8,5 +8,5 @@
   "keywords": [],
   "license": "MIT",
   "name": "kyberforge",
-  "version": "1.0.4"
+  "version": "1.0.5"
 }
diff --git a/plugins/kyberforge/plugin.json b/plugins/kyberforge/plugin.json
index f5b6652..8b3fcfe 100644
--- a/plugins/kyberforge/plugin.json
+++ b/plugins/kyberforge/plugin.json
@@ -13,5 +13,5 @@
   "skills": [
     "skills/"
   ],
-  "version": "1.0.4"
+  "version": "1.0.5"
 }
diff --git a/plugins/kyberforge/skills/agent-author/README.md b/plugins/kyberforge/skills/agent-author/README.md
index ce8a313..aa0ae9f 100644
--- a/plugins/kyberforge/skills/agent-author/README.md
+++ b/plugins/kyberforge/skills/agent-author/README.md
@@ -4,7 +4,7 @@ Creates and improves agent definition files for Claude Code and GitHub Copilot C
 
 ## What it does
 
-Scaffolds and fills in agent definition files (`.md` for Claude Code, `.agent.md` for Copilot CLI) at plugin, project, or user scope. Always generates both provider files in one pass. Also applies improvement signals — grill output, inline feedback, session context — to existing agent files.
+Scaffolds and fills in agent definition files (`.md` for Claude Code, `.agent.md` for Copilot CLI) at plugin, project, or user scope. Always generates both provider files in one pass. Also applies improvement signals — grill output, inline feedback, session context — to existing agent files. Bumps the plugin version in both manifests after every change (minor for new agents, patch for improvements).
 
 ## Before you start
 
diff --git a/plugins/kyberforge/skills/agent-author/SKILL.md b/plugins/kyberforge/skills/agent-author/SKILL.md
index 65cfddc..0264d9e 100644
--- a/plugins/kyberforge/skills/agent-author/SKILL.md
+++ b/plugins/kyberforge/skills/agent-author/SKILL.md
@@ -26,6 +26,7 @@ metadata:
 
 ## Gotchas
 
+- If the agent lives inside a plugin (its path contains a `plugin.json`), bump the plugin version after every change — in both `plugin.json` and `.claude-plugin/plugin.json` in the same edit pass. Convention: new agent → minor bump; improvement or fix → patch bump. Plugin consumers compare this version to detect updates; skipping it makes the change invisible.
 - Plugin agents silently ignore `hooks`, `mcpServers`, and `permissionMode` — these fields have no effect and produce no warning. They only work in `.claude/agents/` or `~/.claude/agents/`.
 - `AskUserQuestion`, `EnterPlanMode`, `ExitPlanMode`, and `ScheduleWakeup` are never available to any subagent regardless of the `tools` field.
 - Duplicate `name` values in the same scope: Claude Code silently discards one without warning. Always verify uniqueness before shipping.
@@ -145,6 +146,8 @@ If no research sources are in context, delete `agents/sources.md`.
 - [ ] No Claude Code-only fields (`maxTurns`, `isolation`, `memory`, `permissionMode`, `effort`)
 - [ ] System prompt body present and non-empty
 
+If the destination is inside a plugin directory, apply a **minor bump** to the `version` field in both `plugin.json` and `.claude-plugin/plugin.json` at the plugin root in the same edit pass (e.g. `1.0.4` → `1.1.0`).
+
 ## Improving an existing agent
 
 ### Step 1 — Verify inputs
@@ -179,3 +182,5 @@ Edit any file the signals point to. Generalize the fix — find the underlying g
 ### Step 5 — Validate and close
 
 Re-run the validation checklist from the create flow's Step 5 on any edited file.
+
+If the agent lives inside a plugin directory, apply a **patch bump** to the `version` field in both `plugin.json` and `.claude-plugin/plugin.json` at the plugin root in the same edit pass (e.g. `1.0.4` → `1.0.5`).