gpd-sync-state

Automated file reconciliation syncs state.json and STATE.md files by treating the structured JSON as the authoritative store and projecting it into the human-readable markdown. This ensures consistency across research project tools.

Structured state management maintains consistent project conditions across different platforms by reconciling structured JSON data with human-readable markdown representations. This prevents state divergence in research environments.

You can automatically reconcile divergent STATE.md and state.json files by running a synchronization skill that applies a deterministic rule set. It resolves discrepancies by updating the markdown to match the authoritative JSON state.

State file synchronization operates within a Rust-native environment using local file system access and command-line tools. It successfully reconciles structured JSON and human-readable markdown states without external dependencies.

Your STATE.md file might not match your state.json data due to manual edits causing state divergence between the human-readable and structured representations. Running an automated reconciliation syncs them back to consistency.

You need to sync state.json and STATE.md files when maintaining research project state across different tools and platforms. Synchronization is required whenever the structured and human-readable state representations diverge.