Data safeguard olarak worktree, checkpoint ve report

Agentic system file değiştirir, artefact üretir, configuration update eder ve external process trigger eder. Human birkaç step'te pause edebilirken agent uzun action chain yürütebilir. Failure yalnız output'u değil intermediate state, decision ve dependency'yi de kaybettirebilir.

Worktree, commit ve run report sıkça „backup" diye adlandırılır. Bu teknik olarak precise değildir. Worktree parallel working tree'dir, independent copy değildir. Commit untracked file, database veya secret'ı otomatik içermez. Report kayıp byte'ı tarif eder ama restore edemez.

Dependable architecture dört görevi ayırır: work isolation, versioning, operational evidence ve tested restore içeren backup.

Worktree işi ayırır, failure'ı değil

Git aynı repository'ye birden çok working tree bağlayabilir ve farklı branch'leri aynı anda checkout edebilir. Agentic work için bu değerlidir: agent named assignment'ı own directory içinde işler, main workspace clean kalır. Diff, test ve approval task-specific olur.

Isolation'ın sınırı vardır. Linked worktree önemli repository data ve reference'ları paylaşır. Common repository corruption, misconfiguration veya loss birden çok tree'yi etkileyebilir. Database, object store, model artefact, cache ve secret store yeni worktree ile kopyalanmaz.

Worktree collision ve contamination boundary'dir. Parallel change'in yanlış karışmasını önler. Hardware loss, destructive cleanup, malicious encryption veya common-storage failure için tek başına safeguard değildir.

Baseline bilinmelidir

Agent başlamadan run origin reference ister: repository, branch, commit ID, index state, working-tree change, untracked file, submodule, relevant tool release ve external snapshot reference.

Clean start unknown dirty workspace'ten daha kolay verify edilir. Existing change gerekiyorsa silent inherit edilmez. Preflight manifest her change'i assignment input, protected foreign state veya blocker olarak classify eder.

git status index, working tree ve untracked file'ı görünür yapar; visibility preservation değildir. Untracked file deliberately eklenene kadar commit dışında kalır. Ignored file için separate policy gerekir.

Checkpoint semantic state marker'dır

Her commit useful checkpoint değildir. Checkpoint anlamlı biçimde dönülebilen state'i işaretler: „import complete", „schema migrated ve validated" veya „publication package prepared fakat not approved".

Checkpoint anlaşılacak kadar atomic, invisible intermediate action'a bağlı olmayacak kadar complete olmalıdır. Commit ID, external snapshot, artefact version, schema ve tool release, validation result, known deviation, owner, time, run ID ve next permitted transition içerir veya referanslar.

Name immutable identity yerine geçmez. Branch veya tag move edebilir; commit ID concrete Git state'i adresler. External object stable ID, version veya hash ister.

Commit yalnız versioned slice'ı yakalar

Commit file state'i reconstruct etmek için güçlüdür fakat bütün project'in snapshot'ı değildir. Index veya targeted commit ile seçilen content'i kaydeder. Local database, binary, generated export, log, credential ve untracked file dışarıda kalabilir.

Bu nedenle state inventory versioned source, non-versioned authoritative data, reproducible output, runtime queue, external service, secret ve disposable cache'i ayırır. Her class farklı recovery route ister. Cache backup gerektirmeyebilir ama rebuild procedure ister. Secret Git dışında kalır ve protected secret lifecycle ile geri sağlanır.

Run report evidence'dır, copy değildir

Report assignment, baseline, plan, action, tool call, diff, test, approval, checkpoint ve outcome'u bağlar. Intended state, actual action, resulting state, external change ve open item sorularını cevaplar.

Stable reference gerekir. „Current file" yerine path, version veya hash yazılır. „Backup successful" yerine job, destination, verification ve last restore exercise belirtilir. Report volatile runtime state dışında tutulur ve silent overwrite edilemez.

Fakat report payload data yerine geçmez. Değeri provenance, diagnosis ve correct recovery point selection'dır.

Real backup separate failure domain ister

Same device, account veya administrative path üzerindeki copy aynı event ile yok olabilir. Dependable backup farklı storage system, independent permission, immutable retention, geographic separation veya offline copy ile separate failure domain'da tutulur.

