# Chosenx Gpu Synapse Git Workflow

> Git Workflow

- Skill: `tomevault-io/chosenx-gpu-synapse-git-workflow` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/chosenx-gpu-synapse-git-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/chosenx-gpu-synapse-git-workflow/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/chosenx-gpu-synapse-git-workflow

---


# Git Workflow

Automate git operations with Conventional Commits, auto-push, and PR creation.

## Core Principles

- **One commit per logical unit**: don't mix unrelated changes in one commit
- **Conventional Commits format**: `type(scope): description`
- **Auto-push after commit**: push to remote by default (configurable)
- **Safety first**: check for unresolved conflicts before push

## Commands

### /save

Lightweight WIP commit for in-progress work. Does not push.

1. `git add -A`
2. Analyze the diff to generate a short description
3. `git commit -m "wip: {auto-generated description}"`
4. Do NOT push (WIP commits stay local)

### /commit [message]

Formal commit after completing a logical unit of work.

1. `git add -A`
2. Analyze `git diff --staged`:
   - Run the generate-commit-msg.sh script from the plugin's scripts/ directory to get structured diff info
   - Or directly analyze `git diff --staged --stat` and `git diff --staged`
3. Determine Conventional Commit components:
   - **type**: feat | fix | refactor | docs | test | chore | perf | ci | build
   - **scope**: infer from changed file paths (e.g., `auth`, `api`, `ui`)
   - **description**: concise summary of the change
4. If user provided a message, use it as the commit body
5. Format: `git commit -m "{type}({scope}): {description}" -m "{body}"`
   - Body includes a change summary
6. Auto-push: `git push origin {current-branch}`
7. If push fails (remote has new commits): `git pull --rebase` then retry push

### /push

Manual push trigger (when auto-push is disabled).

1. Check for uncommitted changes → prompt user to `/commit` first
2. `git push origin {current-branch}`
3. If new branch, auto-add `--set-upstream`
4. If remote conflicts, inform user and suggest resolution

### /pr [title]

Create a Pull Request.

1. Ensure all local commits are pushed (run `/push` if needed)
2. Collect all commit messages on this branch relative to base
3. Generate PR description:
   - Change summary (from commits)
   - Reference to plan file (if in `./plans/`)
   - If synapse-ears is installed, EARS key findings (if in `traces/`)
4. Run: `gh pr create --title "{title}" --body "{description}"`
   - If no title provided, generate from branch name
5. If vibe-kanban task exists, add reference in PR description

### /squash-merge

Merge an approved PR and clean up.

1. `gh pr merge --squash`
2. If synapse-worktree is installed, run `/worktree cleanup` for the corresponding worktree
3. If synapse-ears is installed, check if any EARS entries from this branch should be promoted to KNOWN_ISSUES.md

## Conventional Commits Reference

| Type     | Use When                                      |
|----------|-----------------------------------------------|
| feat     | New feature or capability                     |
| fix      | Bug fix                                       |
| refactor | Code restructuring without behavior change    |
| docs     | Documentation only                            |
| test     | Adding or updating tests                      |
| chore    | Maintenance (deps, config, CI)                |
| perf     | Performance improvement                       |
| ci       | CI/CD changes                                 |
| build    | Build system changes                          |

## Auto-Commit Triggers (from companion plugins)

These triggers come from companion plugins if installed:
- synapse-execute: plan-execute completes a batch and passes code-review
- synapse-review: plan-review completes a revision round
- synapse-worktree: worktree handoff (before handoff)

## EARS Integration (requires synapse-ears)

If synapse-ears is installed:
- After important commits, write an EARS Checkpoint if warranted
- The EARS PostToolUse hook (ears-trace.py) continues to work independently
- On `/squash-merge`, check traces/ for patterns worth promoting to KNOWN_ISSUES.md
- ears-trace.py detects errors in Bash output → triggers EARS Error prompt

If synapse-ears is NOT installed, skip EARS entries.

---
> Source: [CHOSENX-GPU/synapse](https://github.com/CHOSENX-GPU/synapse) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-16 -->