როგორ შეიძლება კოდირების აგენტმა შეასწოროს ბაგი, გაუშვას ტესტები და კომიტი გააკეთოს, რომ თქვენ კონტროლში დარჩეთ?

Question

Accepted Answer

კოდირების **აგენტი** შეიძლება ბაგის შესწორება end-to-end-ით გაიტეხოს — აღმოჩენა, განლოკალიზება, შესწორება, გადამოწმება, კომიტი — მაგრამ თქვენ კონტროლში დაჯდებით **შეზღუდული ნებართვების, ადამიანის დამტკიცების და მცირე შექცევადი ნაბიჯების** საშუალებით. აგენტი აკეთებს დაკრეფას; თქვენ გადაწყვეტთ, რა ფაქტიურად მოდის.

## მარყუჟი

```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
```

ძირითადი იდეა არის **ტესტ-მოწოდებული გადამოწმება**: აგენტი არ ამტკიცებს "გაასწორა" — ის ამას აამბობს ჩავალდებული ტესტის გაშვებით. პირველი ნაბიჯიდან ჩავალდებული ტესტი არის ობიექტური სიგნალი იმისა, რომ ცვლილება ამოქმედდა.

## კონტროლის მეკანიზმები

```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
```

**ტოტში ან git worktree-ში** გაშვება ნიშნავს, რომ ყველაზე ცუდი შემთხვევა არის `git checkout main` — ექსპერიმენტი არასდროს შェხო თქვენი სამუშაო მდგომარეობა. მცირე, შექცევადი კომიტები ყველა ერთ ნაბიჯს ადვილი ინსპექციისა და გაუქმების გაკეთებას ხდიან.

## რატომ აქვს მნიშვნელობა

Agentული კოდირება გადაძვრის თქვენ ყველა ხაზის დაკრებიდან **მიმოხილვასა და სტიკლირებამდე**. ზღვრული გამოყენება რეალური, მაგრამ აგენტის რისკი აფიციოზურად შექმნილი არასწორი ან დესტრუქტიული ცვლილების ერთეულად არის. ადამიანის დამტკიცების კარიბჭე კომიტებამდე, ტესტებით გადამოწმება მხოლოდ პროზაზე ნდობის მაგივრად და სამუშაოს ტოტში იზოლირება გაძლევთ ავტომატიზაციის სიჩქარის აღებას, რომელიც `main`-ს მიმართ გადაწყვეტილებას იღებთ.