Git remote availability'yi yükseltir ama otomatik complete backup değildir: unpushed commit ve local reference eksik olabilir; damaging change replicate edilebilir. Full bundle Git object ve reference'ı portable package yapabilir. Yine de separate storage, protection, verification ve restore test gerekir.

External data application-consistent snapshot ister. Running database'in file'larını kopyalamak unusable set üretebilir. Checkpoint ile backup coordinate edilir; report commit ve schema release ile eşleşen exact database snapshot'ı referanslar.

RPO ve RTO recovery objective'i somutlaştırır

Recovery Point Objective zaman açısından acceptable data loss'u, Recovery Time Objective service'in ne kadar hızlı dönmesi gerektiğini tanımlar. İkisi de tool convenience'a değil impact'e bağlıdır.

Agent saatte binlerce change yapıyorsa daily backup yetersiz olabilir. Reproducible intermediate export continuous protection istemeyebilir. Cadence'i authoritative state, external effect ve approval point belirler.

Objective whole system'ı kapsar. Repository beş dakikada restore olurken database, artefact, right ve queue iki gün sürüyorsa hedef karşılanmaz.

Restore test truth test'tir

„Backup var" bir claim'dir. Restore exercise evidence üretir. Data isolated environment'a restore edilir; integrity ve relationship kontrol edilir; defined validation çalışır ve result checkpoint manifest ile karşılaştırılır.

Git object connectivity ve bundle prerequisite kontrolü yapabilir. Bunlar önemlidir fakat domain completeness kanıtlamaz. External snapshot, permission, key access ve startup order da çalışmalıdır. Referenced data release eksikse technically valid restore operationally useless olabilir.

Exercise regular yapılır ve architecture change sonrası tekrarlanır. Actual restore time, data gap, manual work ve deviation ölçülür. Finding runbook, automation ve protection scope'u geliştirir.

Agentic resumption idempotency ister

Interruption sonrası agent last sentence'dan blind resume etmez. Orchestrator latest confirmed checkpoint'i okur ve proposed, prepared, executed, externally confirmed action'ı ayırır. Repeatable step idempotency key veya stable action ID kullanır.

Bu duplicate message, charge veya migration'ı önler. Non-idempotent action resume öncesi state query ve bazen human decision ister.

Lock ve lease iki run'ın aynı target'ı concurrently mutate etmesini önler. Orphaned lock expiry ve recovery rule taşır; last state incelenmeden silinmez.

Safeguard protocol layer'ları bağlar

1 · INVENTORY: authoritative ve derived state'i belirle.

2 · BASELINE: commit, workspace ve external snapshot reference'ı capture et.

3 · ISOLATE: dedicated worktree ve narrow right sağla.

4 · EXECUTE: live journal ile small verifiable change yap.

5 · CHECKPOINT: semantically complete state'i commit ve manifest et.

6 · REPORT: diff, test, impact, approval ve open item kaydet.

7 · REPLICATE: repository ve external backup'ı other failure domain'a aktar.

8 · VERIFY: integrity kontrol et ve recovery point'i catalogue et.

9 · RESTORE: isolated environment'da düzenli restore uygula.

Bu protocol version control'ü backup yapmaz. Technical state, meaning ve recoverability'yi birlikte demonstrate edilecek şekilde bağlar.

Alıştırma: Recovery Chain Map tasarla

1. Git file, untracked data, database, artefact, secret, queue ve cache inventory çıkar.

2. Her class'a owner, authority, backup method, RPO ve RTO ata.

3. Worktree baseline ve preflight manifest tanımla.

4. Entry ve exit criterion içeren üç semantic checkpoint yaz.

5. Stable reference ve evidence field kullanan run report tasarla.

6. Separate failure domain seç; encryption ve retention tanımla.

7. Interruption ve resumption rule içeren restore exercise yaz.

Yansıtma: Hangi önemli project state bugün version control dışında? Hangi „backup" hiçbir zaman complete restore edilmedi?

İndirilecek tüm materyaller — konu özeti ve çalışma kâğıdı:

Kapsam: Model product-independent'tır; retention, encryption ve recovery requirement data class, risk ve applicable obligation'a bağlıdır. Editoryal ve teknik inceleme: 17 Temmuz 2026.