Initialize New Workspace

Create a new workspace structure for managing multiple llm-dev projects.

Workspace vs Project

• Workspace: A root directory containing multiple projects, with shared configuration
• Project: An individual codebase with its own archive and settings

Phase 1: Gather Information

Workspace name: $ARGUMENTS (first argument)

If workspace name not provided, ask the user for:

1. Workspace name (e.g., "dev", "work", "research")
2. Workspace description (1-2 sentences, optional)
3. Target path (default: current directory)

Phase 2: Locate Template

TEMPLATE_PATH="${CLAUDE_PLUGIN_ROOT}/.workspace-template"
if [[ ! -d "$TEMPLATE_PATH" ]]; then
    echo "Error: Workspace template not found at $TEMPLATE_PATH"
    exit 1
fi
echo "Using template: $TEMPLATE_PATH"

Phase 3: Create Workspace Structure

WORKSPACE_NAME="<workspace-name>"
WORKSPACE_PATH="<target-path>/$WORKSPACE_NAME"
WORKSPACE_DESCRIPTION="<description>"

# Copy template to workspace
# Use cp for cross-platform compatibility (works on macOS, Linux, Git Bash)
mkdir -p "$WORKSPACE_PATH"
cp -r "$TEMPLATE_PATH/." "$WORKSPACE_PATH/"
rm -rf "$WORKSPACE_PATH/.git" "$WORKSPACE_PATH/.gitmodules-template"

# Create .claude directory
mkdir -p "$WORKSPACE_PATH/.claude"

Phase 4: Replace Placeholders

# Replace placeholders in all markdown files
# Use GNU sed syntax (works on Linux, Git Bash, macOS with GNU sed)
find "$WORKSPACE_PATH" -type f -name "*.md" -exec sed -i \
    -e "s/{{WORKSPACE_NAME}}/$WORKSPACE_NAME/g" \
    -e "s/{{WORKSPACE_DESCRIPTION}}/$WORKSPACE_DESCRIPTION/g" \
    {} +

Phase 5: Initialize Git Repository

cd "$WORKSPACE_PATH"
git init

Phase 6: Add llm-dev

Ask user how they want to include llm-dev:

1. Git submodule (recommended for version control)
2. Git clone (simpler, manual updates)
3. Skip (use installed plugin only)

If submodule:

git submodule add https://github.com/DallasElleman/llm-dev.git llm-dev

If clone:

git clone https://github.com/DallasElleman/llm-dev.git "$WORKSPACE_PATH/llm-dev"

Phase 7: Add Reference Submodules (Optional)

Ask user if they want to add reference material submodules:

# Add 12-factor-agents
git submodule add https://github.com/humanlayer/12-factor-agents.git .references/12-factor-agents

# Add ccpm
git submodule add https://github.com/automazeio/ccpm.git .references/ccpm

# Initialize all submodules
git submodule update --init --recursive

Phase 8: Initial Commit

git add .
git commit -m "Initialize workspace from llm-dev template"

Phase 9: Summary

Report to user:

• Workspace created at: $WORKSPACE_PATH
• Structure overview
• Submodules added (if any)
• Next steps:
  • Customize CLAUDE.md with workspace-specific guidance
  • Create first project: /llm-dev:init-project my-project
  • Run /llm-dev:init-session to start tracking conversations