code-communities

# Code Community Detection Identify architectural clusters and module boundaries in the codebase. ## Prerequisites This skill requires the **gauntlet** plugin for graph data. Discover it: ```bash GRAPH_QUERY=$(find ~/.claude/plugins -name "graph_query.py" -path "*/gauntlet/*" 2>/dev/null | head -1) ``` **If gauntlet is not installed**: Fall back to directory structure analysis. Group files by directory and use import statements to identify module boundaries. Generate a Mermaid diagram from directory-level relationships. **If installed but no graph.db**: Tell the user to run `/gauntlet-graph build`. ## Steps 1. **Run community detection** (requires gauntlet): ```bash python3 "$GRAPH_QUERY" --action communities ``` **Fallback (no gauntlet)**: Analyze directory structure and cross-directory imports: ```bash # Directory-level grouping find . -name "*.py" -not -path "*/node_modules/*" | \ sed 's|/[^/]*$||' | sort | uniq -c | sort -rn # Cross-directory imports (rg preferred, grep fallback) if command -v rg &>/dev/null; then rg "^from |^import " --type py -l . | \ xargs -I{} rg "^from \w+ import|^import \w+" {} --no-filename else grep -rh "^from \|^import " --include="*.py" . fi | sort | uniq -c | sort -rn | head -20 ``` Group by top-level directories and count cross-directory imports to estimate coupling. 2. **Display clusters**: ``` Community | Nodes | Cohesion | Description auth ...