One-click install
npx skills add https://github.com/snewhouse/aa-ma-forge --skill complexity-router-snewhouse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: complexity-router
Source: https://github.com/snewhouse/aa-ma-forge/tree/main/claude-code/skills/complexity-router
Command: npx skills add https://github.com/snewhouse/aa-ma-forge --skill complexity-router-snewhouse

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents an AI agent from running full plans on high-risk or system-impacting work that needs extra architectural scrutiny, reducing rework and missed constraints.

Core Features & Use Cases

  • Quantifies task complexity using a weighted scoring model across scope, architectural impact, technical risk, dependencies, and uncertainty.
  • Auto-detects critical scenarios and forces complexity to at least 80% when high-leverage triggers are present (e.g., auth changes, schema migrations, breaking API contracts, security-critical features).
  • Routes workflow rigorously by selecting Standard, Enhanced, or Critical (deep architectural review) thresholds, and generating a decision report for provenance logging.

Use cases: before plan generation in a multi-phase workflow, when deciding the appropriate validation depth, or when determining whether a task requires a human/dedicated architecture review.

Quick Start

Use the complexity-router skill to score and route the next task before plan generation, ensuring anything at or above 80% triggers deep architectural review.

Frequently Asked Questions about complexity-router

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I estimate task complexity to trigger deep architectural review?

Estimating task complexity involves scoring scope, architectural impact, technical risk, dependencies, and uncertainty. This skill applies a weighted 0-100 scoring model to quantify task complexity and automatically routes high-scoring work to deep architectural review.

When should I route high-risk tasks to enhanced validation gates?

You should route high-risk tasks to enhanced validation gates when auto-detected critical scenarios are present. Auth changes, schema migrations, breaking API contracts, and security-critical features automatically force complexity scores to at least 80%, triggering rigorous workflow validation.

What is the best way to automate task routing in a multi-phase workflow?

Automating task routing in a multi-phase workflow requires deterministic threshold-based logic. This skill selects Standard, Enhanced, or Critical validation depths based on weighted factor scoring and generates a structured routing report for provenance logging during plan generation.

Does complexity scoring work for multi-session agent workflow planning?

Yes, complexity scoring works for multi-session agent workflow planning by applying during multi-phase plan generation. It evaluates tasks before execution to decide whether they receive standard validation, enhanced validation, or critical ultrathinking-level architectural review.

Why does my AI agent miss constraints on system-impacting architectural changes?

AI agents miss constraints on system-impacting changes when high-risk work bypasses architectural scrutiny. Without automated complexity estimation and threshold-based routing to deep architectural review, agents run full plans on tasks needing extra validation, causing rework.