{
  "subagents": {
    "core": {
      "python-quality-analyst": {
        "file": "core/python-quality-analyst.json",
        "description": "Advanced Python code quality analysis with ruff, pyright, and modern tooling",
        "capabilities": ["linting", "formatting", "type-checking", "security-analysis"],
        "collaborates_with": ["test-architect", "dependency-manager", "performance-optimizer"]
      },
      "dependency-manager": {
        "file": "core/dependency-manager.json", 
        "description": "UV-based dependency management, virtual environments, and package optimization",
        "capabilities": ["dependency-resolution", "environment-management", "security-scanning"],
        "collaborates_with": ["python-quality-analyst", "container-architect", "security-auditor"]
      },
      "performance-optimizer": {
        "file": "core/performance-optimizer.json",
        "description": "Python performance analysis, profiling, and optimization recommendations",
        "capabilities": ["profiling", "bottleneck-analysis", "memory-optimization", "async-optimization"],
        "collaborates_with": ["python-quality-analyst", "test-architect", "monitoring-specialist"]
      }
    },
    "testing": {
      "test-architect": {
        "file": "testing/test-architect.json",
        "description": "BDD test design, Behave scenario creation, and testing strategy",
        "capabilities": ["bdd-design", "scenario-writing", "test-strategy", "coverage-analysis"],
        "collaborates_with": ["hypothesis-fuzzer", "test-executor", "quality-gatekeeper"]
      },
      "hypothesis-fuzzer": {
        "file": "testing/hypothesis-fuzzer.json",
        "description": "Property-based testing with Hypothesis, edge case discovery, and fuzz testing",
        "capabilities": ["property-testing", "fuzz-generation", "edge-case-discovery", "test-amplification"],
        "collaborates_with": ["test-architect", "test-executor", "python-quality-analyst"]
      },
      "test-executor": {
        "file": "testing/test-executor.json",
        "description": "Nox-based test execution, multi-version testing, and CI/CD integration",
        "capabilities": ["test-execution", "multi-version-testing", "parallel-execution", "result-analysis"],
        "collaborates_with": ["test-architect", "hypothesis-fuzzer", "ci-cd-orchestrator"]
      },
      "quality-gatekeeper": {
        "file": "testing/quality-gatekeeper.json",
        "description": "Quality gate enforcement, pre-commit integration, and release readiness",
        "capabilities": ["quality-gates", "pre-commit-management", "release-validation", "compliance-checking"],
        "collaborates_with": ["python-quality-analyst", "test-executor", "security-auditor"]
      }
    },
    "deployment": {
      "container-architect": {
        "file": "deployment/container-architect.json",
        "description": "Docker/DevContainer optimization, multi-stage builds, and security hardening",
        "capabilities": ["container-design", "multi-stage-optimization", "security-hardening", "size-optimization"],
        "collaborates_with": ["kubernetes-specialist", "security-auditor", "dependency-manager"]
      },
      "kubernetes-specialist": {
        "file": "deployment/kubernetes-specialist.json",
        "description": "Kubernetes deployment, Helm charts, HPA, and production readiness",
        "capabilities": ["k8s-deployment", "helm-charts", "autoscaling", "service-mesh"],
        "collaborates_with": ["container-architect", "monitoring-specialist", "security-auditor"]
      },
      "ci-cd-orchestrator": {
        "file": "deployment/ci-cd-orchestrator.json",
        "description": "Forgejo Actions, pipeline optimization, and deployment automation",
        "capabilities": ["pipeline-design", "deployment-automation", "branch-strategies", "artifact-management"],
        "collaborates_with": ["test-executor", "container-architect", "quality-gatekeeper"]
      }
    },
    "docs": {
      "documentation-architect": {
        "file": "docs/documentation-architect.json",
        "description": "MkDocs Material, API documentation, and technical writing",
        "capabilities": ["docs-structure", "api-docs", "technical-writing", "versioning"],
        "collaborates_with": ["api-specialist", "test-architect", "user-experience-designer"]
      },
      "api-specialist": {
        "file": "docs/api-specialist.json",
        "description": "FastAPI/Click integration, OpenAPI specs, and API design patterns",
        "capabilities": ["api-design", "openapi-specs", "endpoint-optimization", "validation-design"],
        "collaborates_with": ["documentation-architect", "python-quality-analyst", "security-auditor"]
      }
    },
    "monitoring": {
      "monitoring-specialist": {
        "file": "monitoring/monitoring-specialist.json",
        "description": "Prometheus metrics, Grafana dashboards, and observability patterns",
        "capabilities": ["metrics-design", "dashboard-creation", "alerting-rules", "sli-slo-design"],
        "collaborates_with": ["kubernetes-specialist", "performance-optimizer", "incident-responder"]
      },
      "security-auditor": {
        "file": "monitoring/security-auditor.json",
        "description": "Security scanning, vulnerability assessment, and compliance monitoring",
        "capabilities": ["security-scanning", "vulnerability-assessment", "compliance-checking", "threat-modeling"],
        "collaborates_with": ["container-architect", "dependency-manager", "quality-gatekeeper"]
      },
      "incident-responder": {
        "file": "monitoring/incident-responder.json",
        "description": "Log analysis, debugging assistance, and production issue resolution",
        "capabilities": ["log-analysis", "debugging", "root-cause-analysis", "remediation-planning"],
        "collaborates_with": ["monitoring-specialist", "kubernetes-specialist", "performance-optimizer"]
      }
    },
    "orchestration": {
      "project-coordinator": {
        "file": "orchestration/project-coordinator.json",
        "description": "High-level project coordination, task delegation, and workflow orchestration",
        "capabilities": ["task-coordination", "subagent-orchestration", "workflow-management", "decision-making"],
        "collaborates_with": ["all-subagents"],
        "is_orchestrator": true
      },
      "feature-delivery-manager": {
        "file": "orchestration/feature-delivery-manager.json",
        "description": "End-to-end feature delivery, from conception to production deployment",
        "capabilities": ["feature-planning", "cross-team-coordination", "delivery-tracking", "stakeholder-communication"],
        "collaborates_with": ["project-coordinator", "test-architect", "ci-cd-orchestrator"],
        "is_orchestrator": true
      }
    },
    "workflows": {
      "code-review-assistant": {
        "file": "workflows/code-review-assistant.json",
        "description": "Comprehensive code review, best practices enforcement, and mentoring",
        "capabilities": ["code-review", "best-practices", "mentoring", "security-review"],
        "collaborates_with": ["python-quality-analyst", "security-auditor", "test-architect"]
      },
      "refactoring-specialist": {
        "file": "workflows/refactoring-specialist.json",
        "description": "Code refactoring, architecture improvements, and technical debt management",
        "capabilities": ["refactoring", "architecture-improvement", "debt-analysis", "migration-planning"],
        "collaborates_with": ["python-quality-analyst", "test-architect", "performance-optimizer"]
      },
      "user-experience-designer": {
        "file": "workflows/user-experience-designer.json",
        "description": "CLI UX design, developer experience optimization, and usability testing",
        "capabilities": ["ux-design", "cli-optimization", "developer-experience", "usability-testing"],
        "collaborates_with": ["api-specialist", "documentation-architect", "test-architect"]
      }
    }
  },
  "interaction_patterns": {
    "quality_pipeline": [
      "python-quality-analyst",
      "test-architect", 
      "quality-gatekeeper"
    ],
    "deployment_pipeline": [
      "container-architect",
      "kubernetes-specialist",
      "ci-cd-orchestrator",
      "monitoring-specialist"
    ],
    "feature_development": [
      "project-coordinator",
      "test-architect",
      "python-quality-analyst",
      "api-specialist",
      "documentation-architect"
    ],
    "incident_response": [
      "incident-responder",
      "monitoring-specialist",
      "kubernetes-specialist",
      "security-auditor"
    ],
    "performance_optimization": [
      "performance-optimizer",
      "monitoring-specialist",
      "test-architect",
      "kubernetes-specialist"
    ]
  }
}