Setup Plugin

1# Setup Plugin
2 
3**Version**: 1.0.0
4**Purpose**: Project initialization and Claude Code configuration
5 
6## Overview
7 
8The setup plugin provides commands for initializing Claude Code in new and existing projects, configuring user-level settings, and setting up project-specific configurations.
9 
10## Commands
11 
12### `/setup:python [project-name]`
13Set up a new Python project with modern tooling and Claude framework integration.
14 
15**Features**:
16- Poetry or pip + venv support
17- pytest, black, ruff, mypy
18- .claude/ framework structure
19- .gitignore, pyproject.toml
20- Optional MCP integration
21 
22**Usage**:
23```bash
24/setup:python my-api
25/setup:python my-ml-project --minimal
26```
27 
28---
29 
30### `/setup:javascript [project-name]`
31Set up a new JavaScript/Node.js project with modern tooling and Claude framework integration.
32 
33**Features**:
34- npm/yarn support
35- TypeScript configuration
36- ESLint, Prettier
37- .claude/ framework structure
38- package.json, tsconfig.json
39 
40**Usage**:
41```bash
42/setup:javascript my-app
43/setup:javascript my-frontend
44```
45 
46---
47 
48### `/setup:existing`
49Add Claude Code framework to an existing project with auto-detection.
50 
51**Features**:
52- Auto-detects project language and framework
53- Adds .claude/ structure without disrupting existing setup
54- Configures plugins based on project type
55- Optional MCP server setup (Serena, Context7)
56 
57**Usage**:
58```bash
59cd ~/my-existing-project
60/setup:existing
61```
62 
63---
64 
65### `/setup:user [--force]`
66Initialize user-level Claude Code configuration (`~/.claude/CLAUDE.md`).
67 
68**Features**:
69- Global settings and preferences
70- User-level commands
71- Shared memory files
72- Plugin marketplace configuration
73 
74**Usage**:
75```bash
76/setup:user
77/setup:user --force  # Overwrite existing
78```
79 
80---
81 
82### `/setup:statusline`
83Configure Claude Code statusline to show framework context.
84 
85**Features**:
86- Shows current work unit
87- Displays active memory context
88- Token usage indicator
89- Project state summary
90 
91**Usage**:
92```bash
93/setup:statusline
94```
95 
96---
97 
98## Skills
99 
100### shared-setup-patterns
101Common configuration patterns and templates used across all setup commands.
102 
103**Provides**:
104- Security hooks (PreToolUse, PostToolUse)
105- Claude framework structure templates
106- Framework detection patterns
107 
108**Token Impact**: ~1,700 tokens shared across 5 commands (saves ~3,200 tokens)
109 
110---
111 
112## Installation
113 
114### Enable in Project
115 
116Add to `.claude/settings.json`:
117```json
118{
119  "extraKnownMarketplaces": {
120    "local": {
121      "source": {
122        "source": "directory",
123        "path": "~/agents/plugins"
124      }
125    }
126  },
127  "enabledPlugins": {
128    "setup@local": true
129  }
130}
131```
132 
133### Quick Start
134 
135```bash
136# New Python project
137/setup:python my-project
138 
139# New JavaScript project
140/setup:javascript my-app
141 
142# Add to existing project
143cd ~/my-project && /setup:existing
144 
145# Configure user settings
146/setup:user
147```
148 
149---
150 
151## Token Efficiency
152 
153**Design Pattern**: Subcommand pattern with shared skill
154 
155- Each setup mode loads independently (~2,500-4,000 tokens)
156- Shared patterns loaded once via skill (~1,700 tokens)
157- Total savings: ~67-85% vs monolithic setup command
158 
159**Example**:
160- Old `/setup` (monolithic): 9,700 tokens always loaded
161- New `/setup:python`: 2,900 tokens (70% reduction)
162 
163---
164 
165## Related Plugins
166 
167- **system** - Health monitoring (`/system:audit`, `/system:status`)
168- **workflow** - Development workflow (`/explore`, `/plan`, `/next`)
169- **memory** - Knowledge management (`/index`, `/handoff`)
170 
171---
172 
173**Part of Claude Code Framework Core Plugins** (v1.0.0)
174