complexity-analyzer

name	complexity-analyzer
description	Analyzes task/feature complexity (1-10) and recommends subtask breakdown for planning and prioritization. Provides actionable recommendations for agent selection, phase distribution, and risk assessment. Silent analysis that feeds into other workflows.
inputs	[{"from":"any","field":"task_description","required":true},{"from":"any","field":"metadata","required":false}]
outputs	[{"field":"complexity_score","type":"number"},{"field":"recommended_subtasks","type":"number"},{"field":"phase_distribution","type":"object"},{"field":"analysis_report","type":"file_path"}]
next_skills	["pop-writing-plans","pop-brainstorming","pop-executing-plans"]
workflow	{"id":"complexity-analysis","name":"Complexity Analysis Workflow","version":1,"description":"Analyze task complexity and provide recommendations","steps":[{"id":"extract_context","description":"Extract task description and metadata","type":"analysis","next":"calculate_complexity"},{"id":"calculate_complexity","description":"Calculate complexity score and factors","type":"analysis","next":"generate_recommendations"},{"id":"generate_recommendations","description":"Generate subtask and phase recommendations","type":"analysis","next":"output_results"},{"id":"output_results","description":"Output analysis results","type":"output","next":"complete"},{"id":"complete","description":"Analysis complete","type":"terminal"}]}

Complexity Analysis Engine

Overview

Analyzes task and feature complexity using multiple factors to provide 1-10 scoring with actionable recommendations. This is a foundational skill used by other PopKit workflows.

Automatic integration: This skill is automatically invoked by planning workflows, PRD parsers, and agent routers. It operates silently in the background to provide complexity intelligence.

Complexity Scoring (1-10)

Score	Level	Description	Example
1-2	Trivial	Single file, minimal changes	Fix typo, update constant
3-4	Simple	Few files, straightforward logic	Add button, update styling
5-6	Moderate	Multiple files, some complexity	Add form validation, API endpoint
7-8	Complex	Architecture changes, high impact	Refactor module, add auth system
9-10	Very Complex	System-wide changes, high risk	Migrate architecture, redesign core

Complexity Factors

The analyzer evaluates 8 factors with configurable weights:

Factor	Weight	Description
Files Affected	15%	Number of files that need changes
LOC Estimate	15%	Estimated lines of code
Dependencies	15%	External/internal dependencies
Architecture Change	20%	Impact on system architecture
Breaking Changes	15%	Compatibility impact
Testing Complexity	10%	Testing requirements
Security Impact	5%	Security considerations
Integration Points	5%	External integrations

Usage Patterns

1. Automatic Analysis (Preferred)

Complexity analysis is automatically performed when you use development workflows:

/popkit:dev