The Commit-Sync Guide
Version control shouldn't feel like version chaos.
Whether you're writing code, designing a website, editing stories, or collaborating across tools like ChatGPT, Windsurf, or Cursor, the Commit-Sync method helps keep you (and your tools) on the same page.
This guide is written for solo developers working independently with Git. If you're working in a team or contributing to shared repositories, some practices may differ. A follow-up guide on team workflows, conflict handling, and collaboration best practices is coming soon.
Why We Made This
We kept running into the same problem:
"I'm working with AI (or just moving fast), but I keep losing track of what changed, where, and why."
So we created a flexible, repeatable markdown-based commit workflow that works great:
- With AI (like ChatGPT, Cursor, Windsurf)
- Manually (on your own)
- Collaboratively (with human teammates or AI partners)
It's not fancy. It just works.
What It Does
- Prevents messy commit logs
- Makes AI-generated or team-assisted changes more trackable
- Adds structure to projects with no formal Git process
- Works across code, markdown, story drafts, HTML, config files, and more
- Saves time, sanity, and "wait... what changed again?" moments
Core Workflow Rules
- Test First: Never commit untested code.
- Explicit Confirmation: Ask before every action. Never assume the next step.
- Controlled Pushes: Don't push to GitHub without review.
- Scope Discipline: Stay within the assigned file scope.
- No Silent Deployments: Do not trigger deployment pipelines unless explicitly approved.
This workflow can be followed manually or embedded in an AI tool that offers structured, clickable options.
Step 1: Confirm Testing
Prompt:
Have all tests been completed?
Options:
- YES - Continue to commit
- NO - Stop and test first
Step 2: Stage and Commit
Prompt:
Ready to stage and commit your changes?
If YES, show:
git add .
git commit -m "Descriptive commit message"
Follow-up:
Execute the commit?
Step 3: Sync and Validate Local State
Prompt:
Sync with origin and review local status?
If YES, show:
git pull
git status
git log
Step 4: Push to GitHub
Prompt:
Push changes to remote repository?
If YES, show:
git push origin main
Follow-up:
Confirm push now?
Notes for Teams
This guide is ideal for use with:
- Automated Git assistants (e.g., AI copilots like ChatGPT, Cursor, Windsurf)
- Internal tooling scripts
- Junior team onboarding
- Personal consistency for solo developers
Every prompt ensures your team (or AI assistant) gets explicit confirmation before touching critical systems.
This process can be used fully manually. Just follow the steps above in your own terminal. It works just as well without automation.
Credits
This process was developed by Dennis Ayotte through real-world testing, both AI-assisted and fully manual. It's free to adapt for your own workflow. If it helps you stay sane, even better.
Refined with help from ChatGPT, tested extensively with Windsurf, and minimally (but successfully) with Cursor. Also works flawlessly without any AI at all.