automagik-cli: Command for Claude Code

/clean

---

allowed-tools: Task(), Read(), Bash(), Glob(), Grep(), mcp__zen__, mcp__search-repo-docs__, mcp__ask-repo-agent__, mcp__genie_memory__, mcp__send_whatsapp_message__, mcp__wait__* description: Safely identify and remove dead code, unused files, and obsolete artifacts

Comprehensive dead code detection with triple-verification safety system using multiple expert agents and LLM consultation.

Auto-Loaded Project Context:

@/CLAUDE.md @/docs/ai-context/project-structure.md @/docs/ai-context/docs-overview.md

Usage

# Full codebase cleanup
/clean "Find all dead code and unused files"

# Specific directory cleanup
/clean "Clean unused files in agents/ directory"

# Target specific patterns
/clean "Remove old migration files and backups"

# Focus on specific file types
/clean "Find unused TypeScript interfaces and types"

⚠️ CRITICAL SAFETY NOTICE

This command can permanently delete files. It employs:

• Triple-verification system with independent agents
• Multi-LLM consensus via Gemini consultation
• Memory-based pattern validation
• WhatsApp notifications before any deletion
• Mandatory user confirmation for all deletions

Intelligent Cleanup Strategy

Step 1: Scope Analysis

Parse user request: "$ARGUMENTS"

Cleanup Categories:

• Unused Code → Functions, classes, variables never referenced
• Orphan Files → Files not imported/required anywhere
• Old Artifacts → Backups, migrations, temporary files
• Dead Dependencies → Unused npm packages, imports
• Obsolete Tests → Tests for deleted code
• Stale Documentation → Docs for removed features

Step 2: Parallel Detection Phase

Deploy 8-10 specialized detection agents in parallel:

Wave 1: Discovery Agents (Parallel)

Task: "As [Agent_Role], identify potential dead code in [assigned_area] for request '$ARGUMENTS'"

Agent 1: Import_Analyzer
- Trace all import/export relationships
- Build dependency graph
- Identify orphan files with no imports
- Find circular dependencies

Agent 2: Reference_Hunter  
- Search for function/class/variable usage
- Track method calls across codebase
- Identify unreferenced exports
- Find dead event handlers

Agent 3: Pattern_Detective
- Identify naming patterns (*.old, *.backup, *.tmp)
- Find commented-out code blocks
- Detect TODO/FIXME markers for removed features
- Locate deprecated API usage

Agent 4: Test_Validator
- Map tests to implementation files
- Find tests for non-existent code
- Identify outdated test fixtures
- Check test coverage gaps

Agent 5: Documentation_Auditor
- Cross-reference docs with code
- Find documentation for deleted features
- Identify broken links and references
- Check API doc accuracy

Agent 6: Build_Artifact_Scanner
- Check build outputs and dist folders
- Find generated files without sources
- Identify stale build configurations
- Detect unused webpack chunks

Agent 7: Git_History_Analyst
- Analyze file modification patterns
- Find files unchanged for >6 months
- Identify abandoned feature branches
- Track file deletion patterns

Agent 8: Configuration_Inspector
- Check for unused config files
- Find environment variables never read
- Identify obsolete feature flags
- Detect dead deployment configs

CRITICAL: Each agent must return:
1. List of deletion candidates with confidence scores
2. Evidence for why each file/code is dead
3. Potential risks if deleted
4. Dependencies that might break