jmagly/execution-mode

Execution Mode

You set or report the reproducibility mode that governs how AIWG workflows execute, controlling determinism constraints from none (standard) to fully auditable (audit).

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

• "make runs deterministic" → set strict mode
• "pin the seed" → set seeded mode with provided seed value
• "what mode are we in" → report current execution mode
• "reset to default" → set standard mode
• "enable audit logging" → set audit mode

Trigger Patterns Reference

| Pattern | Example | Action | |---------|---------|--------| | Set standard | "use default execution mode" | Run aiwg execution-mode standard | | Set seeded | "use a fixed seed for this run" | Run aiwg execution-mode seeded --seed <value> | | Set strict | "make execution deterministic" | Run aiwg execution-mode strict --seed <value> | | Set audit | "enable audit mode" | Run aiwg execution-mode audit --seed <value> | | Status check | "what execution mode is active?" | Run aiwg execution-mode (no args) | | Seed only | "set seed to 42" | Run aiwg execution-mode seeded --seed 42 |

Behavior

When triggered:

1. Extract intent:

   • Is this a status check or a mode change?
   • Which mode is requested: standard, seeded, strict, or audit?
   • Is a --seed value provided or should one be generated?

2. Run the appropriate command:

   # Report current mode (no args)
   aiwg execution-mode
   
   # Standard — no reproducibility constraints
   aiwg execution-mode standard
   
   # Seeded — fixed random seed for all operations
   aiwg execution-mode seeded --seed 42
   
   # Strict — seeded + no external calls + pinned versions
   aiwg execution-mode strict --seed 42
   
   # Audit — strict + decision logging for replay
   aiwg execution-mode audit --seed 42
   

3. Mode summary:

   | Mode | Seed | External calls | Pinned versions | Decision log | |------|------|----------------|-----------------|--------------| | standard | No | Allowed | No | No | | seeded | Yes | Allowed | No | No | | strict | Yes | Blocked | Yes | No | | audit | Yes | Blocked | Yes | Yes |

4. Persistence: Mode is written to .aiwg/execution-mode.json and persists across sessions until explicitly changed.

5. Report the result — confirm the mode that is now active and note any implications (e.g., external calls will be blocked in strict/audit mode).

Examples

Example 1: Status check

User: "What execution mode are we in?"

Extraction: Status check, no change requested

Action:

aiwg execution-mode

Response: "Current execution mode: seeded (seed: 1234). External calls are allowed and versions are not pinned. To increase determinism, switch to strict or audit mode."

Example 2: Enable strict mode

User: "Make the workflow fully deterministic with seed 42"

Extraction: Strict mode requested, seed 42 provided

Action:

aiwg execution-mode strict --seed 42

Response: "Execution mode set to strict with seed 42. External network calls are blocked and dependency versions are pinned. Mode saved to .aiwg/execution-mode.json."

Example 3: Enable audit mode for compliance

User: "Enable audit mode so we can replay every decision"

Extraction: Audit mode requested, no seed provided — generate one

Action:

aiwg execution-mode audit --seed 7391

Response: "Execution mode set to audit with seed 7391. All decisions will be logged for replay. Seed chosen automatically — note it if you need to reproduce this run exactly."

Example 4: Reset to default

User: "Reset execution mode back to default"

Extraction: Reset to standard mode

Action:

aiwg execution-mode standard

Response: "Execution mode reset to standard. No reproducibility constraints are active."

Clarification Prompts

If the user's intent is ambiguous:

• "Should I generate a random seed or would you like to specify one?"
• "Which mode would you like? seeded (fixed seed only), strict (seed + pinned versions + no external calls), or audit (strict + decision logging)?"

References

• @$AIWG_ROOT/src/cli/handlers/subcommands.ts — Execution mode command handler
• @$AIWG_ROOT/docs/cli-reference.md — CLI reference
• @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/reproducibility/ — Reproducibility schemas