مدیریت توسعه و انتشار با Git Flow

---
name: "mastering-git-flow"
description: "Git Flow مناسب را برای Feature، Release و Hotfix انتخاب و اجرا کن؛ از شاخه‌های مشترک محافظت کن و تاریخچه‌ای قابل بازبینی بساز."
---

# مدیریت توسعه و انتشار با Git Flow

این Skill را زمانی به کار ببر که مخزن از Git Flow استفاده می‌کند یا تیم برای Feature، Release و Hotfix به فرایند شاخه‌بندی نسخه‌محور نیاز دارد.

## تناسب فرایند را بسنج

Git Flow برای انتشارهای نسخه‌بندی‌شده و تثبیت موازی Release مناسب است. برای Continuous Deployment با شاخه‌های بسیار کوتاه، یک روند ساده‌تر Trunk-Based را پیشنهاد بده و تشریفات اضافه نساز.

## نقش شاخه‌ها

- `main`: تاریخچه Production و Tagهای انتشار.
- `develop`: ادغام تغییرات نسخه بعد.
- `feature/<name>`: کار کوتاه‌مدت منشعب از `develop`.
- `release/<version>`: تثبیت نسخه منشعب از `develop`.
- `hotfix/<name>`: اصلاح فوری Production منشعب از `main`.

نام‌های تعریف‌شده در مخزن را مقدم بدان.

## روند Feature

1. وضعیت Working Tree و اطلاعات Remote را بررسی کن.
2. از `develop` به‌روز شاخه بساز.
3. Commitها را متمرکز و مطابق قرارداد مخزن نگه دار.
4. طبق سیاست تیم تغییرات `develop` را دریافت و Conflict را با دقت حل کن.
5. پیش از Review یا Merge اعتبارسنجی لازم را اجرا کن.
6. از فرایند Protected Branch برای Merge استفاده کن و فقط با مجوز شاخه تمام‌شده را حذف کن.

## روند Release

از `develop` شاخه `release/<version>` بساز، فقط Fixهای انتشار و تغییر نسخه را بپذیر، Release Candidate را اعتبارسنجی کن، آن را در `main` ادغام و Tag کن و همان اصلاحات را به `develop` برگردان.

## روند Hotfix

از Commit تولیدی روی `main` شاخه بساز، کوچک‌ترین Fix امن را همراه Regression Test انجام بده، Patch Release را Tag کن و اصلاح را به `develop` و Release فعال لازم برگردان.

## قواعد ایمنی

- تغییر محلی را بدون اجازه دور نریز و تاریخچه مشترک را بازنویسی نکن.
- روی شاخه محافظت‌شده Force Push انجام نده.
- پیش از Merge، Tag یا Delete هدف دقیق را بررسی کن.
- Conflict و عدم‌قطعیت انتشار را آشکار کن و حدس نزن.
- در پایان، شاخه نهایی، وضعیت تست و Mergeهای باقیمانده را گزارش کن.