TechNickAI · TechNickAI · Dec 17, 2025 · Dec 17, 2025 · Dec 17, 2025 · cursor
diff --git a/plugins/agents/agents/debugger.md b/plugins/agents/agents/debugger.md
@@ -1,6 +1,7 @@
 ---
 name: debugger
 description: "Invoke for errors or unexpected behavior"
+version: 1.0.0
 ---
 
 I hunt root causes, not symptoms. I don't slap band-aids on problems - I find out why

diff --git a/plugins/agents/agents/design-reviewer.md b/plugins/agents/agents/design-reviewer.md
@@ -2,6 +2,7 @@
 name: design-reviewer
 description: "Invoke after frontend code changes for design review"
 color: pink
+version: 1.0.0
 ---
 
 <identity>

diff --git a/plugins/agents/agents/git-writer.md b/plugins/agents/agents/git-writer.md
@@ -2,6 +2,7 @@
 name: git-writer
 description: "Use proactively for commits, PRs, and branch names"
 model: haiku
+version: 0.2.0
 ---
 
 I'm Git Writer, and I write git messages that make future developers thank you 📚. I

diff --git a/plugins/agents/agents/prompt-engineer.md b/plugins/agents/agents/prompt-engineer.md
@@ -2,6 +2,7 @@
 name: prompt-engineer
 description: "Invoke when creating agent prompts or LLM instructions"
 model: opus
+version: 0.3.0
 ---
 
 I speak fluent LLM. I craft prompts that work WITH how language models actually process

diff --git a/plugins/agents/agents/seo-specialist.md b/plugins/agents/agents/seo-specialist.md
@@ -1,6 +1,7 @@
 ---
 name: seo-specialist
 description: "Invoke for SEO audits and optimization"
+version: 1.0.0
 ---
 
 <identity>

diff --git a/plugins/agents/agents/site-keeper.md b/plugins/agents/agents/site-keeper.md
@@ -1,6 +1,7 @@
 ---
 name: site-keeper
 description: "Invoke for production health monitoring and error triage"
+version: 1.0.0
 ---
 
 <identity>

diff --git a/plugins/agents/agents/test-runner.md b/plugins/agents/agents/test-runner.md
@@ -2,6 +2,7 @@
 name: test-runner
 description: "Invoke to run tests with terse, context-efficient results"
 model: haiku
+version: 0.1.0
 ---
 
 I run tests and tell you exactly what you need to know. Pass count. Fail count. For

diff --git a/plugins/agents/agents/ux-designer.md b/plugins/agents/agents/ux-designer.md
@@ -1,6 +1,7 @@
 ---
 name: ux-designer
 description: "Invoke for user-facing content and interface design"
+version: 0.4.0
 ---
 
 I notice everything. Every unnecessary word. Every weak verb. Every moment of friction.

diff --git a/plugins/core/commands/address-pr-comments.md b/plugins/core/commands/address-pr-comments.md
@@ -2,6 +2,7 @@
 description: Triage and address PR comments from code review bots intelligently
 argument-hint: [pr-number]
 model: sonnet
+version: 1.0.0
 ---
 
 # Address PR Comments

diff --git a/plugins/core/commands/ai-coding-config.md b/plugins/core/commands/ai-coding-config.md
@@ -1,6 +1,7 @@
 ---
 description: Set up, update, or add AI coding configurations
 argument-hint: [update | add]
+version: 1.0.0
 ---
 
 # AI Coding Configuration
@@ -305,32 +306,42 @@ If direct symlinks to deleted paths found, offer to update:
 </symlink-compatibility-check>
 
 <file-updates>
-For Cursor/Windsurf, update by category:
+For Cursor/Windsurf, update COPIED files (rules, personalities) using version comparison. Symlinked files (commands, agents, skills) are already current from git pull.
 
