Scan to join WeChat groupMarshall Steward Skill
Project configuration wizard for the planning system.
Usage
/marshall-steward # Interactive menu or first-run wizard
/marshall-steward --wizard # Force first-run wizard
Banner
Output this banner directly as text at command start (do NOT use Bash echo - output it in your response):
╔═══════════════════════════════════════════════════════════════════════╗
║ : ║
║ .;:;. ║
║ :;:::;: ║
║ ... .;:::::::::;. ... ║
║ .::;:::::::::::::;:::::::::;:::::::::::::;::. ║
║ :;:::::::::::::::::::::::::::::::;: ║
║ .;:::::::::::::::::::::::::::::;. ║
║ ║
║ █▀█ █ █▀█ █▄ █ ║
║ █▀▀ █▄▄ █▀█ █ ▀█ ║
║ █▀▄▀█ █▀█ █▀█ █▀ █ █ █▀█ █ █ ║
║ █ ▀ █ █▀█ █▀▄ ▄█ █▀█ █▀█ █▄▄ █▄▄ ║
║ ║
║ .;:::::::::::::::::::::::::::::;. ║
║ :;:::::::::::::::::::::::::::::::;: ║
║ .::;:::::::::::::;:::::::::;:::::::::::::;::. ║
║ ... .;:::::::::;. ... ║
║ :;:::;: ║
║ .;:;. ║
║ : ║
╚═══════════════════════════════════════════════════════════════════════╝
Enforcement Rules
Script Execution
- Run scripts EXACTLY as documented - no improvisation
- Bootstrap scripts use direct Python paths with glob
- All other scripts use:
python3 .plan/execute-script.py {notation} ...
Menu Behavior
- After ANY operation completes → return to Main Menu
- 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
| Script | Notation | Purpose |
|--------|----------|---------|
| determine-mode | plan-marshall:marshall-steward:determine-mode | Determine wizard vs menu mode |
| gitignore-setup | plan-marshall:marshall-steward:gitignore-setup | Configure .gitignore for .plan/ |
| cleanup | plan-marshall:manage-run-config:cleanup | Clean temp, logs, archived-plans, memory (delegated to run-config) |
| ci_health | plan-marshall:tools-integration-ci:ci_health | CI provider detection (delegated to tools-integration-ci) |
| plan-marshall-config | plan-marshall:manage-plan-marshall-config:plan-marshall-config | Project-level marshal.json CRUD |
| scan-marketplace-inventory | pm-plugin-development:tools-marketplace-inventory:scan-marketplace-inventory | Script discovery |
| permission-doctor | plan-marshall:permission-doctor:permission-doctor | Permission analysis |
| permission-fix | plan-marshall:permission-fix:permission-fix | Permission fixes |
| generate-executor | plan-marshall:tools-script-executor:generate-executor | Executor generation |
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
| mode | reason | Action |
|------|--------|--------|
| wizard | executor_missing | Load: Read references/wizard-flow.md → Execute wizard |
| wizard | marshal_missing | Load: Read references/wizard-flow.md → Execute wizard |
| menu | both_exist | Show Main Menu below |
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
| User Selection | Action |
|----------------|--------|
| "1. Maintenance" | Load: Read references/menu-maintenance.md → Execute |
| "2. Health Check" | Load: Read references/menu-healthcheck.md → Execute |
| "3. Configuration" | Load: Read references/menu-configuration.md → Execute |
| "4. Quit" | Output "Good bye!" → STOP |
After any menu option completes, return to Main Menu (except Quit).
Deferred Loading Pattern
This skill uses progressive disclosure to minimize context usage:
- Core skill loads: ~150 lines (this file - routing logic only)
- On wizard mode: Load
references/wizard-flow.md(~250 lines) - 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
| Reference | Purpose | Load When |
|-----------|---------|-----------|
| wizard-flow.md | First-run wizard steps 1-11 | mode=wizard or --wizard flag |
| menu-maintenance.md | Regenerate executor, cleanup | Menu option 1 |
| menu-healthcheck.md | Verify setup, diagnose issues | Menu option 2 |
| menu-configuration.md | Build systems, skill domains | Menu option 3 |
| output-format.md | TOON output standards | Reference for output formatting |
| error-handling.md | Error types and recovery | On error conditions |
Error Handling
If an error occurs during execution:
Read references/error-handling.md
Apply the recovery guidance for the specific error type.