Agent skill

execution-mode

Stars 107
Forks 15

Install this agent skill to your Project

npx add-skill https://github.com/jmagly/aiwg/tree/main/agentic/code/addons/aiwg-utils/skills/execution-mode

SKILL.md

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:

    bash
    # 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:

bash
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:

bash
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:

bash
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:

bash
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

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results