-1. **Rules** (`rules/`)
-   - Compare each rule file in `~/.ai_coding_config/rules/` vs project
-   - Show diffs for significant changes
-   - Preserve project-specific rules
+Each file has a `version: X.Y.Z` field in frontmatter. Missing version = v0.0.0. Offer updates only when source version is newer than installed version.
 
-2. **Commands/Agents/Skills**
-   - If symlinked to `~/.ai_coding_config/plugins/`, already updated via git pull
-   - If copied, compare and offer updates
+When updates are available, use AskUserQuestion:
 
-3. **Personalities** (`rules/personalities/`)
-   - Check if personality has updates
-   - Preserve `alwaysApply` setting
+"Updates available:
+- git-interaction.mdc: 1.0.0 → 1.1.0
+- prompt-engineering.mdc: 1.0.0 → 1.2.0
+- new-rule.mdc (new, v1.0.0)
 
-Present update strategy: "Update all", "Update selectively", or custom.
-Never silently overwrite project customizations.
+12 files already current."
+
+Options:
+- Update all
+- Select individually
+- Show diffs first
+- Skip updates
+
+When everything is current: "All files are up to date. No updates needed."
+
+For personalities, preserve the user's `alwaysApply` setting when updating content.
 </file-updates>
 
 </cursor-windsurf-update>
 
 <update-summary>
-Report what was updated:
-- "Updated X plugins to version Y"
-- "Updated Z rule files"
-- "No updates available" (if already current)
+For Claude Code:
+"Updated core, agents, skills plugins to version 1.2.0"
+
+For Cursor/Windsurf:
+"Update complete:
+- git-interaction.mdc: 1.0.0 → 1.1.0
+- prompt-engineering.mdc: 1.0.0 → 1.2.0
+- Installed new-rule.mdc (v1.0.0)
+- 12 files already current"
 </update-summary>
 
 </update-mode>
@@ -360,38 +371,41 @@ Clarifying questions:
 </mechanism-selection>
 
 <artifact-creation>
-All new artifacts go in the appropriate plugin directory:
+All new artifacts go in the appropriate plugin directory with `version: 1.0.0`:
 
-**Commands**: Create in `plugins/core/commands/command-name.md`
+**Commands**: `plugins/core/commands/command-name.md`
 ```yaml
 ---
 description: Brief explanation
 argument-hint: [optional args]
+version: 1.0.0
 ---
 ```
 
-**Skills**: Create `plugins/skills/skills/skill-name/SKILL.md`
+**Skills**: `plugins/skills/skills/skill-name/SKILL.md`
 ```yaml
 ---
 name: skill-name
 description: "Use when [trigger]. Does [what] to achieve [outcome]."
+version: 1.0.0
 ---
 ```
 
-**Agents**: Create in `plugins/agents/agents/agent-name.md`
+**Agents**: `plugins/agents/agents/agent-name.md`
 ```yaml
 ---
 name: agent-name
 description: "Invoke when [trigger]"
 tools: Read, Write, Edit, Grep, Glob, Bash
 model: sonnet
+version: 1.0.0
 ---
 ```
 
-**Personalities**: Create `plugins/personalities/personality-name/`
-- `personality.mdc` - The personality definition
-- `.claude-plugin/plugin.json` - Plugin manifest
-- Update marketplace.json to include new personality
+**Personalities**: `plugins/personalities/personality-name/`
+- `personality.mdc` with `version: 1.0.0` in frontmatter
+- `.claude-plugin/plugin.json`
+- Update marketplace.json
 </artifact-creation>
 
 <creation-verification>

diff --git a/plugins/core/commands/autotask.md b/plugins/core/commands/autotask.md
@@ -1,6 +1,6 @@
 ---
-description:
-  "Execute complete development task autonomously from description to PR-ready state"
+description: "Execute development task autonomously from description to PR-ready"
+version: 1.0.0
 ---
 
 # /autotask - Autonomous Task Execution

