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 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