init-scaffolding

/init-scaffolding Command

Bootstrap a new project with the scaffolding CLAUDE.md, settings.json, and .scaffolding/ directory structure.

Usage

/init-scaffolding

Run from the root of a project that was set up via /plugin install scaffolding@komluk-scaffolding. This command creates the .scaffolding/ directory structure, copies the routing protocol and settings into the project so Claude respects the agent delegation rules on every session.

What It Does

1. Locates the installed plugin directory (searches known marketplace cache paths)
2. Creates .scaffolding/ directory structure for agent memory, conversations, and specs
3. Adds .scaffolding/ and .claude/worktrees/ to .gitignore
4. Installs the routing protocol in $CWD/CLAUDE.md — never overwrites an existing file: left alone if it already has the protocol or an @...CLAUDE.md import, otherwise the protocol is appended (a new file is created if absent)
5. Copies settings.json to $CWD/.claude/settings.json — always overwrites with latest from plugin
6. Copies hooks/*.sh to $CWD/.claude/hooks/ — always overwrites with latest from plugin
7. Reports what was copied

Steps

Follow these steps exactly:

1. Find the plugin root directory

Search for the plugin in the known Claude Code plugin cache location:

PLUGIN_ROOT=""

# Search helper: find latest version directory containing CLAUDE.md under a base path
find_plugin_root() {
  local base="$1"
  [ -d "$base" ] || return
  # Try versioned path: base/scaffolding/<version>/CLAUDE.md
  local latest
  latest=$(find "$base" -name "CLAUDE.md" -path "*/scaffolding/*/CLAUDE.md" 2>/dev/null | sort -V | tail -1 | xargs dirname 2>/dev/null || true)
  if [ -n "$latest" ] && [ -f "$latest/CLAUDE.md" ]; then
    echo "$latest"
    return
  fi
  # Fallback: any CLAUDE.md anywhere under this base
  latest=$(find "$base" -name "CLAUDE.md" 2>/dev/null | sort -V | tail -1 | xargs dirname 2>/dev/null || true)
  if [ -n "$latest" ] && [ -f "$latest/CLAUDE.md" ]; then
    echo "$latest"
    return
  fi
}

# Unix / macOS (Linux, macOS, WSL)
for base in \
  "$HOME/.claude/plugins/cache/komluk-scaffolding" \
  "$HOME/.claude/plugins/marketplaces/komluk-scaffolding"; do
  found=$(find_plugin_root "$base")
  if [ -n "$found" ]; then
    PLUGIN_ROOT="$found"
    break
  fi
done

# Windows (Git Bash / MSYS2) — USERPROFILE and LOCALAPPDATA are set by the shell
if [ -z "$PLUGIN_ROOT" ]; then
  for base in \
    "${USERPROFILE:-}/.claude/plugins/cache/komluk-scaffolding" \
    "${LOCALAPPDATA:-}/claude/plugins/cache/komluk-scaffolding"; do
    [ -n "$base" ] || continue
    found=$(find_plugin_root "$base")
    if [ -n "$found" ]; then
      PLUGIN_ROOT="$found"
      break
    fi
  done
fi

echo "Plugin root: ${PLUGIN_ROOT:-NOT FOUND}"