fix(plugin): restructure to .claude-plugin for Claude Code compatibility (#600)

- Rename claude-plugin/ to .claude-plugin/ (required by Claude Code)
- Rename claude.json to plugin.json (expected filename)
- Fix plugin.json schema (author as object, skills as directory paths)
- Update all references in READMEs and CI workflow

Claude Code expects .claude-plugin/plugin.json at repo root for marketplace-based plugins.

Signed-off-by: JasonXuDeveloper - 傑 <jason@xgamedev.net>

Author: JasonXuDeveloper

claude-plugin/CLAUDE.md .claude-plugin/CLAUDE.mdclaude-plugin/CLAUDE.md renamed to .claude-plugin/CLAUDE.md

@@ -2,27 +2,17 @@
 
 AI-powered development guide for JEngine Unity framework.
 
-## Installation (Recommended: Marketplace)
-
-Add the JEngine marketplace for **automatic updates**:
+## Installation
 
 ```bash
-# Add marketplace (one-time)
-claude plugin marketplace add https://github.com/JasonXuDeveloper/JEngine/tree/master/claude-plugin/marketplace.json
+# Add JEngine marketplace (one-time, enables auto-updates)
+claude plugin marketplace add JasonXuDeveloper/JEngine
 
 # Install plugin
 claude plugin install jengine@jengine-marketplace
 ```
 
-After this, plugin updates automatically when Claude Code starts.
-
-## Alternative: Direct Install
-
-```bash
-claude plugin install https://github.com/JasonXuDeveloper/JEngine/tree/master/claude-plugin
-```
-
-(Note: Direct installs require manual updates)
+Plugin updates automatically when Claude Code starts.
 
 ## Features
 

claude-plugin/README.md .claude-plugin/README.mdclaude-plugin/README.md renamed to .claude-plugin/README.md

@@ -8,11 +8,11 @@
   "plugins": [
     {
       "name": "jengine",
-      "description": "AI development guide for JEngine Unity hot-update framework",
+      "description": "AI guide for game development with JEngine Unity hot-update framework",
       "source": {
         "source": "github",
         "repo": "JasonXuDeveloper/JEngine",
-        "path": "claude-plugin",
+        "path": ".claude-plugin",
         "ref": "master"
       }
     }

claude-plugin/marketplace.json .claude-plugin/marketplace.jsonclaude-plugin/marketplace.json renamed to .claude-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "name": "jengine",
+  "description": "AI guide for game development with JEngine Unity hot-update framework",
+  "version": "1.0.1",
+  "author": {
+    "name": "JasonXuDeveloper"
+  },
+  "license": "MIT",
+  "repository": "https://github.com/JasonXuDeveloper/JEngine",
+  "keywords": ["unity", "hot-update", "hybridclr", "async", "unitask", "object-pool", "chainable-tasks", "editor-ui", "modal-dialog", "gc-optimization"],
+  "skills": [
+    "./skills/jaction",
+    "./skills/jobjectpool",
+    "./skills/messagebox",
+    "./skills/editor-ui"
+  ]
+}

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 # Plugin Maintenance
 
-The `claude-plugin/` folder contains AI agent documentation for end users who install JEngine packages.
+The `.claude-plugin/` folder contains AI agent documentation for end users who install JEngine packages.
 
 ## When to Update
 
@@ -14,25 +14,25 @@ Update the plugin documentation when:
 
 | Package Change | Plugin File to Update |
 |---------------|----------------------|
-| JAction API | `claude-plugin/skills/jaction/SKILL.md` |
-| JObjectPool API | `claude-plugin/skills/jobjectpool/SKILL.md` |
-| MessageBox API | `claude-plugin/skills/messagebox/SKILL.md` |
-| Editor UI components | `claude-plugin/skills/editor-ui/SKILL.md` |
-| Design Tokens | `claude-plugin/skills/editor-ui/SKILL.md` |
-| New utility class | Create new skill in `claude-plugin/skills/` |
-| General patterns | `claude-plugin/CLAUDE.md` |
+| JAction API | `.claude-plugin/skills/jaction/SKILL.md` |
+| JObjectPool API | `.claude-plugin/skills/jobjectpool/SKILL.md` |
+| MessageBox API | `.claude-plugin/skills/messagebox/SKILL.md` |
+| Editor UI components | `.claude-plugin/skills/editor-ui/SKILL.md` |
+| Design Tokens | `.claude-plugin/skills/editor-ui/SKILL.md` |
+| New utility class | Create new skill in `.claude-plugin/skills/` |
+| General patterns | `.claude-plugin/CLAUDE.md` |
 
 ## Checklist for API Changes
 
 - [ ] Update relevant SKILL.md with new/changed API
 - [ ] Add code examples for new features
 - [ ] Document common mistakes if any
-- [ ] Bump version in `claude-plugin/claude.json` (CI does this automatically on release)
+- [ ] Bump version in `.claude-plugin/plugin.json` (CI does this automatically on release)
 
 ## Version Sync
 
 Plugin version is automatically bumped by CI when packages are released.
-For manual updates, bump the version in `claude-plugin/claude.json`:
+For manual updates, bump the version in `.claude-plugin/plugin.json`:
 - Patch (x.x.1) for doc fixes
 - Minor (x.1.0) for new API coverage
 - Major (1.0.0) for breaking skill changes

claude-plugin/skills/editor-ui/SKILL.md .claude-plugin/skills/editor-ui/SKILL.mdclaude-plugin/skills/editor-ui/SKILL.md renamed to .claude-plugin/skills/editor-ui/SKILL.md

@@ -3,7 +3,7 @@ name: Release Plugin
 on:
   push:
     paths:
-      - 'claude-plugin/**'
+      - '.claude-plugin/**'
     branches:
       - master
   workflow_dispatch:
@@ -44,7 +44,7 @@ jobs:
         id: bump
         run: |
           BUMP_TYPE="${{ github.event.inputs.bump_type || 'patch' }}"
-          CURRENT=$(jq -r '.version' claude-plugin/claude.json)
+          CURRENT=$(jq -r '.version' .claude-plugin/plugin.json)
 
           IFS='.' read -r major minor patch <<< "$CURRENT"
           case $BUMP_TYPE in
@@ -53,8 +53,8 @@ jobs:
             patch) NEW_VERSION="$major.$minor.$((patch+1))" ;;
           esac
 
-          jq --arg v "$NEW_VERSION" '.version = $v' claude-plugin/claude.json > tmp.json
-          mv tmp.json claude-plugin/claude.json
+          jq --arg v "$NEW_VERSION" '.version = $v' .claude-plugin/plugin.json > tmp.json
+          mv tmp.json .claude-plugin/plugin.json
 
           echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT
           echo "Bumped plugin version from $CURRENT to $NEW_VERSION"
@@ -68,7 +68,7 @@ jobs:
           git config user.name "jengine-release-bot[bot]"
           git config user.email "257041894+jengine-release-bot[bot]@users.noreply.github.com"
 
-          git add claude-plugin/claude.json
+          git add .claude-plugin/plugin.json
 
           git commit -m "chore(plugin): bump version to ${{ steps.bump.outputs.version }}"