# Config Sync CLI Workflow

> Orchestrate multi-target CLI configuration synchronization using config-sync phase runners and planners.

- Skill: `majiayu000/config-sync-cli-workflow` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/config-sync-cli-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/config-sync-cli-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/config-sync-cli-workflow

---


## Purpose

Drive the multi-target config-sync CLI workflow using the defined phase pipeline with consistent backup and audit behavior.

## IO Semantics

Input: CLI arguments, settings.json parameters, existing plan files, target tool configuration directories.  
Output: Execution plans, phase execution metadata, run logs, and backup records.  
Side Effects: Writes plan files, creates backups under backup directories, updates target configuration files when write phases execute.

## Deterministic Steps

1. Parameter Normalization
   - Read CLI arguments and merge with settings.json.
   - Resolve target list and component selection.

2. Plan Creation or Loading
   - Create a new plan describing collect, analyze, plan, prepare, adapt, execute, verify, cleanup, report phases; or load an existing plan file.

3. Phase Execution
   - Run collect and analyze to discover current configuration state.
   - Run plan and prepare to build and validate the execution plan, including backup locations.
   - Run adapt and execute to apply changes for selected targets and components.
   - Run verify, cleanup, and report to validate results, manage temporary artifacts, and emit summaries.

4. Result Persistence
   - Persist plan updates, run metadata, and logs into backup directories.

