# Git Workflow

> Git workflow rules for Renfield. Commit message format, issue numbering, branch naming, PR creation, documentation updates before push. Triggers on "commit", "push", "PR erstellen", "pull request", "branch", "git", "merge". Use when this capability is needed.

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

---


# Git Workflow

## CRITICAL RULES

1. **NIEMALS ohne Erlaubnis pushen** — `git push` NUR nach expliziter Bestätigung
2. **Issue-Nummer bei jedem Commit** — Vor jedem Commit nach der Issue-Nummer fragen
3. **Dokumentation vor Push** — CLAUDE.md, docs/, README müssen Änderungen widerspiegeln
4. **Branch Protection** — Direct push to `main` is blocked. Always use feature branch → PR → merge.
5. **Co-Authored-By** — Jeder Commit muss die Co-Author-Zeile enthalten

## Commit Message Format

```
type(scope): Kurze Beschreibung (#issue)

Längere Beschreibung falls nötig.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
```

**Example:** `feat(satellites): Add monitoring dashboard (#25)`

## Commit Types

| Type | Usage |
|------|-------|
| `feat` | Neues Feature |
| `fix` | Bugfix |
| `docs` | Dokumentation |
| `refactor` | Code-Refactoring |
| `test` | Tests hinzufügen/ändern |
| `chore` | Wartung, Dependencies |

## Workflow

1. Create feature branch: `git checkout -b type/short-description`
2. Make changes + write tests (TDD)
3. Update documentation (CLAUDE.md, docs/)
4. Ask for issue number
5. Commit with proper format
6. Ask user: "Soll ich pushen?"
7. Only after confirmation: `git push -u origin branch-name`
8. Create PR: `gh pr create --title "type(scope): Description (#issue)" --body "..."`

## PR Format

```bash
gh pr create --title "type(scope): Description (#issue)" --body "$(cat <<'EOF'
## Summary
- Bullet points describing changes

## Test plan
- [ ] Tests added/updated
- [ ] Manual testing done

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"
```

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