Manage Plan Marshall Config

Plan-Marshall Config Skill

Manages project-level infrastructure configuration in .plan/marshal.json.

What This Skill Provides

• Skill Domains: Implementation skill defaults and optionals per domain
• System Settings: Retention and cleanup configuration
• Plan Phase Configuration: Phase-specific settings (branching, compatibility, commit strategy, pipelines)

When to Activate This Skill

Activate this skill when:

• Initializing project configuration (/marshall-steward wizard)
• Querying implementation skills for a domain
• Managing retention settings
• Configuring plan phase settings

Workflow: Initialize Configuration

Pattern: Script Automation

Initialize marshal.json with defaults.

python3 .plan/execute-script.py plan-marshall:manage-plan-marshall-config:plan-marshall-config init

Workflow: Query Skill Domains

Pattern: Read-Process-Write

Get implementation skills for a specific domain.

Get Domain Defaults

python3 .plan/execute-script.py plan-marshall:manage-plan-marshall-config:plan-marshall-config \
  skill-domains get-defaults --domain java-core

Output:

status: success
domain: java-core
defaults[1]:
- pm-dev-java:java-core

Get Domain Optionals

python3 .plan/execute-script.py plan-marshall:manage-plan-marshall-config:plan-marshall-config \
  skill-domains get-optionals --domain java-implementation

Validate Skill in Domain

python3 .plan/execute-script.py plan-marshall:manage-plan-marshall-config:plan-marshall-config \
  skill-domains validate --domain java-core --skill pm-dev-java:java-lombok

Workflow: System Settings

Pattern: Read-Process-Write

Manage system-level infrastructure settings.

Get Retention Settings

python3 .plan/execute-script.py plan-marshall:manage-plan-marshall-config:plan-marshall-config \
  system retention get

Set Retention Field

python3 .plan/execute-script.py plan-marshall:manage-plan-marshall-config:plan-marshall-config \
  system retention set --field logs_days --value 7

Workflow: Plan Phase Configuration

Pattern: Read-Process-Write

Manage phase-specific plan configuration. Each phase has its own sub-noun.

Get Phase Configuration

python3 .plan/execute-script.py plan-marshall:manage-plan-marshall-config:plan-marshall-config \
  plan phase-2-refine get

Get Specific Phase Field

python3 .plan/execute-script.py plan-marshall:manage-plan-marshall-config:plan-marshall-config \
  plan phase-2-refine get --field compatibility

Set Phase Field

python3 .plan/execute-script.py plan-marshall:manage-plan-marshall-config:plan-marshall-config \
  plan phase-5-execute set --field commit_strategy --value per_plan

Workflow: CI Command Lookup

Pattern: Lookup and Execute

Get a CI command by name, then execute with arguments.

Get CI Command

python3 .plan/execute-script.py plan-marshall:manage-plan-marshall-config:plan-marshall-config \
  ci get-command --name issue-view

Output:

status: success
name: issue-view
command: python3 .plan/execute-script.py plan-marshall:tools-integration-ci:github issue view

Execute the Command

Parse the command field from output, then execute with arguments:

python3 .plan/execute-script.py plan-marshall:tools-integration-ci:github issue view --issue 123

Available CI commands (registered via ci_health persist):

• pr-create - Create pull request
• pr-reviews - Get PR reviews
• pr-comments - Get PR comments
• ci-status - Check CI status
• ci-wait - Wait for CI completion
• issue-create - Create issue
• issue-view - View issue details

API Reference

Noun: skill-domains

resolve-domain-skills

Standard profiles: implementation, module_testing, integration_testing, quality.

resolve-workflow-skill

Always returns from the system domain's workflow_skills.

resolve-workflow-skill-extension

Returns null (not error) if extension doesn't exist for the domain.

get-workflow-skills

get-skills-by-profile

configure-task-executors

resolve-task-executor

Noun: ext-defaults

Noun: system

Noun: plan

Phase-specific configuration using plan {phase} {verb} pattern.

Noun: ci

init

python3 .plan/execute-script.py plan-marshall:manage-plan-marshall-config:plan-marshall-config \
  init [--force]

Data Model

marshal.json Location

.plan/marshal.json

Structure

The defaults template contains only system domain. Technical domains (java, javascript, etc.) are added during project initialization based on detection or manual configuration. Technical domains store only bundle reference and workflow_skill_extensions -- profiles are loaded at runtime from extension.py.

Example (Java project after init):

{
  "skill_domains": {
    "system": {
      "defaults": ["plan-marshall:ref-development-standards"],
      "optionals": ["plan-marshall:ref-development-standards"],
      "task_executors": {
        "implementation": "pm-workflow:task-implementation",
        "module_testing": "pm-workflow:task-module_testing",
        "integration_testing": "pm-workflow:task-integration_testing"
      }
    },
    "java": {
      "bundle": "pm-dev-java",
      "workflow_skill_extensions": {
        "triage": "pm-dev-java:ext-triage-java"
      }
    }
  },
  "system": {
    "retention": {
      "logs_days": 1,
      "archived_plans_days": 5,
      "memory_days": 5,
      "temp_on_maintenance": true
    }
  },
  "plan": {
    "phase-1-init": {
      "branch_strategy": "direct"
    },
    "phase-2-refine": {
      "confidence_threshold": 95,
      "compatibility": "breaking"
    },
    "phase-5-execute": {
      "commit_strategy": "per_deliverable"
    },
    "phase-6-verify": {
      "max_iterations": 5,
      "1_quality_check": true,
      "2_build_verify": true,
      "domain_steps": {}
    },
    "phase-7-finalize": {
      "max_iterations": 3,
      "1_commit_push": true,
      "2_create_pr": true,
      "3_automated_review": true,
      "4_sonar_roundtrip": true,
      "5_knowledge_capture": true,
      "6_lessons_capture": true
    }
  }
}

Standard Domains

System Domain

The system domain contains task executors and base skills applied to all tasks.

Technical Domains (Profile Structure)

Technical domains store bundle reference and workflow_skill_extensions in marshal.json. Profiles are loaded at runtime from extension.py.

Available Domains:

Use resolve-domain-skills --domain {domain} --profile {profile} to get aggregated skills.

Scripts

Script characteristics:

• Uses Python stdlib only (json, argparse, pathlib, xml.etree)
• Outputs TOON to stdout
• Exit code 0 for success, 1 for errors
• Supports --help flag

Integration Points

With plan-marshall Skill

• Called during wizard initialization
• Called from configuration menus

With Implementation Agents

• skill-domains get-defaults provides skills to load
• skill-domains get-optionals provides available optionals

With Cleanup

• system retention get provides retention settings

Error Handling

All operations validate prerequisites before proceeding:

status: error
error: marshal.json not found. Run command /marshall-steward first

Standard error conditions:

• marshal.json not found - Run /marshall-steward first
• skill_domains not configured - Run /marshall-steward first
• Unknown domain: {name} - Domain doesn't exist