v3/implementation/init/CONFIGURATION.md
Complete reference for V3 init configuration options.
Main configuration interface for the init system.
interface InitOptions {
targetDir: string; // Target directory for initialization
sourceBaseDir?: string; // Source directory for skills/commands/agents
force: boolean; // Overwrite existing files
interactive: boolean; // Enable interactive prompts
components: InitComponents; // Which components to install
hooks: HooksConfig; // Hook configuration
skills: SkillsConfig; // Skills to install
commands: CommandsConfig; // Commands to install
agents: AgentsConfig; // Agents to install
statusline: StatuslineConfig; // Statusline options
mcp: MCPConfig; // MCP server config
runtime: RuntimeConfig; // V3 runtime config
}
interface InitComponents {
settings: boolean; // .claude/settings.json
skills: boolean; // .claude/skills/
commands: boolean; // .claude/commands/
agents: boolean; // .claude/agents/
helpers: boolean; // .claude/helpers/
statusline: boolean; // statusline scripts
mcp: boolean; // .mcp.json
runtime: boolean; // .claude-flow/
}
{
settings: true,
skills: true,
commands: true,
agents: true,
helpers: true,
statusline: false, // Optional
mcp: true,
runtime: true,
}
interface HooksConfig {
preToolUse: boolean; // Before tool operations
postToolUse: boolean; // After tool operations
userPromptSubmit: boolean; // On prompt submission
sessionStart: boolean; // On session start
stop: boolean; // On stop consideration
notification: boolean; // On notifications
permissionRequest: boolean; // On permission requests
timeout: number; // Default timeout (ms)
continueOnError: boolean; // Continue on hook failure
}
{
preToolUse: true,
postToolUse: true,
userPromptSubmit: true,
sessionStart: true,
stop: true,
notification: true,
permissionRequest: true,
timeout: 5000,
continueOnError: true,
}
interface SkillsConfig {
core: boolean; // Core development skills
agentdb: boolean; // AgentDB integration skills
github: boolean; // GitHub automation skills
flowNexus: boolean; // Flow Nexus platform skills
v3: boolean; // V3-specific skills
all: boolean; // Install all available skills
}
| Set | Skills Count | Description |
|---|---|---|
| core | 8 | Swarm, SPARC, hooks, pair programming |
| agentdb | 7 | Vector search, memory patterns, learning |
| github | 5 | Code review, releases, workflows |
| flowNexus | 3 | Neural, swarm, platform skills |
| v3 | 9 | V3 implementation skills |
interface CommandsConfig {
core: boolean; // Core commands
analysis: boolean; // Code analysis
automation: boolean; // Task automation
github: boolean; // GitHub operations
hooks: boolean; // Hook management
monitoring: boolean; // System monitoring
optimization: boolean; // Performance tuning
sparc: boolean; // SPARC methodology
}
interface AgentsConfig {
core: boolean; // Basic development agents
github: boolean; // GitHub-integrated agents
sparc: boolean; // SPARC methodology agents
swarm: boolean; // Swarm coordination agents
consensus: boolean; // Distributed consensus agents
hiveMind: boolean; // Collective intelligence agents
}
interface MCPConfig {
claudeFlow: boolean; // claude-flow MCP server
agenticFlow: boolean; // agentic-flow integration
memory: boolean; // Memory MCP tools
neural: boolean; // Neural MCP tools
github: boolean; // GitHub MCP integration
}
| Variable | Default | Description |
|---|---|---|
CLAUDE_FLOW_MODE | v3 | Operation mode |
CLAUDE_FLOW_HOOKS_ENABLED | true | Enable hooks |
CLAUDE_FLOW_TOPOLOGY | hierarchical-mesh | Swarm topology |
CLAUDE_FLOW_MAX_AGENTS | 15 | Maximum agents |
CLAUDE_FLOW_MEMORY_BACKEND | hybrid | Memory backend |
interface RuntimeConfig {
topology: 'mesh' | 'hierarchical' | 'hierarchical-mesh' | 'adaptive';
maxAgents: number;
memoryBackend: 'memory' | 'sqlite' | 'agentdb' | 'hybrid';
enableHNSW: boolean; // HNSW indexing
enableNeural: boolean; // Neural features
}
| Topology | Description | Best For |
|---|---|---|
mesh | Peer-to-peer | Small teams |
hierarchical | Queen-led | Large projects |
hierarchical-mesh | Hybrid | Most projects |
adaptive | Auto-switching | Dynamic workloads |
interface StatuslineConfig {
enabled: boolean;
style: 'minimal' | 'standard' | 'detailed';
position: 'left' | 'right';
refreshInterval: number; // ms
}
Recommended for most projects:
{
targetDir: process.cwd(),
force: false,
interactive: true,
components: {
settings: true,
skills: true,
commands: true,
agents: true,
helpers: true,
statusline: false,
mcp: true,
runtime: true,
},
hooks: {
preToolUse: true,
postToolUse: true,
userPromptSubmit: true,
sessionStart: true,
stop: true,
notification: true,
permissionRequest: true,
timeout: 5000,
continueOnError: true,
},
skills: {
core: true,
agentdb: true,
github: true,
flowNexus: false,
v3: true,
all: false,
},
commands: {
core: true,
analysis: true,
automation: true,
github: true,
hooks: true,
monitoring: true,
optimization: true,
sparc: true,
},
agents: {
core: true,
github: true,
sparc: true,
swarm: true,
consensus: false,
hiveMind: false,
},
runtime: {
topology: 'hierarchical-mesh',
maxAgents: 15,
memoryBackend: 'hybrid',
enableHNSW: true,
enableNeural: true,
},
}
Lightweight configuration:
{
// ... base options
components: {
settings: true,
skills: true,
commands: false,
agents: false,
helpers: false,
statusline: false,
mcp: true,
runtime: true,
},
skills: { core: true, /* others false */ },
agents: { core: true, /* others false */ },
runtime: {
topology: 'mesh',
maxAgents: 5,
memoryBackend: 'memory',
enableHNSW: false,
enableNeural: false,
},
}
Everything enabled:
{
// All components: true
// All skills: true (including flowNexus, all)
// All commands: true
// All agents: true (including consensus, hiveMind)
// All hooks: true
// All MCP servers: true
}