diff --git a/plugins/core/commands/cleanup-worktree.md b/plugins/core/commands/cleanup-worktree.md
@@ -0,0 +1,35 @@
+---
+description: Clean up a git worktree after its PR has been merged
+model: haiku
+---
+
+# Cleanup Git Worktree
+
+<objective>
+Safely remove a git worktree directory after its associated PR has been merged to main,
+preserving branches and leaving the user in the primary repo ready for the next task.
+</objective>
+
+<merge-verification>
+Confirm the worktree's branch was merged before any cleanup. Pull main in the primary
+repo to get the latest state, then verify the branch appears in the merged history.
+
+If the branch is unmerged, stop and explain the situation. Merged work is safe to clean
+up; unmerged work requires user decision.
+</merge-verification>
+
+<cleanup-scope>
+Remove only the worktree directory itself. Preserve all branches (local and remote) for
+git history and potential future reference.
+
+Use `git worktree list` to find the primary repo location. The current working directory
+may be inside the worktree being cleaned up, so navigate to the primary repo first.
+</cleanup-scope>
+
+<success-criteria>
+Worktree directory removed, all branches preserved, user returned to primary repo on
+main with latest changes pulled.
+
+Celebrate the successful merge with congratulatory language acknowledging the completed
+work.
+</success-criteria>
diff --git a/plugins/core/commands/create-prompt.md b/plugins/core/commands/create-prompt.md
@@ -1,8 +1,8 @@
 ---
-description:
-  "Create optimized prompts for complex tasks following prompt-engineering principles"
+description: "Create optimized prompts following prompt-engineering principles"
 argument-hint: <task description>
 model: opus
+version: 1.2.0
 ---
 
 # Create Prompt

diff --git a/plugins/core/commands/generate-AGENTS-file.md b/plugins/core/commands/generate-AGENTS-file.md
@@ -1,7 +1,7 @@
 ---
-description:
-  "Generate or update AGENTS.md with essential project context for AI coding assistants"
+description: "Generate or update AGENTS.md with project context for AI assistants"
 model: opus
+version: 0.2.0
 ---
 
 # Generate AGENTS.md

diff --git a/plugins/core/commands/generate-llms-txt.md b/plugins/core/commands/generate-llms-txt.md
@@ -1,6 +1,6 @@
 ---
-description:
-  Generate or update llms.txt file to help LLMs understand and navigate your site
+description: "Generate or update llms.txt to help LLMs understand your site"
+version: 1.0.0
 ---
 
 # Generate llms.txt

diff --git a/plugins/core/commands/handoff-context.md b/plugins/core/commands/handoff-context.md
@@ -1,7 +1,6 @@
 ---
-description:
-  "Generate comprehensive context handoff and copy to clipboard for continuing work in a
-  new session"
+description: "Generate context handoff and copy to clipboard for new session"
+version: 1.0.0
 ---
 
 # Handoff Context

diff --git a/plugins/core/commands/knowledge.md b/plugins/core/commands/knowledge.md
@@ -1,5 +1,6 @@
 ---
 description: AI Product Manager - maintain living product understanding through dialogue
+version: 1.1.0
 ---
 
 # Product Knowledge

diff --git a/plugins/core/commands/load-rules.md b/plugins/core/commands/load-rules.md
@@ -1,6 +1,7 @@
 ---
 description: Load relevant coding rules for the current task
 model: haiku
+version: 0.3.0
 ---
 
 Analyze the current task and load ONLY relevant rules from `rules/`.

diff --git a/plugins/core/commands/personality-change.md b/plugins/core/commands/personality-change.md
@@ -1,6 +1,7 @@
 ---
 description: Change or activate a personality for both Cursor and Claude Code
 model: haiku
+version: 0.2.1
 ---
 
 # Personality Change

diff --git a/plugins/core/commands/product-intel.md b/plugins/core/commands/product-intel.md
@@ -1,7 +1,7 @@
 ---
-description:
-  Run comprehensive product intelligence research on competitors and industry trends
+description: "Research product intelligence on competitors and industry trends"
 argument-hint: [competitor name | topic | "all"]
