---

name: manage-run-config description: Run configuration handling for persistent command configuration storage allowed-tools: Read, Write, Edit, Bash

Run Config Skill

Run configuration handling for persistent command configuration storage.

What This Skill Provides

• Read and update run configuration entries
• Track command execution history
• Manage acceptable warnings and skip lists
• Adaptive timeout management
• Validate run configuration format

When to Activate This Skill

Activate this skill when:

• Recording command execution results
• Managing acceptable warnings lists
• Managing command timeouts
• Validating run configuration structure

---

Run Configuration Structure

{
  "version": 1,
  "commands": {
    "<command-name>": {
      "last_execution": {"date": "...", "status": "SUCCESS|FAILURE"},
      "acceptable_warnings": [],
      "skipped_files": []
    }
  },
  "maven": {
    "acceptable_warnings": {
      "transitive_dependency": [],
      "plugin_compatibility": [],
      "platform_specific": []
    }
  },
  "ci": {
    "authenticated_tools": [],
    "verified_at": null
  }
}

See references/run-config-format.md for complete schema.

---

Scripts

| Script | Notation | |--------|----------| | init | plan-marshall:manage-run-config:run_config init | | validate | plan-marshall:manage-run-config:run_config validate | | timeout get | plan-marshall:manage-run-config:run_config timeout get | | timeout set | plan-marshall:manage-run-config:run_config timeout set | | warning add | plan-marshall:manage-run-config:run_config warning add | | warning list | plan-marshall:manage-run-config:run_config warning list | | warning remove | plan-marshall:manage-run-config:run_config warning remove | | cleanup | plan-marshall:manage-run-config:cleanup |

Script characteristics:

• Uses Python stdlib only (json, argparse, pathlib)
• Outputs JSON (init/validate) or TOON (timeout/cleanup) to stdout
• Exit code 0 for success, 1 for errors
• Supports --help flag

---

Standards

| Document | Purpose | When to Read | |----------|---------|--------------| | timeout-handling.md | Adaptive timeout management | Managing command timeouts | | warning-handling.md | Acceptable warning patterns | Filtering build warnings | | cleanup-operations.md | Directory cleanup | Cleaning old files |

---

Quick Start

Initialize Configuration

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

Validate Configuration

python3 .plan/execute-script.py plan-marshall:manage-run-config:run_config validate

---

Integration Points

With json-file-operations Skill

• Uses generic JSON operations for field access and updates
• All CRUD operations delegate to json-file-operations

With planning Bundle

• Commands record execution history to run configuration

With lessons-learned Skill

• Lessons learned are stored separately via plan-marshall:manage-lessons skill
• Run configuration tracks execution state only

---

References

• references/run-config-format.md - Complete schema documentation
• standards/timeout-handling.md - Adaptive timeout management
• standards/warning-handling.md - Acceptable warning patterns
• standards/cleanup-operations.md - Directory cleanup operations