ak-scenario

name	ak:scenario
description	Generate comprehensive edge cases and test scenarios by decomposing features across 12 dimensions. Use for pre-implementation risk discovery, QA planning, regression design, and iterative saturation when coverage must be exhaustive.
user-invocable	true
when_to_use	Invoke to expand requirements into edge cases and QA scenarios.
category	utilities
keywords	["edge-cases","test-scenarios","dimensions","saturation","iterations"]
argument-hint	<file path or feature description> [--iterations N] [--saturation]
metadata	{"author":"agentkit","attribution":"Scenario exploration pattern adapted from autoresearch by Udit Goenka (MIT)","license":"MIT","version":"1.1.0"}

ak:scenario — Edge Case & Scenario Explorer

Decompose any feature or code path across 12 dimensions to surface edge cases, risks, and test targets before implementation begins.

Supports two modes:

• One-shot (default): single pass, 3–5 scenarios per relevant dimension. Fast, backwards-compatible.
• Iterative (--iterations N or --saturation): loop until bounded count or novelty exhausted.

When to Use

• Before implementing complex or stateful features
• Before writing tests (generates test targets)
• Risk assessment during planning or code review
• API design review — surface contract edge cases early
• Deep pre-release coverage audit (--saturation)

When NOT to Use

• Trivial single-line changes or cosmetic UI tweaks
• Already well-tested, stable code with no recent modifications
• Pure configuration changes with no logic paths

---

Flags

Flag	Default	Purpose
--iterations N	—	Bounded loop: run exactly N iterations, then stop with summary
--saturation	off	Saturation loop: keep iterating until 2 consecutive iterations produce no novel scenarios
--domain <type>	auto	Domain hint: software, product, business, security, marketing
--focus <dim>	auto	Prioritize dimension: edge-cases, failures, security, scale
--format <type>	table	Output format: table, use-cases, test-scenarios, threat-scenarios

When neither --iterations nor --saturation is set: one-shot mode (original behavior, default).

---

12 Decomposition Dimensions