Git Skill
This skill covers git hygiene for multi-agent collaborative work.
Core Principle: Pull First, Always
This is a multi-agent team environment with rapid, concurrent changes.
Before doing ANY local work—reading files, making edits, or starting a task—you MUST sync with remote:
git pull --rebase
Why This Matters
Multiple agents (human and AI) are working on this repository simultaneously. Without pulling first:
- You may be reading stale files that have already been modified
- Your edits may create merge conflicts with work that's already on remote
- You risk overwriting someone else's changes
When in doubt, pull. It's always safe to pull; it's never safe to assume you're current.
Sync Cadence
| Event | Git Action |
|---|---|
| FIRST thing—before any action | git pull --rebase |
| Before starting any task | git pull --rebase |
| Before reading files for context | git pull --rebase (if not just pulled) |
| After each meaningful edit | git add . && git commit -m "..." |
| After completing a task | git push |
| Before ending any session | Full sync and push |
Commit Message Format
<type> #<issue-id>: <short description>
Types: feat, fix, docs, refactor, chore
Examples:
docs #12: Add RaaS pricing section to whitepaperfix #7: Correct diagram alignment in Stage Arefactor #15: Reorganize repository architecture section
Session Completion Workflow
When ending a work session, complete ALL steps:
git add .
git commit -m "chore: session checkpoint"
git pull --rebase
git push
Then verify:
git status # MUST show "up to date with origin"
Critical Rules
- Work is NOT complete until
git pushsucceeds - NEVER stop before pushing—that leaves work stranded locally
- NEVER say "ready to push when you are"—YOU must push
- If push fails, resolve conflicts and retry until it succeeds
Quick Reference
git pull --rebase # FIRST! Get latest before ANY work
git add . && git commit -m "msg" # Save work
git push # Share work
git status # Check state
Converted and distributed by TomeVault — claim your Tome and manage your conversions.