<quick_start>
/apex add authentication middleware # Basic
/apex -a -s implement user registration # Autonomous + save
/apex -a -x -s fix login bug # With adversarial review
/apex -a -m implement full auth system # Agent Teams (parallel)
/apex -a -x -s -t add auth middleware # Full workflow with tests
/apex -a -pr add auth middleware # With PR creation
/apex -r 01-auth-middleware # Resume previous task
/apex -e add auth middleware # Economy mode (save tokens)
/apex -i add auth middleware # Interactive flag config
</quick_start>
| ON | OFF | Long | Description |
|---|---|---|---|
-a | -A | --auto | Skip confirmations, auto-approve |
-x | -X | --examine | Adversarial code review |
-s | -S | --save | Save outputs to .claude/output/apex/ |
-t | -T | --test | Include test creation + runner |
-e | -E | --economy | No subagents, save tokens |
-b | -B | --branch | Verify not on main, create branch |
-pr | -PR | --pull-request | Create PR at end (enables -b) |
-i | --interactive | Configure flags via menu | |
-k | -K | --tasks | Task breakdown with dependencies |
-m | -M | --teams | Agent Teams parallel execution (enables -k) |
-r | --resume | Resume from previous task ID |
Parsing: Defaults from steps/step-00-init.md, flags override, remainder = {task_description}, ID = NN-kebab-case.
<step_files>
| Step | File | Purpose |
|---|---|---|
| 00 | steps/step-00-init.md | Parse flags, initialize state |
| 00b | steps/step-00b-save.md | Setup save output structure (if -s) |
| 00b | steps/step-00b-branch.md | Git branch setup (if -b) |
| 00b | steps/step-00b-economy.md | Economy mode overrides (if -e) |
| 00b | steps/step-00b-interactive.md | Interactive flag config (if -i) |
| 01 | steps/step-01-analyze.md | Smart context gathering |
| 02 | steps/step-02-plan.md | File-by-file plan + TaskList |
| 02b | steps/step-02b-tasks.md | Task breakdown (if -k/-m) |
| 03 | steps/step-03-execute.md | Todo-driven implementation |
| 03t | steps/step-03-execute-teams.md | Agent Team execution (if -m) |
| 04 | steps/step-04-validate.md | Self-check and validation |
| 05 | steps/step-05-examine.md | Adversarial code review |
| 06 | steps/step-06-resolve.md | Finding resolution |
| 07 | steps/step-07-tests.md | Test analysis and creation |
| 08 | steps/step-08-run-tests.md | Test runner loop |
| 09 | steps/step-09-finish.md | Create pull request |
</step_files>
<state_variables>
| Variable | Type | Set by |
|---|---|---|
{task_description} | string | step-00 |
{feature_name} | string | step-00 |
{task_id} | string | step-00 / step-00b-save |
{acceptance_criteria} | list | step-01 |
{auto_mode} | boolean | step-00 |
{examine_mode} | boolean | step-00 |
{save_mode} | boolean | step-00 |
{test_mode} | boolean | step-00 |
{economy_mode} | boolean | step-00 |
{branch_mode} | boolean | step-00 |
{pr_mode} | boolean | step-00 |
{tasks_mode} | boolean | step-00 |
{teams_mode} | boolean | step-00 |
{output_dir} | string | step-00b-save |
{branch_name} | string | step-00b-branch |
</state_variables>
<execution_rules>
- Load one step at a time (progressive loading)
- ULTRA THINK before major decisions
- Persist state variables across all steps
- Follow next_step directive at end of each step
- Save outputs if
{save_mode}= true (each step appends to its file) - Use parallel agents for independent exploration (step-01) </execution_rules>
<entry_point>
FIRST ACTION: Load steps/step-00-init.md
</entry_point>