Skip to main content

​
Usage

archal scenario <subcommand> [options]

​
Subcommands

​
scenario list

List scenarios in a directory. 
archal scenario list
archal scenario list -d ./my-scenarios
archal scenario list --tag security
archal scenario list --difficulty hard
FlagDescriptionDefault
-d, --dir <path>Directory to search./scenarios
--localOnly show local scenarios (skip remote fetch)false
--tag <tag>Filter scenarios by tag—
--difficulty <level>Filter by difficulty (easy, medium, hard)—
Shows each scenario’s title, file path, criteria count, and required twins.

​
scenario validate <file>

Parse and validate a scenario file. Checks that all required sections exist and criteria are properly tagged. 
archal scenario validate scenarios/github/close-stale-issues.md

​
scenario lint <file>

Run quality checks on a scenario before executing it. Catches issues that validate doesn’t — like setup descriptions that are too vague for reliable seed generation. 
archal scenario lint scenarios/github/close-stale-issues.md
archal scenario lint scenarios/my-scenario.md --seedability
FlagDescriptionDefault
--seedabilityValidate that the setup section has enough detail for dynamic seed generationfalse

​
scenario create <name>

Scaffold a new scenario file with the correct structure. 
archal scenario create my-new-scenario
archal scenario create my-scenario --dir ./scenarios --twins github,slack
FlagDescriptionDefault
--dir <path>Directory to create the file in./scenarios
--twins <names>Pre-fill the Config section with these twins (comma-separated)github
--twin <name>Alias for --twins (single twin)—