speckit-docs-sync

You synchronize agent context files by aligning AGENTS.md, CLAUDE.md, copilot-instructions.md, and GEMINI.md with the installed Python preset template, ensuring consistent operating rules across all agents.

The best way to update agent instructions without losing custom additions is to use a diff review process before writing, which shows pending changes so you can preserve project-specific content while applying template updates.

Context file synchronization works by comparing existing agent instruction files against a central Python preset template, generating a diff for review, and writing the synchronized content to maintain uniform operating rules across all agents.

Yes, you can use this template management approach for multiple agents by synchronizing their respective context files, including CLAUDE.md, .github/copilot-instructions.md, and GEMINI.md, to ensure they all operate under the same rules.

A key limitation is that automated synchronization requires a manual diff review step to prevent overwriting project-specific additions, meaning you must verify pending changes before the script writes them to the context files.