Agent skill

sync-core

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/sync-core

SKILL.md

🔄 Sync Core

Multi-file synchronization ve atomic changes.


📋 Atomic Change Principle

markdown
Birden fazla dosya değişikliği gerektiğinde:
1. Tüm değişiklikleri önceden planla
2. Sıralı değişiklik yap
3. Her adımda build/test çalıştır
4. Tek commit'te birleştir

🔗 Dependency Tracking

typescript
// Değişiklik yapmadan önce etkilenen dosyaları bul
// import/export chain'i takip et

// file-a.ts
export const API_URL = 'https://api.example.com';

// file-b.ts
import { API_URL } from './file-a';

// Değişiklik: API_URL → Tüm import'ları güncelle

⚠️ Change Order

1. Types/Interfaces (önce)
2. Utils/Helpers
3. Services
4. Components (son)

✅ Checklist

  • Tüm dosyalar belirlendi
  • Sıralama doğru
  • Her adımda test
  • Tek commit

🔄 Workflow

Kaynak: Conventional Commits & Trunk Based Development - Syncing

Aşama 1: Impact Analysis & Planning

  • Dependency Mapping: Değişiklik yapılacak dosyanın (örn: Interface) tüm bağımlılıklarını (Import chain) çıkar.
  • Change Set Isolation: Değişiklikleri mantıksal gruplara (Types -> Services -> UI) ayır.
  • Conflict Prediction: Aynı dosyalarda çalışan başka PR/dal olup olmadığını kontrol et.

Aşama 2: Sequential Update & Sync

  • Core-First Sync: Önce temel veri yapılarını (Types/Constants) güncelle ve derleme (compilation) hatalarını gider.
  • Business Logic Update: Services ve Controller katmanlarını yeni veri yapılarına göre senkronize et.
  • UI/Component Alignment: Props ve View katmanını güncelleyerek döngüyü tamamla.

Aşama 3: Verification & Atomic Commit

  • Cross-Module Testing: Değişen tüm modüllerin birbirleriyle uyumlu çalıştığını entegrasyon testleriyle doğrula.
  • Linter/Build Check: Tüm projede build hataları veya dangling imports kalmadığından emin ol.
  • Atomic Submission: Tüm senkronize değişiklikleri tek ve anlamlı bir "Conventional Commit" (fix: sync...) ile gönder.

Kontrol Noktaları

Aşama Doğrulama
1 Değişiklikler "Breaking Change" içeriyor mu? (Versiyonlama kontrolü)
2 Tek bir dosya değişikliğiyle sistem "Inconsistent" hale geliyor mu?
3 Tüm import yolları (Alias/Relative) doğru güncellendi mi?

Sync Core v1.5 - With Workflow

Didn't find tool you were looking for?

Be as detailed as possible for better results