🔄 Sync Core

← Back to skills

> Multi-file synchronization ve atomic changes.

Category: General & Miscellaneous
Repo: vuralserhat86-antigravity-agentic-skills
Path: skills/sync_core/SKILL.md
Updated: 1/3/2026, 12:20:04 PM

AI Summary

> Multi-file synchronization ve atomic changes. It is useful for general automation, multi-purpose workflows, cross-disciplinary tasks, and utility skills. Source: vuralserhat86-antigravity-agentic-skills (skills/sync_core/SKILL.md).

🔄 Sync Core

Multi-file synchronization ve atomic changes.


📋 Atomic Change Principle

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

// 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şamaDoğrulama
1Değişiklikler "Breaking Change" içeriyor mu? (Versiyonlama kontrolü)
2Tek bir dosya değişikliğiyle sistem "Inconsistent" hale geliyor mu?
3Tüm import yolları (Alias/Relative) doğru güncellendi mi?

Sync Core v1.5 - With Workflow

Related skills