Bir kodlama ajanı bir hatayı nasıl düzeltebilir, testleri çalıştırabilir ve siz kontrol halindeyken işleme yapabilir?

Question

Accepted Answer

Bir kodlama **ajanı** bir hata düzeltmesini baştan sona yönetebilir — yeniden üretme, bulma, düzeltme, doğrulama, işleme — ancak siz **kapsamlı izinler, insan onayı ve küçük geri alınabilir adımlar aracılığıyla** kontrolde kalırsınız. Ajan yazı işlemleri yapar; siz neyin gerçekten yayına alınacağına karar verirsiniz.

## Döngü

```text
1. REPRODUCE  → write/run a failing test that demonstrates the bug (red)
2. LOCATE     → search the codebase, read the relevant files, form a hypothesis
3. PROPOSE    → draft a minimal fix (you can review the plan before any edit)
4. VERIFY     → run tests + lint/typecheck → fix is proven by the test going green
5. REVIEW     → show the DIFF for your approval (nothing committed yet)
6. COMMIT     → only after approval, on a branch, with a clear message
```

Temel fikir **test odaklı doğrulama**: ajan "düzeltildi" demez — başarısız bir testi geçirerek bunu kanıtlar. Adım 1'deki başarısız test, değişikliğin işe yaradığının hedef sinyalidir.

## Kontrol mekanizmaları

```text
- SCOPED PERMISSIONS → allowlist safe commands (test, lint); prompt for the rest
- APPROVAL GATES     → human confirms destructive/irreversible actions + the final commit
- SMALL STEPS        → one focused change at a time → easy to review and revert
- BRANCH / WORKTREE   → work isolated from main; throw it away if it goes wrong
- DIFF REVIEW        → read the actual diff before commit, not just the agent's summary
```

```bash
# The agent runs the suite itself and reports the result before proposing a commit
npm test -- --runInBand   # red before the fix, green after → objective verification
git diff                  # you review every line that will be committed
```

**Bir dalda veya git worktree** çalıştırmak, en kötü durumun `git checkout main` olduğu anlamına gelir — deney hiçbir zaman çalışma durumunuza dokunmaz. Küçük, geri alınabilir işlemeler herhangi bir adımı inceleme ve geri alma açısından kolaylaştırır.

## Neden önemli

Ajanı kodlama sizi her satırı yazma işleminden **gözden geçirme ve yönlendirmeye** kaydırır. Kaldıraç gerçektir, ancak ajanın güvenle yanlış veya yıkıcı bir değişiklik göndermesi riski de vardır. İşlemelerden önce insan onayı kapısını koruması, düzyazıya güvenmek yerine testlerle doğrulama yapması ve işi bir dalda izole etmesi, otomasyonun hızını yakalarken `main`\'e neyin ulaşacağına karar veren kişi olmanıza olanak sağlar.