Plan Marshall

Table of Contents

• 1. Status
• 2. What is it?
• 3. Prerequisites
• 4. Installation
• 5. Getting Started
• 6. Core Commands
  • 6.1. /marshall-steward
  • 6.2. /plan-manage
• 7. Project Structure
• 8. Available Bundles
• 9. Support

Caution

Under Development. Not released yet. Alpha-Version

1. Status

2. What is it?

An orchestration layer for AI coding assistants (currently Claude Code) that enforces consistency, reliability, and more predictable outputs.

3. Prerequisites

Important

Python 3 is required and must be available as python3 in your PATH. Verify with: python3 --version

4. Installation

Add the Plan Marshall marketplace to Claude Code:

/plugin
->   3. Add marketplace
->   "https://github.com/cuioss/plan-marshall/marketplace"

Then install the desired bundles using Claude Code’s plugin tooling.

5. Getting Started

After installing the marketplace, run the setup wizard:

/marshall-steward

See [_marshall_steward] for details on what this command configures.

6. Core Commands

6.1. /marshall-steward

Project configuration wizard for the planning system.

/marshall-steward           # Interactive menu or first-run wizard
/marshall-steward --wizard  # Force first-run wizard

First-Run Wizard (when executor missing):

1. Configures .gitignore for .plan/ directory

2. Generates script executor with all script mappings

3. Discovers project modules via extension API

4. Initializes marshal.json configuration

5. Configures skill domains based on project structure

6. Detects CI provider and tools

Interactive Menu (returning users):

• Maintenance - Regenerate executor, clean logs

• Health Check - Verify setup, diagnose issues

• Configuration - Build systems, skill domains

6.2. /plan-manage

Manage task plans - create, list, outline, and cleanup.

/plan-manage                # Interactive menu
/plan-manage list           # List all plans
/plan-manage create         # Create new plan
/plan-manage cleanup        # Remove completed plans

Plan Lifecycle:

1. Init - Create plan directory with request document

2. Outline - Generate solution outline with deliverables

3. Plan - Transform deliverables into executable tasks

4. Execute - Run tasks sequentially with skill loading

5. Finalize - Complete with git workflow and PR

7. Project Structure

After setup, Plan Marshall creates:

.plan/
├── execute-script.py           # Script executor (generated)
├── marshal.json                # Project configuration
├── run-configuration.json      # Runtime settings
├── project-architecture/       # Module analysis
│   ├── derived-data.json       # Raw discovery data
│   └── llm-enriched.json       # Enriched module info
└── plans/                      # Active plans
    └── {plan-id}/
        ├── request.md          # Plan request
        ├── config.toon         # Plan config
        ├── status.toon         # Plan status
        └── TASK-*.toon         # Task files

8. Available Bundles

Bundle	Purpose
plan-marshall	Core infrastructure, permissions, script execution
pm-workflow	5-phase planning workflow, task execution
pm-dev-java	Java development standards and agents
pm-dev-frontend	JavaScript/CSS standards and tooling
pm-documents	AsciiDoc documentation standards
pm-plugin-development	Marketplace component development
pm-requirements	Requirements engineering standards

See individual bundle READMEs in marketplace/bundles/*/README.md for details.

9. Support

• Report issues: https://github.com/cuioss/plan-marshall/issues

• Bundle documentation: marketplace/bundles/*/README.md