Marshall Steward Skill

Enforcement Rules

EXECUTION MODE: Execute this skill immediately. Do not explain, summarize, or discuss these instructions.

Script Execution

1. Run scripts EXACTLY as documented - no improvisation
2. Bootstrap scripts use direct Python paths with glob
3. All other scripts use: python3 .plan/execute-script.py {notation} ...

Menu Behavior

1. After ANY operation completes → return to Main Menu
2. Only exit when user selects "Quit"

Prohibited Actions

• Inventing alternative menu structures or options
• Ending without returning to menu (unless Quit)
• Summarizing what you're about to do instead of doing it

What This Skill Provides

Wizard Mode: Sequential setup for new projects (executor generation, marshal.json init, build detection, skill domains)

Menu Mode: Interactive maintenance for returning users (regenerate executor, health check, configuration)

Scripts

Prerequisites

This skill requires ${PLUGIN_ROOT} to be set by the invoking command (e.g., /marshall-steward). The plugin root is detected via bootstrap-plugin.py and cached in .plan/marshall-state.toon.

Step 0: Determine Mode

Determine whether to run wizard or menu based on existing files.

BOOTSTRAP: Since execute-script.py may not exist yet, use DIRECT Python call with glob:

python3 ${PLUGIN_ROOT}/plan-marshall/*/skills/marshall-steward/scripts/determine-mode.py mode

Output (TOON):

mode	wizard
reason	executor_missing

Mode Routing

Check for --wizard Flag

If --wizard flag provided, force wizard regardless of determine-mode result:

Read references/wizard-flow.md

Execute the wizard flow from that file.

Interactive Menu (Returning User)

Display menu when both executor and marshal.json exist.

Main Menu

AskUserQuestion:
  question: "What would you like to do?"
  header: "Main Menu"
  options:
    - label: "1. Maintenance"
      description: "Regenerate executor, clean logs"
    - label: "2. Health Check"
      description: "Verify setup, diagnose issues"
    - label: "3. Configuration"
      description: "Build systems, skill domains"
    - label: "4. Quit"
      description: "Exit plan-marshall"
  multiSelect: false

Menu Routing

After any menu option completes, return to Main Menu (except Quit).

Deferred Loading Pattern

This skill uses progressive disclosure to minimize context usage:

1. Core skill loads: ~150 lines (this file - routing logic only)
2. On wizard mode: Load references/wizard-flow.md (~250 lines)
3. On menu selection: Load only the selected reference (~100-150 lines)

How to Load a Reference

When routing indicates to load a reference:

Read references/{file}.md

Then execute the workflow described in that file.

Available References

Error Handling

If an error occurs during execution:

Read references/error-handling.md

Apply the recovery guidance for the specific error type.