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
json
{
"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
--helpflag
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
bash
python3 .plan/execute-script.py plan-marshall:manage-run-config:run_config init
Validate Configuration
bash
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-lessonsskill - •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