docs: update paths for claude-plugin subdirectory structure (GH#985) (#1007)

Update documentation and scripts to reflect the plugin move from
root level to claude-plugin/ subdirectory:

- Fix command links in docs/DAEMON.md, docs/SYNC.md, examples/
- Update plugin.json path references in RELEASING.md, AGENT_INSTRUCTIONS.md
- Update scripts/bump-version.sh and scripts/check-versions.sh
- Update skill documentation paths in claude-plugin/skills/beads/

The marketplace.json correctly stays at .claude-plugin/ (root level)
while plugin.json moved to claude-plugin/.claude-plugin/.

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

scripts/README.md

@@ -88,7 +88,7 @@ Bumps the version number across all beads components in a single command.
 
 Updates version in all these files:
 - `cmd/bd/version.go` - bd CLI version constant
-- `.claude-plugin/plugin.json` - Plugin version
+- `claude-plugin/.claude-plugin/plugin.json` - Plugin version
 - `.claude-plugin/marketplace.json` - Marketplace plugin version
 - `integrations/beads-mcp/pyproject.toml` - MCP server version
 - `README.md` - Alpha status version

scripts/bump-version.sh

@@ -313,9 +313,9 @@ main() {
         "Version = \"$CURRENT_VERSION\"" \
         "Version = \"$NEW_VERSION\""
 
-    # 2. Update .claude-plugin/plugin.json
-    echo "  • .claude-plugin/plugin.json"
-    update_file ".claude-plugin/plugin.json" \
+    # 2. Update claude-plugin/.claude-plugin/plugin.json
+    echo "  • claude-plugin/.claude-plugin/plugin.json"
+    update_file "claude-plugin/.claude-plugin/plugin.json" \
         "\"version\": \"$CURRENT_VERSION\"" \
         "\"version\": \"$NEW_VERSION\""
 
@@ -383,7 +383,7 @@ main() {
     echo "Verifying version consistency..."
     VERSIONS=(
         "$(grep 'Version = ' cmd/bd/version.go | sed 's/.*"\(.*\)".*/\1/')"
-        "$(jq -r '.version' .claude-plugin/plugin.json)"
+        "$(jq -r '.version' claude-plugin/.claude-plugin/plugin.json)"
         "$(jq -r '.plugins[0].version' .claude-plugin/marketplace.json)"
         "$(grep 'version = ' integrations/beads-mcp/pyproject.toml | head -1 | sed 's/.*"\(.*\)".*/\1/')"
         "$(grep '__version__ = ' integrations/beads-mcp/src/beads_mcp/__init__.py | sed 's/.*"\(.*\)".*/\1/')"
@@ -722,7 +722,7 @@ main() {
         echo "Creating git commit..."
 
         git add cmd/bd/version.go \
-                .claude-plugin/plugin.json \
+                claude-plugin/.claude-plugin/plugin.json \
                 .claude-plugin/marketplace.json \
                 integrations/beads-mcp/pyproject.toml \
                 integrations/beads-mcp/src/beads_mcp/__init__.py \

scripts/check-versions.sh

@@ -43,8 +43,8 @@ check_version "integrations/beads-mcp/src/beads_mcp/__init__.py" \
     "$(grep '__version__ = ' integrations/beads-mcp/src/beads_mcp/__init__.py 2>/dev/null | sed 's/.*"\(.*\)".*/\1/')" \
     "MCP __init__.py"
 
-check_version ".claude-plugin/plugin.json" \
-    "$(jq -r '.version' .claude-plugin/plugin.json 2>/dev/null)" \
+check_version "claude-plugin/.claude-plugin/plugin.json" \
+    "$(jq -r '.version' claude-plugin/.claude-plugin/plugin.json 2>/dev/null)" \
     "Claude plugin.json"
 
 check_version ".claude-plugin/marketplace.json" \