Skip to main content
ClaudeWave
Skill98 repo starsupdated today

git-workflow

The git-workflow skill standardizes commit practices, branch management, and pull request generation for the AutoFyn repository. Use it when committing code changes with the [Round N] prefix format, ensuring only the orchestrator performs git writes, build artifacts are excluded via .gitignore, and PR metadata is automatically generated from commit history upon session completion.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/SignalPilot-Labs/AutoFyn /tmp/git-workflow && cp -r /tmp/git-workflow/autofyn/skills/git-workflow ~/.claude/skills/git-workflow
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Git Workflow

## Commit Format

```
[Round N] <imperative description>
```

Examples:
- `[Round 1] Add user authentication API`
- `[Round 2] Fix N+1 query in dashboard endpoint`
- `[Round 3] Refactor session manager into separate modules`

## Branch Rules

- You are already on the correct working branch. Never create or switch branches.
- Only the orchestrator commits and pushes. Subagents must not run git write commands.
- Push after every commit: `git push origin HEAD`.
- Do NOT create the actual PR — it is created automatically.


## Before Committing

Run `git status` and check for build artifacts. These must NOT be committed:

```
node_modules/   .next/        __pycache__/   *.pyc
dist/           .cache/       build/         *.log
.env            .env.local    *.sqlite       coverage/
```

If `.gitignore` doesn't cover them, add the entries before committing.

## PR Metadata

When the session is ending, generate `/tmp/pr.json` from `git log --oneline` and `git diff --stat`:

```json
{"title": "Short imperative title", "description": "## Summary\n- what and why\n\n## Tests\n- what was tested"}
```