Initial commit
This commit is contained in:
Zhongwei Li
91
commands/squad-assemble.md
Normal file
91
commands/squad-assemble.md
Normal file
@@ -0,0 +1,91 @@
|
||||
---
|
||||
description: Permanently install and activate squad functionality with full infrastructure
|
||||
argument-hint:
|
||||
allowed-tools: Bash(*), Read(*), Write(*)
|
||||
---
|
||||
|
||||
# Squad Assemble - Permanent Installation
|
||||
|
||||
Permanently install and activate the claude-agents squad functionality with full infrastructure setup.
|
||||
|
||||
## What Squad Assemble Does
|
||||
|
||||
1. **Creates permanent state file** for persistent activation
|
||||
2. **Installs session hook** with robust error handling
|
||||
3. **Verifies infrastructure** and creates missing components
|
||||
4. **Prompts for context clearing** to ensure clean state
|
||||
5. **Validates installation** and reports status
|
||||
|
||||
## Implementation
|
||||
|
||||
Creating permanent squad infrastructure...
|
||||
|
||||
!mkdir -p ~/.claude/hooks
|
||||
!mkdir -p ~/.claude/backups
|
||||
|
||||
Setting squad functionality to PERMANENTLY ENABLED...
|
||||
|
||||
!echo "CLAUDE_SQUAD_ENABLED=1" > ~/.claude/.squad_enabled
|
||||
!echo "SQUAD_INSTALL_DATE=$(date)" >> ~/.claude/.squad_enabled
|
||||
!echo "SQUAD_INSTALL_MODE=permanent" >> ~/.claude/.squad_enabled
|
||||
|
||||
Creating robust session hook...
|
||||
|
||||
!cat > ~/.claude/hooks/sessionStart.sh << 'EOF'
|
||||
#!/bin/bash
|
||||
|
||||
# SessionStart hook to load SQUAD.md orchestration rules
|
||||
# This hook runs at the beginning of each session and after /clear
|
||||
|
||||
# Check if squad is enabled
|
||||
if [ -f "$HOME/.claude/.squad_enabled" ]; then
|
||||
SQUAD_FILE="$HOME/.claude/SQUAD.md"
|
||||
|
||||
# Check if SQUAD.md exists
|
||||
if [ -f "$SQUAD_FILE" ]; then
|
||||
echo "🤖 Loading squad orchestration rules from SQUAD.md..."
|
||||
cat "$SQUAD_FILE"
|
||||
else
|
||||
echo "⚠️ Warning: SQUAD.md not found at $SQUAD_FILE"
|
||||
echo "Agent orchestration rules may not be properly configured."
|
||||
fi
|
||||
else
|
||||
echo "ℹ️ Squad functionality disabled. Use /squad-on to enable agent delegation."
|
||||
fi
|
||||
EOF
|
||||
|
||||
!chmod +x ~/.claude/hooks/sessionStart.sh
|
||||
|
||||
## Infrastructure Verification
|
||||
|
||||
Verifying squad infrastructure...
|
||||
|
||||
!echo "🔍 Infrastructure Check:"
|
||||
!echo "✅ Session hook: $([ -x ~/.claude/hooks/sessionStart.sh ] && echo 'Installed' || echo 'Missing')"
|
||||
!echo "✅ State file: $([ -f ~/.claude/.squad_enabled ] && echo 'Created' || echo 'Missing')"
|
||||
!echo "✅ SQUAD.md: $([ -f ~/.claude/SQUAD.md ] && echo 'Available' || echo 'Missing')"
|
||||
!echo "✅ Hooks directory: $([ -d ~/.claude/hooks ] && echo 'Ready' || echo 'Missing')"
|
||||
!echo "✅ Backups directory: $([ -d ~/.claude/backups ] && echo 'Ready' || echo 'Missing')"
|
||||
|
||||
## Context Clearing
|
||||
|
||||
**⚠️ IMPORTANT**: To ensure proper squad activation, your current context should be cleared.
|
||||
|
||||
**Do you want to clear the context now?**
|
||||
|
||||
Respond with 'yes' to clear context and activate squad functionality, or 'no' to keep current context.
|
||||
|
||||
If you choose 'yes', the context will be cleared and squad functionality will be active in your next interaction.
|
||||
|
||||
## Squad Assembled Status
|
||||
|
||||
✅ **Squad functionality is now PERMANENTLY ASSEMBLED**
|
||||
|
||||
- Agent delegation rules permanently active
|
||||
- SQUAD.md will load on every session start
|
||||
- Specialist routing available
|
||||
- Quality gates enforced
|
||||
- Infrastructure verified and installed
|
||||
|
||||
Use `/squad-dismiss` to completely remove squad functionality if needed.
|
||||
Use `/squad-standdown` for temporary session-only disable.
|
||||
98
commands/squad-deploy.md
Normal file
98
commands/squad-deploy.md
Normal file
@@ -0,0 +1,98 @@
|
||||
---
|
||||
description: Deploy and activate Claude Squad plugin agents and delegation system
|
||||
argument-hint: [--local] [--project]
|
||||
allowed-tools: Bash(*), Read(*), Write(*)
|
||||
---
|
||||
|
||||
# Squad Deploy - Activate Claude Squad Plugin
|
||||
|
||||
Deploy the Claude Squad plugin to activate intelligent delegation and agent specialization.
|
||||
|
||||
## Plugin-Based Deployment
|
||||
|
||||
**Arguments**: $ARGUMENTS
|
||||
|
||||
**Note**: This command works within the Claude Squad plugin system. The plugin is already installed - this command activates/configures it.
|
||||
|
||||
## Deployment Options
|
||||
|
||||
1. **Global Configuration** (default): Activates squad system globally for all sessions
|
||||
2. **Project-Level** (`--project`): Activates squad system for current project only
|
||||
|
||||
## What Squad Deploy Does
|
||||
|
||||
1. **Verify plugin installation** and component availability
|
||||
2. **Enable squad system** through configuration flags
|
||||
3. **Validate agent definitions** and command availability
|
||||
4. **Activate session hooks** for automatic rule loading
|
||||
5. **Report deployment status** and next steps
|
||||
|
||||
## Plugin Verification
|
||||
|
||||
First, let me verify the plugin is properly installed:
|
||||
|
||||
!echo "🔍 Checking Claude Squad plugin status..."
|
||||
|
||||
## Activate Squad System
|
||||
|
||||
Enable the Claude Squad delegation system:
|
||||
|
||||
!echo "🚀 Activating Claude Squad system..."
|
||||
|
||||
## Enable Squad Configuration
|
||||
|
||||
Determine deployment scope and create configuration:
|
||||
|
||||
!if [[ "$ARGUMENTS" == *"--project"* ]]; then
|
||||
echo "📁 Activating Claude Squad for current project only"
|
||||
touch ./.squad_enabled
|
||||
echo "CLAUDE_SQUAD_ENABLED=1" > ./.squad_enabled
|
||||
else
|
||||
echo "🌐 Activating Claude Squad globally"
|
||||
mkdir -p ~/.claude
|
||||
echo "CLAUDE_SQUAD_ENABLED=1" > ~/.claude/.squad_enabled
|
||||
fi
|
||||
|
||||
## Plugin Status Check
|
||||
|
||||
Verify plugin components are available:
|
||||
|
||||
!echo "📋 Plugin Component Status:"
|
||||
!echo " Agents: $(ls agents/ 2>/dev/null | wc -l | xargs) available"
|
||||
!echo " Commands: $(ls commands/ 2>/dev/null | wc -l | xargs) available"
|
||||
!echo " Hooks: $(ls hooks/ 2>/dev/null | wc -l | xargs) configured"
|
||||
|
||||
## Validation
|
||||
|
||||
Verify the plugin deployment is working:
|
||||
|
||||
!if [[ -f ~/.claude/.squad_enabled ]] || [[ -f ./.squad_enabled ]]; then
|
||||
echo "✅ Squad system successfully activated"
|
||||
echo "🤖 Agent delegation is now enabled"
|
||||
else
|
||||
echo "❌ Squad activation failed"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
## Post-Deployment
|
||||
|
||||
After successful deployment:
|
||||
- ✅ **29 specialist agents** available for task delegation
|
||||
- ✅ **Mandatory delegation system** enforces quality workflows
|
||||
- ✅ **CLAUDE.md rules** active for domain routing
|
||||
- ✅ **Session hooks** load squad rules automatically
|
||||
- ✅ **Quality gates** ensure code review → testing → simplicity
|
||||
- ✅ **Squad commands** available for management
|
||||
|
||||
## Next Steps
|
||||
|
||||
**🎯 Claude Squad Plugin successfully deployed!**
|
||||
|
||||
Available squad management commands:
|
||||
- `/squad-status` - Check current agent status
|
||||
- `/squad-off` - Temporarily disable delegation
|
||||
- `/squad-on` - Re-enable agent delegation
|
||||
- `/squad-furlough` - Disable specific agents
|
||||
- `/squad-assemble` - Reactivate all agents
|
||||
|
||||
**Ready to delegate! Try asking Claude to implement a feature and watch the specialist agents take over.**
|
||||
89
commands/squad-dismiss.md
Normal file
89
commands/squad-dismiss.md
Normal file
@@ -0,0 +1,89 @@
|
||||
---
|
||||
description: Dismiss squad agents and restore backup configuration
|
||||
argument-hint: [--local] [--global] [--keep-config]
|
||||
allowed-tools: Bash(*), Read(*), Write(*), Glob(*)
|
||||
---
|
||||
|
||||
# Squad Dismiss - Deactivate Agent System
|
||||
|
||||
Dismiss the claude-agents squad and restore previous configuration state.
|
||||
|
||||
## Dismissal Options
|
||||
|
||||
**Arguments**: $ARGUMENTS
|
||||
|
||||
Available dismissal modes:
|
||||
|
||||
1. **Global Dismissal** (default): Remove from `~/.claude/`
|
||||
2. **Local Dismissal** (`--local`): Remove from current project's `.claude/`
|
||||
3. **Keep Config** (`--keep-config`): Remove agents but preserve CLAUDE.md
|
||||
|
||||
## What Squad Dismiss Does
|
||||
|
||||
Safely removes agent configuration and restores backup state:
|
||||
|
||||
1. **Remove active agents** directory
|
||||
2. **Restore backup CLAUDE.md** (unless `--keep-config`)
|
||||
3. **Preserve disabled_agents** for future deployment
|
||||
4. **Clean up temporary files**
|
||||
|
||||
## Pre-Dismissal Check
|
||||
|
||||
Check current deployment status:
|
||||
|
||||
!echo "🔍 Current agent deployment status:"
|
||||
!ls -la ~/.claude/agents/ 2>/dev/null || echo "ℹ️ No global agents deployed"
|
||||
!ls -la ./.claude/agents/ 2>/dev/null || echo "ℹ️ No local agents deployed"
|
||||
|
||||
!echo "📦 Available backups:"
|
||||
!ls -la ~/.claude/backups/ 2>/dev/null | head -5 || echo "ℹ️ No backups found"
|
||||
|
||||
## Dismissal Target Analysis
|
||||
|
||||
Parse arguments to determine dismissal scope:
|
||||
|
||||
**Dismissal Mode**: $ARGUMENTS
|
||||
|
||||
- Contains `--local` → Remove local project agents only
|
||||
- Contains `--global` → Remove global agents only
|
||||
- Contains `--keep-config` → Preserve CLAUDE.md configuration
|
||||
- No arguments → Default global dismissal
|
||||
|
||||
## Agent Removal Process
|
||||
|
||||
Remove agents based on target:
|
||||
|
||||
1. **Identify target directory** (global `~/.claude/` or local `./.claude/`)
|
||||
2. **Backup current state** before removal
|
||||
3. **Remove agents directory** completely
|
||||
4. **Report removal status**
|
||||
|
||||
## Configuration Restoration
|
||||
|
||||
Unless `--keep-config` is specified:
|
||||
|
||||
1. **Find most recent backup** CLAUDE.md
|
||||
2. **Restore backup** to target location
|
||||
3. **Report restoration status**
|
||||
|
||||
If `--keep-config`:
|
||||
- Keep existing CLAUDE.md intact
|
||||
- Only remove agents directory
|
||||
|
||||
## Post-Dismissal State
|
||||
|
||||
After successful dismissal:
|
||||
- Agents no longer available for delegation
|
||||
- Claude returns to standard operation mode
|
||||
- Original configuration restored (if backup available)
|
||||
- Disabled agents remain available for future deployment
|
||||
|
||||
## Cleanup
|
||||
|
||||
Remove any temporary files and verify clean dismissal:
|
||||
|
||||
!echo "✅ Squad dismissal verification:"
|
||||
!ls -la ~/.claude/agents/ 2>/dev/null || echo "✅ Global agents removed"
|
||||
!ls -la ./.claude/agents/ 2>/dev/null || echo "✅ Local agents removed"
|
||||
|
||||
**🎯 Squad dismissed! Claude returned to standard operation mode.**
|
||||
102
commands/squad-furlough.md
Normal file
102
commands/squad-furlough.md
Normal file
@@ -0,0 +1,102 @@
|
||||
---
|
||||
description: Turn off orchestrator while keeping agents available for direct invocation
|
||||
argument-hint:
|
||||
allowed-tools: Bash(*), Read(*), Write(*)
|
||||
---
|
||||
|
||||
# Squad Furlough - Disable Orchestrator Only
|
||||
|
||||
Disable the orchestrator and automatic delegation while keeping agents available for direct invocation.
|
||||
|
||||
## What Squad Furlough Does
|
||||
|
||||
1. **Creates furlough state file** to track orchestrator disable
|
||||
2. **Updates hook to skip orchestration** but preserve agent access
|
||||
3. **Maintains agent infrastructure** for manual invocation
|
||||
4. **Prompts for context clearing** to ensure clean state
|
||||
|
||||
## Implementation
|
||||
|
||||
Creating furlough state (orchestrator disabled, agents available)...
|
||||
|
||||
!echo "SQUAD_FURLOUGH=$(date)" > ~/.claude/.squad_furlough
|
||||
!echo "ORCHESTRATOR_DISABLED=true" >> ~/.claude/.squad_furlough
|
||||
!echo "AGENTS_AVAILABLE=true" >> ~/.claude/.squad_furlough
|
||||
|
||||
Updating session hook for furlough mode...
|
||||
|
||||
!cat > ~/.claude/hooks/sessionStart.sh << 'EOF'
|
||||
#!/bin/bash
|
||||
|
||||
# SessionStart hook to load SQUAD.md orchestration rules
|
||||
# This hook runs at the beginning of each session and after /clear
|
||||
|
||||
# Check for session-only disable first
|
||||
if [ -f "$HOME/.claude/.squad_session_disabled" ]; then
|
||||
echo "⏸️ Squad temporarily disabled for this session."
|
||||
echo "Use /squad-on to re-enable for this session."
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check for furlough mode (orchestrator disabled, agents available)
|
||||
if [ -f "$HOME/.claude/.squad_furlough" ]; then
|
||||
echo "🏖️ Squad in furlough mode - Orchestrator disabled, agents available for direct invocation."
|
||||
echo "💡 You can still invoke agents directly using Task() calls."
|
||||
echo "Use /squad-on to re-enable full orchestration."
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check if squad is enabled
|
||||
if [ -f "$HOME/.claude/.squad_enabled" ]; then
|
||||
SQUAD_FILE="$HOME/.claude/SQUAD.md"
|
||||
|
||||
# Check if SQUAD.md exists
|
||||
if [ -f "$SQUAD_FILE" ]; then
|
||||
echo "🤖 Loading squad orchestration rules from SQUAD.md..."
|
||||
cat "$SQUAD_FILE"
|
||||
else
|
||||
echo "⚠️ Warning: SQUAD.md not found at $SQUAD_FILE"
|
||||
echo "Agent orchestration rules may not be properly configured."
|
||||
fi
|
||||
else
|
||||
echo "ℹ️ Squad functionality disabled. Use /squad-on to enable agent delegation."
|
||||
fi
|
||||
EOF
|
||||
|
||||
!chmod +x ~/.claude/hooks/sessionStart.sh
|
||||
|
||||
## Furlough State Check
|
||||
|
||||
!echo "🔍 Current State:"
|
||||
!echo "✅ Permanent state: $([ -f ~/.claude/.squad_enabled ] && echo 'Preserved' || echo 'Not installed')"
|
||||
!echo "🏖️ Furlough mode: $([ -f ~/.claude/.squad_furlough ] && echo 'Active' || echo 'Inactive')"
|
||||
!echo "🤖 Agent access: Available for direct Task() invocation"
|
||||
|
||||
## Context Clearing
|
||||
|
||||
**⚠️ IMPORTANT**: To ensure proper furlough activation, your current context should be cleared.
|
||||
|
||||
**Do you want to clear the context now?**
|
||||
|
||||
Respond with 'yes' to clear context and activate furlough mode, or 'no' to keep current context.
|
||||
|
||||
If you choose 'yes', the context will be cleared and you'll be able to invoke agents directly without automatic orchestration.
|
||||
|
||||
## Squad Furlough Status
|
||||
|
||||
🏖️ **Squad is now in FURLOUGH MODE**
|
||||
|
||||
- Orchestrator disabled (no automatic delegation)
|
||||
- Agents available for direct Task() invocation
|
||||
- Manual specialist access maintained
|
||||
- Quality gates inactive
|
||||
|
||||
**Available for direct invocation:**
|
||||
- Task(agent="infrastructure-specialist", prompt="...")
|
||||
- Task(agent="frontend-developer", prompt="...")
|
||||
- Task(agent="backend-architect", prompt="...")
|
||||
- Task(agent="security-auditor", prompt="...")
|
||||
- And all other specialist agents
|
||||
|
||||
Use `/squad-on` to re-enable full orchestration.
|
||||
Use `/squad-dismiss` to completely remove squad functionality.
|
||||
70
commands/squad-off.md
Normal file
70
commands/squad-off.md
Normal file
@@ -0,0 +1,70 @@
|
||||
---
|
||||
description: Disable squad functionality and agent delegation
|
||||
argument-hint:
|
||||
allowed-tools: Bash(*), Read(*), Write(*)
|
||||
---
|
||||
|
||||
# Squad Off - Disable Agent Delegation
|
||||
|
||||
Disable the claude-agents squad functionality to return to direct Claude interaction without agent delegation.
|
||||
|
||||
## What Squad Off Does
|
||||
|
||||
1. **Removes environment flag** to disable squad functionality
|
||||
2. **Updates session hook** to skip SQUAD.md loading
|
||||
3. **Prompts for context clearing** to ensure clean state
|
||||
4. **Clears context** after user confirmation
|
||||
|
||||
## Implementation
|
||||
|
||||
Setting squad functionality to DISABLED...
|
||||
|
||||
!rm -f ~/.claude/.squad_enabled
|
||||
|
||||
Updating session hook to skip SQUAD.md loading...
|
||||
|
||||
!cat > ~/.claude/hooks/sessionStart.sh << 'EOF'
|
||||
#!/bin/bash
|
||||
|
||||
# SessionStart hook to load SQUAD.md orchestration rules
|
||||
# This hook runs at the beginning of each session and after /clear
|
||||
|
||||
# Check if squad is enabled
|
||||
if [ -f "$HOME/.claude/.squad_enabled" ]; then
|
||||
SQUAD_FILE="$HOME/.claude/SQUAD.md"
|
||||
|
||||
# Check if SQUAD.md exists
|
||||
if [ -f "$SQUAD_FILE" ]; then
|
||||
echo "🤖 Loading squad orchestration rules from SQUAD.md..."
|
||||
cat "$SQUAD_FILE"
|
||||
else
|
||||
echo "⚠️ Warning: SQUAD.md not found at $SQUAD_FILE"
|
||||
echo "Agent orchestration rules may not be properly configured."
|
||||
fi
|
||||
else
|
||||
echo "ℹ️ Squad functionality disabled. Use /squad-on to enable agent delegation."
|
||||
fi
|
||||
EOF
|
||||
|
||||
!chmod +x ~/.claude/hooks/sessionStart.sh
|
||||
|
||||
## Context Clearing
|
||||
|
||||
**⚠️ IMPORTANT**: To ensure proper squad deactivation, your current context should be cleared.
|
||||
|
||||
**Do you want to clear the context now?**
|
||||
|
||||
Respond with 'yes' to clear context and deactivate squad functionality, or 'no' to keep current context.
|
||||
|
||||
If you choose 'yes', the context will be cleared and you'll interact directly with Claude without agent delegation.
|
||||
|
||||
## Squad Disabled Status
|
||||
|
||||
❌ **Squad functionality is now DISABLED**
|
||||
|
||||
- No agent delegation
|
||||
- Direct Claude interaction
|
||||
- SQUAD.md will not load on session start
|
||||
- Quality gates inactive
|
||||
|
||||
Use `/squad-on` to re-enable squad functionality if needed.
|
||||
84
commands/squad-on.md
Normal file
84
commands/squad-on.md
Normal file
@@ -0,0 +1,84 @@
|
||||
---
|
||||
description: Enable Claude Squad plugin agent delegation and orchestration system
|
||||
argument-hint:
|
||||
allowed-tools: Bash(*)
|
||||
---
|
||||
|
||||
# Squad On - Enable Agent Delegation
|
||||
|
||||
Enable the Claude Squad plugin functionality to activate intelligent delegation and agent specialization.
|
||||
|
||||
## What Squad On Does
|
||||
|
||||
1. **Enables squad system** through configuration flags
|
||||
2. **Clears temporary disable states** from previous sessions
|
||||
3. **Activates plugin hooks** for automatic rule loading
|
||||
4. **Reports activation status** and available agents
|
||||
|
||||
## Plugin Activation
|
||||
|
||||
Setting Claude Squad plugin to ENABLED...
|
||||
|
||||
!# Clear any temporary disable states
|
||||
!rm -f ~/.claude/.squad_session_disabled
|
||||
!rm -f ./.squad_session_disabled
|
||||
!rm -f ~/.claude/.squad_furlough
|
||||
!rm -f ./.squad_furlough
|
||||
|
||||
!# Enable squad globally or locally based on existing configuration
|
||||
!if [[ -f ./.squad_enabled ]]; then
|
||||
echo "📁 Enabling Claude Squad for current project"
|
||||
echo "CLAUDE_SQUAD_ENABLED=1" > ./.squad_enabled
|
||||
else
|
||||
echo "🌐 Enabling Claude Squad globally"
|
||||
mkdir -p ~/.claude
|
||||
echo "CLAUDE_SQUAD_ENABLED=1" > ~/.claude/.squad_enabled
|
||||
fi
|
||||
|
||||
Plugin status check:
|
||||
|
||||
!cat > ~/.claude/hooks/sessionStart.sh << 'EOF'
|
||||
#!/bin/bash
|
||||
|
||||
# SessionStart hook to load SQUAD.md orchestration rules
|
||||
# This hook runs at the beginning of each session and after /clear
|
||||
|
||||
# Check if squad is enabled
|
||||
if [ -f "$HOME/.claude/.squad_enabled" ]; then
|
||||
SQUAD_FILE="$HOME/.claude/SQUAD.md"
|
||||
|
||||
# Check if SQUAD.md exists
|
||||
if [ -f "$SQUAD_FILE" ]; then
|
||||
echo "🤖 Loading squad orchestration rules from SQUAD.md..."
|
||||
cat "$SQUAD_FILE"
|
||||
else
|
||||
echo "⚠️ Warning: SQUAD.md not found at $SQUAD_FILE"
|
||||
echo "Agent orchestration rules may not be properly configured."
|
||||
fi
|
||||
else
|
||||
echo "ℹ️ Squad functionality disabled. Use /squad-on to enable agent delegation."
|
||||
fi
|
||||
EOF
|
||||
|
||||
!chmod +x ~/.claude/hooks/sessionStart.sh
|
||||
|
||||
## Context Clearing
|
||||
|
||||
**⚠️ IMPORTANT**: To ensure proper squad activation, your current context should be cleared.
|
||||
|
||||
**Do you want to clear the context now?**
|
||||
|
||||
Respond with 'yes' to clear context and activate squad functionality, or 'no' to keep current context.
|
||||
|
||||
If you choose 'yes', the context will be cleared and squad functionality will be active in your next interaction.
|
||||
|
||||
## Squad Enabled Status
|
||||
|
||||
✅ **Squad functionality is now ENABLED**
|
||||
|
||||
- Agent delegation rules active
|
||||
- SQUAD.md will load on session start
|
||||
- Specialist routing available
|
||||
- Quality gates enforced
|
||||
|
||||
Use `/squad-off` to disable squad functionality if needed.
|
||||
74
commands/squad-override.md
Normal file
74
commands/squad-override.md
Normal file
@@ -0,0 +1,74 @@
|
||||
---
|
||||
description: Create local overrides for CLAUDE.md or specific agents
|
||||
argument-hint: [claude|agent] [agent-name]
|
||||
allowed-tools: Bash(*), Read(*), Write(*), Glob(*)
|
||||
---
|
||||
|
||||
# Squad Override - Local Configuration Override
|
||||
|
||||
Create local project overrides for CLAUDE.md or specific agents without affecting global configuration.
|
||||
|
||||
## Override Options
|
||||
|
||||
**Arguments**: $ARGUMENTS
|
||||
|
||||
Available override types:
|
||||
|
||||
1. **claude** - Override CLAUDE.md in current project
|
||||
2. **agent [name]** - Override specific agent in current project
|
||||
|
||||
## What Squad Override Does
|
||||
|
||||
Creates local `.claude/` configuration that takes precedence over global `~/.claude/` settings:
|
||||
|
||||
- **Local CLAUDE.md**: Project-specific rules and delegation patterns
|
||||
- **Local Agents**: Customized agent behavior for specific project needs
|
||||
- **Inheritance**: Local overrides global, preserving global as fallback
|
||||
|
||||
## Pre-Override Check
|
||||
|
||||
Check available templates and agents:
|
||||
|
||||
!echo "📦 Available templates:"
|
||||
!ls -la ~/.claude/templates/ 2>/dev/null || echo "❌ No templates found"
|
||||
|
||||
!echo "📦 Available agents for override:"
|
||||
!ls ~/.claude/disabled_agents/ 2>/dev/null | sed 's/\.md$//' | head -10 || echo "❌ No agents found"
|
||||
|
||||
## Override Type Analysis
|
||||
|
||||
Parse arguments to determine override type:
|
||||
|
||||
**Override Type**: $ARGUMENTS
|
||||
|
||||
- If contains "claude" → CLAUDE.md override
|
||||
- If contains "agent" → Agent override (requires agent name)
|
||||
- If no arguments → Show help and available options
|
||||
|
||||
## CLAUDE.md Override Process
|
||||
|
||||
If overriding CLAUDE.md:
|
||||
|
||||
1. Check if local `.claude/CLAUDE.md` already exists
|
||||
2. Warn about overwrite if present
|
||||
3. Copy `~/.claude/templates/CLAUDE.md` to `./claude/CLAUDE.md`
|
||||
4. Confirm local override created
|
||||
|
||||
## Agent Override Process
|
||||
|
||||
If overriding specific agent:
|
||||
|
||||
1. Validate agent name exists in `~/.claude/disabled_agents/`
|
||||
2. Create local `./claude/agents/` directory if needed
|
||||
3. Copy specified agent from disabled_agents to local agents
|
||||
4. Confirm agent override created
|
||||
|
||||
## Post-Override
|
||||
|
||||
After successful override:
|
||||
- Local configuration takes precedence
|
||||
- Original global configuration remains intact
|
||||
- Can revert by removing local `.claude/` directory
|
||||
- Use `/squad-dismiss --local` to remove local overrides
|
||||
|
||||
**🎯 Local override created! Project now uses custom configuration.**
|
||||
84
commands/squad-standdown.md
Normal file
84
commands/squad-standdown.md
Normal file
@@ -0,0 +1,84 @@
|
||||
---
|
||||
description: Temporarily disable squad for current session only (preserves permanent state)
|
||||
argument-hint:
|
||||
allowed-tools: Bash(*), Read(*), Write(*)
|
||||
---
|
||||
|
||||
# Squad Standdown - Temporary Session Disable
|
||||
|
||||
Temporarily disable squad functionality for the current session only, without affecting permanent installation.
|
||||
|
||||
## What Squad Standdown Does
|
||||
|
||||
1. **Creates session-only disable flag** (preserves permanent state)
|
||||
2. **Updates hook for current session** to skip SQUAD.md loading
|
||||
3. **Preserves permanent installation** for future sessions
|
||||
4. **Prompts for context clearing** to ensure clean state
|
||||
|
||||
## Implementation
|
||||
|
||||
Creating temporary session disable...
|
||||
|
||||
!echo "SESSION_DISABLE=$(date)" > ~/.claude/.squad_session_disabled
|
||||
|
||||
Updating session hook for temporary disable...
|
||||
|
||||
!cat > ~/.claude/hooks/sessionStart.sh << 'EOF'
|
||||
#!/bin/bash
|
||||
|
||||
# SessionStart hook to load SQUAD.md orchestration rules
|
||||
# This hook runs at the beginning of each session and after /clear
|
||||
|
||||
# Check for session-only disable first
|
||||
if [ -f "$HOME/.claude/.squad_session_disabled" ]; then
|
||||
echo "⏸️ Squad temporarily disabled for this session."
|
||||
echo "Use /squad-on to re-enable for this session."
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# Check if squad is enabled
|
||||
if [ -f "$HOME/.claude/.squad_enabled" ]; then
|
||||
SQUAD_FILE="$HOME/.claude/SQUAD.md"
|
||||
|
||||
# Check if SQUAD.md exists
|
||||
if [ -f "$SQUAD_FILE" ]; then
|
||||
echo "🤖 Loading squad orchestration rules from SQUAD.md..."
|
||||
cat "$SQUAD_FILE"
|
||||
else
|
||||
echo "⚠️ Warning: SQUAD.md not found at $SQUAD_FILE"
|
||||
echo "Agent orchestration rules may not be properly configured."
|
||||
fi
|
||||
else
|
||||
echo "ℹ️ Squad functionality disabled. Use /squad-on to enable agent delegation."
|
||||
fi
|
||||
EOF
|
||||
|
||||
!chmod +x ~/.claude/hooks/sessionStart.sh
|
||||
|
||||
## Session State Check
|
||||
|
||||
!echo "🔍 Current State:"
|
||||
!echo "✅ Permanent state: $([ -f ~/.claude/.squad_enabled ] && echo 'Preserved' || echo 'Not installed')"
|
||||
!echo "⏸️ Session disable: $([ -f ~/.claude/.squad_session_disabled ] && echo 'Active' || echo 'Inactive')"
|
||||
|
||||
## Context Clearing
|
||||
|
||||
**⚠️ IMPORTANT**: To ensure proper squad standdown, your current context should be cleared.
|
||||
|
||||
**Do you want to clear the context now?**
|
||||
|
||||
Respond with 'yes' to clear context and deactivate squad for this session, or 'no' to keep current context.
|
||||
|
||||
If you choose 'yes', the context will be cleared and you'll interact directly with Claude without agent delegation for this session only.
|
||||
|
||||
## Squad Standdown Status
|
||||
|
||||
⏸️ **Squad functionality is now in STANDDOWN (session-only)**
|
||||
|
||||
- No agent delegation for this session
|
||||
- Direct Claude interaction until next session
|
||||
- Permanent installation preserved
|
||||
- Will automatically re-enable in new sessions
|
||||
|
||||
Use `/squad-on` to re-enable for current session.
|
||||
Use `/squad-dismiss` to permanently remove squad functionality.
|
||||
65
commands/squad-status.md
Normal file
65
commands/squad-status.md
Normal file
@@ -0,0 +1,65 @@
|
||||
---
|
||||
description: Check current squad functionality status
|
||||
argument-hint:
|
||||
allowed-tools: Bash(*)
|
||||
---
|
||||
|
||||
# Squad Status - Check Current State
|
||||
|
||||
Check whether squad functionality is currently enabled or disabled.
|
||||
|
||||
## Current Squad Status
|
||||
|
||||
!# Check for session disable first
|
||||
!if [ -f "$HOME/.claude/.squad_session_disabled" ]; then
|
||||
echo "⏸️ **Squad Status: STANDDOWN (Session Disabled)**"
|
||||
echo ""
|
||||
echo "- Temporarily disabled for this session only"
|
||||
echo "- Permanent installation preserved"
|
||||
echo "- Will re-enable in new sessions"
|
||||
echo ""
|
||||
echo "Use \`/squad-on\` to re-enable for current session"
|
||||
!elif [ -f "$HOME/.claude/.squad_furlough" ]; then
|
||||
echo "🏖️ **Squad Status: FURLOUGH (Orchestrator Disabled)**"
|
||||
echo ""
|
||||
echo "- Orchestrator disabled (no automatic delegation)"
|
||||
echo "- Agents available for direct Task() invocation"
|
||||
echo "- Manual specialist access maintained"
|
||||
echo ""
|
||||
echo "Use \`/squad-on\` to re-enable full orchestration"
|
||||
!elif [ -f "$HOME/.claude/.squad_enabled" ]; then
|
||||
echo "✅ **Squad Status: ENABLED**"
|
||||
echo ""
|
||||
echo "- Agent delegation active"
|
||||
echo "- SQUAD.md loads on session start"
|
||||
echo "- Quality gates enforced"
|
||||
echo "- Specialist routing available"
|
||||
echo ""
|
||||
echo "Use \`/squad-off\` or \`/squad-standdown\` to disable"
|
||||
!else
|
||||
echo "❌ **Squad Status: DISABLED**"
|
||||
echo ""
|
||||
echo "- Direct Claude interaction"
|
||||
echo "- No agent delegation"
|
||||
echo "- SQUAD.md will not load"
|
||||
echo "- Quality gates inactive"
|
||||
echo ""
|
||||
echo "Use \`/squad-on\` or \`/squad-assemble\` to enable"
|
||||
!fi
|
||||
|
||||
## Available Commands
|
||||
|
||||
### Core Commands
|
||||
- `/squad-assemble` - Permanently install squad functionality
|
||||
- `/squad-dismiss` - Permanently uninstall squad functionality
|
||||
- `/squad-on` - Enable squad functionality
|
||||
- `/squad-off` - Disable squad functionality
|
||||
|
||||
### Temporary Commands
|
||||
- `/squad-standdown` - Temporarily disable for session only
|
||||
- `/squad-furlough` - Disable orchestrator, keep agents available
|
||||
|
||||
### Management Commands
|
||||
- `/squad-deploy` - Deploy squad infrastructure
|
||||
- `/squad-status` - Check current status
|
||||
- `/squad-override` - Override settings
|
||||
Reference in New Issue
Block a user