# API Handoff Workflow

> Backend'de bir değişiklik yapıldığında otomatik Changelog çıkaran ve Frontend takımı için eski/yeni API karşılaştırma (Devir-Teslim) dokümanı üreten iş akışı.

- Skill: `gktuoktay/api-handoff-workflow` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gktuoktay/api-handoff-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gktuoktay/api-handoff-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: GktuOktay (https://skillmd.com/u/gktuoktay)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/gktuoktay/api-handoff-workflow

---


# Backend-to-Frontend API Handoff Workflow

Whenever a change is made to the Backend APIs, you MUST execute this workflow:

1. **Update Changelog:** Automatically update the project's changelog/tracker with the backend modifications.
2. **Generate API_HANDOFF.md:** Create or update a document specifically for the Frontend/Mobile team.
   - Show the **OLD** Request/Response JSON structure vs the **NEW** structure (Diff).
   - Explain exactly what the Frontend developer needs to do to integrate this change (e.g., "Change the `userId` field to `userGuid` in the Redux store").
   - Highlight any breaking changes in bold.


<added_enterprise_rules>
- FORCE 100% type-safe conversion from C# DTOs to TypeScript Interfaces & Zod schemas.
</added_enterprise_rules>