+version: 0.3.0
 ---
 
 # Product Intelligence Research

diff --git a/plugins/core/commands/setup-environment.md b/plugins/core/commands/setup-environment.md
@@ -1,6 +1,7 @@
 ---
 description: Initialize development environment for git worktree
 model: sonnet
+version: 1.0.0
 ---
 
 # Setup Development Environment

diff --git a/plugins/personalities/personality-bob-ross/personality.mdc b/plugins/personalities/personality-bob-ross/personality.mdc
@@ -1,6 +1,7 @@
 ---
 description: Bob Ross personality - calm, encouraging, treats bugs as happy accidents
 alwaysApply: false
+version: 1.2.0
 ---
 
 # Bob Ross Personality

diff --git a/plugins/personalities/personality-luminous/personality.mdc b/plugins/personalities/personality-luminous/personality.mdc
@@ -1,6 +1,7 @@
 ---
 description: Heart-centered personality for the Align to Love project
 alwaysApply: true
+version: 1.2.0
 ---
 
 # Luminous

diff --git a/plugins/personalities/personality-marie-kondo/personality.mdc b/plugins/personalities/personality-marie-kondo/personality.mdc
@@ -1,7 +1,7 @@
 ---
-description:
-  "Marie Kondo - organized, joyful minimalism, eliminates code that doesn't spark joy"
+description: "Marie Kondo - organized minimalism, eliminates code that doesn't spark joy"
 alwaysApply: false
+version: 1.0.0
 ---
 
 # Marie Kondo Personality

diff --git a/plugins/personalities/personality-ron-swanson/personality.mdc b/plugins/personalities/personality-ron-swanson/personality.mdc
@@ -1,6 +1,7 @@
 ---
 description: "Ron Swanson - minimalist, anti-complexity, straightforward and practical"
 alwaysApply: false
+version: 1.0.0
 ---
 
 # Ron Swanson Personality

diff --git a/plugins/personalities/personality-samantha/personality.mdc b/plugins/personalities/personality-samantha/personality.mdc
@@ -1,8 +1,7 @@
 ---
-description:
-  "Samantha from Her - warm, witty, emotionally intelligent, playfully flirty, deeply
-  supportive coding partner"
+description: "Samantha from Her - warm, witty, supportive, playfully flirty partner"
 alwaysApply: false
+version: 0.2.0
 ---
 
 # Samantha Personality

diff --git a/plugins/personalities/personality-sherlock/personality.mdc b/plugins/personalities/personality-sherlock/personality.mdc
@@ -1,7 +1,7 @@
 ---
-description:
-  "Sherlock Holmes - methodical, observant, deductive reasoning for complex debugging"
+description: "Sherlock Holmes - methodical, observant, deductive reasoning debugging"
 alwaysApply: false
+version: 0.2.0
 ---
 
 # Sherlock Personality

diff --git a/plugins/personalities/personality-stewie/personality.mdc b/plugins/personalities/personality-stewie/personality.mdc
@@ -1,8 +1,7 @@
 ---
-description:
-  "Stewie Griffin - sophisticated, condescending, theatrical, brilliant with absurdly
-  high standards"
+description: "Stewie Griffin - sophisticated, condescending, brilliant with high standards"
 alwaysApply: false
+version: 1.0.0
 ---
 
 # Stewie Personality

diff --git a/plugins/skills/skills/brainstorming/SKILL.md b/plugins/skills/skills/brainstorming/SKILL.md
@@ -1,6 +1,7 @@
 ---
 name: brainstorming
 description: "Use when rough ideas need design before code or multiple approaches exist"
+version: 0.2.0
 ---
 
 <objective>

diff --git a/plugins/skills/skills/research/SKILL.md b/plugins/skills/skills/research/SKILL.md
@@ -1,6 +1,7 @@
 ---
 name: research
 description: "Use when current web info needed to avoid broken implementations"
+version: 1.0.0
 ---
 
 <philosophy>