Skip to main content
AI/MLjmagly

execution-mode

Set or report the reproducibility mode governing how AIWG workflows execute, from standard to fully auditable

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--execution-mode
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jmagly/aiwg/HEAD/agentic/code/addons/aiwg-utils/skills/execution-mode/SKILL.md -o .claude/skills/execution-mode.md

Drops the SKILL.md into .claude/skills/execution-mode.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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