AC Complexity Assessor

Assess complexity for effort estimation and planning.

Purpose

Analyzes features and projects to determine complexity levels, estimate effort, and select appropriate processing pipelines.

Quick Start

from scripts.complexity_assessor import ComplexityAssessor

assessor = ComplexityAssessor(project_dir)
assessment = await assessor.assess_project()
print(assessment.pipeline_type)  # SIMPLE/STANDARD/COMPLEX
print(assessment.estimated_hours)

Assessment Output

{
  "project_complexity": "STANDARD",
  "pipeline_type": "STANDARD",
  "metrics": {
    "total_features": 75,
    "dependency_depth": 4,
    "category_count": 8,
    "integration_points": 5,
    "technology_complexity": 3
  },
  "estimates": {
    "total_hours": 120,
    "estimated_cost_usd": 45.00,
    "estimated_sessions": 15,
    "features_per_session": 5
  },
  "feature_estimates": [
    {
      "id": "auth-001",
      "complexity": "low",
      "estimated_hours": 1.5,
      "factors": ["standard_pattern", "no_dependencies"]
    }
  ],
  "recommendations": [
    "Consider parallelizing UI features",
    "auth-003 may need more time due to OAuth"
  ]
}

Complexity Levels

SIMPLE (1-3 phases)

• < 20 features
• Shallow dependencies (depth < 2)
• Single technology
• No external integrations

STANDARD (7 phases)

• 20-100 features
• Moderate dependencies (depth 2-5)
• 2-3 technologies
• Limited integrations

COMPLEX (8+ phases)

• 100 features

• Deep dependencies (depth > 5)
• Multiple technologies
• Many integrations

Complexity Factors

Feature Complexity

• Implementation difficulty
• Test complexity
• Documentation needs
• Integration requirements

Project Complexity

• Total feature count
• Dependency graph depth
• Technology stack breadth
• External integrations

Risk Factors

• Unfamiliar technologies
• Complex algorithms
• Security requirements
• Performance constraints

Pipeline Selection

SIMPLE Pipeline:
  1. Plan → 2. Implement → 3. Verify

STANDARD Pipeline:
  1. Analyze → 2. Plan → 3. Test Design
  4. Implement → 5. Test → 6. Review → 7. Verify

COMPLEX Pipeline:
  1. Deep Analyze → 2. Architecture → 3. Plan
  4. Test Design → 5. Implement → 6. Test
  7. Integration → 8. Review → 9. Verify

Cost Estimation

cost = (features * avg_tokens_per_feature * cost_per_token)
     + (sessions * session_overhead)
     + (complexity_multiplier * base_cost)

API Reference

See scripts/complexity_assessor.py for full implementation.