Agent-Skills.md

Agent Skills: 🔍 Debugging Methodology

Sistematik debugging döngüsü - reproduce, isolate, hypothesize, fix.

[architectureautomationbestpracticescleancodecodingcollaborationcompliancedebuggingdebuggingmethodologydesignpatternsdevelopmentdocumentationefficiencygitoptimizationproductivityprogrammingprojectmanagementqualityassurancerefactoringsoftwareengineeringstandardstestingutilitiesversioncontrolworkflow]-debugging-tools
qualityID: vuralserhat86/antigravity-agentic-skills/debugging_methodology
4212

Install this agent skill to your local

pnpm dlx add-skill https://github.com/vuralserhat86/antigravity-agentic-skills/tree/HEAD/skills/debugging_methodology

Skill Files

Browse the full folder contents for debugging_methodology.

Download Skill

Loading file tree…

skills/debugging_methodology/SKILL.md

Skill Metadata

Name
debugging_methodology
Description
Sistematik debugging döngüsü - reproduce, isolate, hypothesize, fix.

🔍 Debugging Methodology

Sistematik hata ayıklama döngüsü.

🔄 Debugging Döngüsü

REPRODUCE → UNDERSTAND → ISOLATE → HYPOTHESIZE → TEST → FIX → REFLECT

1️⃣ Reproduce

### Tekrarlama Raporu
- Hata: [Açıklama]
- Adımlar: 1. ... 2. ... 3. → Hata
- Ortam: [OS, Node, Browser]
- Tekrarlanabilirlik: [%100 / %50 / Nadiren]

2️⃣ 5 Whys

Problem: Login çalışmıyor
1. Neden? → API 401 dönüyor
2. Neden? → Token geçersiz
3. Neden? → Token expire
4. Neden? → Refresh çalışmıyor
5. Neden? → Endpoint değişmiş

3️⃣ Binary Search (git bisect)

git bisect start
git bisect bad HEAD
git bisect good v1.0.0
git bisect run npm test

4️⃣ Hipotez Listesi

| # | Hipotez | Olasılık | Test | |---|---------|----------|------| | 1 | Null pointer | %40 | console.log | | 2 | Race condition | %30 | timeout ekle |

Debugging Methodology v1.1 - Enhanced

🔄 Workflow

Kaynak: Scientific Method in Debugging

Aşama 1: Incident Response (Triage)

  • [ ] Log: Hata mesajını ve call stack'i kaydet.
  • [ ] Reproduce: Hatayı lokalde veya test ortamında en az 1 kez tekrar et.
  • [ ] Environment: Versiyon farklarını (Prod vs Dev) kontrol et.

Aşama 2: Root Cause Analysis (RCA)

  • [ ] Bisection: Sorunun başladığı commit'i bul (git bisect).
  • [ ] Isolation: Sistemi parçalara ayırarak hatayı izole et (Unit Test yaz).
  • [ ] Hypothesis: En olası nedenleri listele ve Binary Search ile ele.

Aşama 3: Resolution & Prevention

  • [ ] Fix: En az müdahale ile sorunu çözen kodu yaz.
  • [ ] Verify: Hem fix'i hem de regression (yan etki) olmadığını test et.
  • [ ] Post-Mortem: "Neden oldu?" ve "Nasıl önlenir?" sorularını yanıtla.

Kontrol Noktaları

| Aşama | Doğrulama | |-------|-----------| | 1 | "Bende çalışıyor" tuzağına düşüldü mü? (Ortam farkı kontrolü) | | 2 | Fix yaparken test yazıldı mı? (TDD) | | 3 | Benzer hatalar başka yerde var mı tarandı mı? |