File contents 🔍 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)
Aşama 2: Root Cause Analysis (RCA)
Aşama 3: Resolution & Prevention
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ı?
1 --- 2 name: debugging-methodology 3 description: 🔍 Debugging Methodology 4 --- 5 6 # 🔍 Debugging Methodology 7 8 > Sistematik hata ayıklama döngüsü. 9 10 --- 11 12 ## 🔄 Debugging Döngüsü 13 14 ``` 15 REPRODUCE → UNDERSTAND → ISOLATE → HYPOTHESIZE → TEST → FIX → REFLECT 16 ``` 17 18 --- 19 20 ## 1️⃣ Reproduce 21 ```markdown 22 ### Tekrarlama Raporu 23 - Hata: [Açıklama] 24 - Adımlar: 1. ... 2. ... 3. → Hata 25 - Ortam: [OS, Node, Browser] 26 - Tekrarlanabilirlik: [%100 / %50 / Nadiren] 27 ``` 28 29 --- 30 31 ## 2️⃣ 5 Whys 32 33 ```markdown 34 Problem: Login çalışmıyor 35 1. Neden? → API 401 dönüyor 36 2. Neden? → Token geçersiz 37 3. Neden? → Token expire 38 4. Neden? → Refresh çalışmıyor 39 5. Neden? → Endpoint değişmiş 40 ``` 41 42 --- 43 44 ## 3️⃣ Binary Search (git bisect) 45 46 ```bash 47 git bisect start 48 git bisect bad HEAD 49 git bisect good v1.0.0 50 git bisect run npm test 51 ``` 52 53 --- 54 55 ## 4️⃣ Hipotez Listesi 56 57 | # | Hipotez | Olasılık | Test | 58 |---|---------|----------|------| 59 | 1 | Null pointer | %40 | console.log | 60 | 2 | Race condition | %30 | timeout ekle | 61 62 --- 63 64 *Debugging Methodology v1.1 - Enhanced* 65 66 ## 🔄 Workflow 67 68 > **Kaynak:** [Scientific Method in Debugging](https://queue.acm.org/detail.cfm?id=1839676) 69 70 ### Aşama 1: Incident Response (Triage) 71 - [ ] **Log**: Hata mesajını ve call stack'i kaydet. 72 - [ ] **Reproduce**: Hatayı lokalde veya test ortamında en az 1 kez tekrar et. 73 - [ ] **Environment**: Versiyon farklarını (Prod vs Dev) kontrol et. 74 75 ### Aşama 2: Root Cause Analysis (RCA) 76 - [ ] **Bisection**: Sorunun başladığı commit'i bul (`git bisect`). 77 - [ ] **Isolation**: Sistemi parçalara ayırarak hatayı izole et (Unit Test yaz). 78 - [ ] **Hypothesis**: En olası nedenleri listele ve Binary Search ile ele. 79 80 ### Aşama 3: Resolution & Prevention 81 - [ ] **Fix**: En az müdahale ile sorunu çözen kodu yaz. 82 - [ ] **Verify**: Hem fix'i hem de regression (yan etki) olmadığını test et. 83 - [ ] **Post-Mortem**: "Neden oldu?" ve "Nasıl önlenir?" sorularını yanıtla. 84 85 ### Kontrol Noktaları 86 | Aşama | Doğrulama | 87 |-------|-----------| 88 | 1 | "Bende çalışıyor" tuzağına düşüldü mü? (Ortam farkı kontrolü) | 89 | 2 | Fix yaparken test yazıldı mı? (TDD) | 90 | 3 | Benzer hatalar başka yerde var mı tarandı mı? |
commit 2e2e122008
Frequently asked questions How do I install the Debugging Methodology skill? Run npx skillmds@latest add vuralserhat86/debugging-methodology in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Debugging Methodology skill do? 🔍 Debugging Methodology It is listed under Coding & Dev Tools on SkillMD.
Is Debugging Methodology safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Debugging Methodology? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Debugging Methodology free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Debugging Methodology? vuralserhat86 (@vuralserhat86) published this skill. Their other Agent Skills are listed on their SkillMD profile.
vuralserhat86