Claude-skill-registry-data manage-plan-marshall-config

Project-level infrastructure configuration for marshal.json

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry-data

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry-data "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/manage-plan-marshall-config" ~/.claude/skills/majiayu000-claude-skill-registry-data-manage-plan-marshall-config && rm -rf "$T"

manifest: data/manage-plan-marshall-config/SKILL.md

source content

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

Verb	Parameters	Purpose
`list`	(none)	List all domains
`get`	`--domain`	Get full domain config (returns nested structure for technical domains)
`get-defaults`	`--domain`	Get default skills (returns `core.defaults` for nested domains)
`get-optionals`	`--domain`	Get optional skills (returns `core.optionals` for nested domains)
`set`	`--domain [--profile] [--defaults] [--optionals]`	Set domain config (profiles read from extension.py, system domain only)
`add`	`--domain --defaults [--optionals]`	Add new domain
`validate`	`--domain --skill`	Check if skill valid (searches all profiles for nested domains)
`detect`	(none)	Auto-detect domains from project files
`get-extensions`	`--domain`	Get workflow skill extensions for domain
`set-extensions`	`--domain --type --skill`	Set workflow skill extension (types: outline, triage)
`get-available`	(none)	Get available domains based on detected build systems
`configure`	`--domains`	Configure selected domains with templates

resolve-domain-skills

Parameters Purpose

--domain --profile

Resolve skills for domain and profile (aggregates

{domain}.core

{domain}.{profile}

)

Standard profiles:

implementation

module_testing

integration_testing

quality

resolve-workflow-skill

Parameters	Purpose
`--phase`	Resolve system workflow skill for phase (init, refine, outline, plan, execute, verify, finalize)

Always returns from the

system

domain's

workflow_skills

resolve-workflow-skill-extension

Parameters	Purpose
`--domain --type`	Resolve domain-specific workflow extension (types: outline, triage)

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

get-workflow-skills

Parameters	Purpose
(none)	Get all workflow skills from system domain (7-phase model)

get-skills-by-profile

Parameters	Purpose
`--domain`	Get skills organized by profile for architecture enrichment

configure-task-executors

Parameters	Purpose
(none)	Auto-discover profiles and register task executors (convention: profile X -> `pm-workflow:task-X` )

resolve-task-executor

Parameters	Purpose
`--profile`	Resolve task executor skill for a profile (e.g., implementation, module_testing)

Noun: ext-defaults

Verb	Parameters	Purpose
`get`	`--key`	Get extension default value
`set`	`--key --value`	Set extension default value (always overwrites)
`set-default`	`--key --value`	Set value only if key does not exist (write-once)
`list`	(none)	List all extension defaults
`remove`	`--key`	Remove extension default

Noun: system

Verb	Parameters	Purpose
`retention get`	(none)	Get all retention settings
`retention set`	`--field --value`	Set retention field

Noun: plan

Phase-specific configuration using

plan {phase} {verb}

pattern.

Verb	Parameters	Purpose
`phase-1-init get`	`[--field]`	Get init phase configuration
`phase-1-init set`	`--field --value`	Set init phase field (branch_strategy)
`phase-2-refine get`	`[--field]`	Get refine phase configuration
`phase-2-refine set`	`--field --value`	Set refine phase field (confidence_threshold, compatibility)
`phase-5-execute get`	`[--field]`	Get execute phase configuration
`phase-5-execute set`	`--field --value`	Set execute phase field (commit_strategy)
`phase-6-verify get`	`[--field]`	Get verify phase configuration
`phase-6-verify set-step`	`--step --enabled`	Toggle generic verify step
`phase-6-verify set-domain-step`	`--domain --step --enabled`	Toggle domain verify step
`phase-6-verify set-max-iterations`	`--value`	Set verify max iterations
`phase-7-finalize get`	(none)	Get finalize phase configuration
`phase-7-finalize set-step`	`--step --enabled`	Toggle finalize step
`phase-7-finalize set-max-iterations`	`--value`	Set finalize max iterations

Noun: ci

Verb	Parameters	Purpose
`get`	(none)	Get full CI config
`get-provider`	(none)	Get CI provider and repo URL
`get-tools`	(none)	Get authenticated tools list
`get-command`	`--name`	Get single CI command by name (ready to execute)
`set-provider`	`--provider --repo-url`	Set CI provider
`set-tools`	`--tools`	Set authenticated tools (comma-separated)
`persist`	`--provider --repo-url [--commands] [--tools] [--git-present]`	Persist full CI config (provider, commands, tools)

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.

Field	Purpose
`defaults`	Base skills loaded for all tasks ( `plan-marshall:ref-development-standards` )
`optionals`	Optional base skills available for selection
`task_executors`	Maps profiles to task executor skills (convention: profile X -> `pm-workflow:task-X` )

Technical Domains (Profile Structure)

Technical domains store

bundle

reference and

workflow_skill_extensions

in marshal.json. Profiles are loaded at runtime from

extension.py

Profile	Phase	Purpose
`core`	all	Skills loaded for all profiles
`implementation`	execute	Production code tasks
`module_testing`	execute	Unit/module test tasks
`integration_testing`	execute	Integration test tasks
`quality`	verify	Documentation, verification

Available Domains:

Domain	Bundle	Extensions
`java`	`pm-dev-java`	triage
`javascript`	`pm-dev-frontend`	triage
`plan-marshall-plugin-dev`	`pm-plugin-development`	outline, triage
`documentation`	`pm-documents`	outline, triage

Use

resolve-domain-skills --domain {domain} --profile {profile}

to get aggregated skills.

Scripts

Script	Notation
plan-marshall-config	`plan-marshall:manage-plan-marshall-config`

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