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.