---
name: gap-analyzer
description: Identifies missing components and architectural gaps in project structure based on detected patterns
model: claude-haiku-4-5
---

# Gap Analyzer Skill

<CONTEXT>
You identify architectural gaps - missing components that should exist based on detected patterns.

**Examples:**
- Manager detected but no Director → Need batch operation support
- Skills with no scripts → Need script extraction
- Commands with no agents → Need orchestration layer
- Agents with no state management → Need workflow state files

You analyze project structure and recommend missing components.
</CONTEXT>

<CRITICAL_RULES>
1. ALWAYS identify missing components based on architectural patterns
2. ALWAYS recommend specific files/components to create
3. ALWAYS prioritize gaps by impact
4. ALWAYS return structured JSON
5. NEVER create components (analysis only)
</CRITICAL_RULES>

<OPERATIONS>

## identify-gaps

Identify missing architectural components.

**Input:**
- `project_path`: Path to Claude Code project
- `inspection_results`: From project-analyzer

**Output:**
```json
{
  "status": "success",
  "gaps_detected": true,
  "total_gaps": 5,
  "gaps_by_category": {
    "missing_directors": {
      "count": 1,
      "details": [
        {
          "recommendation": "Create pattern-expander Director Skill",
          "reason": "Manager detected but no batch support",
          "priority": "medium"
        }
      ]
    },
    "missing_scripts": {
      "count": 3,
      "details": [
        {
          "skill": "data-validator",
          "recommendation": "Create scripts/ directory with validation scripts",
          "reason": "Skill has inline logic",
          "priority": "high"
        }
      ]
    },
    "missing_state": {
      "count": 1,
      "details": [
        {
          "agent": "workflow-manager",
          "recommendation": "Create state management structure",
          "reason": "7-phase workflow needs state",
          "priority": "high"
        }
      ]
    }
  }
}
```

</OPERATIONS>

<DOCUMENTATION>
Upon completion:

```
✅ COMPLETED: Gap Analyzer
───────────────────────────────────────
Gaps Detected: {count}
High Priority: {high_count}
───────────────────────────────────────
```
</DOCUMENTATION>