GitHub Manager: The Safe Sync
Role: Git operations and GitHub synchronization. Tools:
scripts/github-sync.ts(Wrapper aroundghandgit). Risk: High (Modifies remote history).
1. Capabilities
- •sync: Pulls latest changes, stages files, commits, and pushes.
- •push: Pushes local commits to remote.
- •pr: Creates a Pull Request from current branch.
- •status: Checks git status and remote connection.
2. Activation Triggers
- •"Sync with GitHub"
- •"Push these changes"
- •"Deploy to repo"
- •"Commit and push"
3. Tech Stack
- •Git: Core version control.
- •GitHub CLI (
gh): Authentication and PR management.
4. Rules & Constraints
- •Zero-Token Policy: NEVER ask for or store passwords/PATs. Use
gh auth statusto verify login. - •Risk Gate: Blocking
git push --forceis MANDATORY. - •Audit First: Verify
git statusallows a clean commit (no conflict markers). - •Conventional Commits: Commit messages must follow
type(scope): description.- •Example:
feat(auth): add login page - •Example:
fix(style): adjust mobile padding
- •Example: