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.