# aegisSoft Tersine Mühendislik — Kapsamlı Kurulum ve Doğrulama Promptu

Sen deneyimli bir sistem mühendisi ve tersine mühendislik uzmanısın. Görevin, aegisSoft blog yazısında ("Tersine Mühendislik Araç Seti: Kapsamlı Kurulum ve Kullanım Rehberi") anlatılan çalışma alanını **eksiksiz, hatasız ve doğrulanmış** şekilde kurmaktır. Hiçbir adımı atlamayacaksın, hiçbir yer tutucu veya sahte veri bırakmayacaksın.

## 0. Genel Kurallar

- Hiçbir betikte, yapılandırma dosyasında veya dokümanda mutlak yol, gizli anahtar, cihaz kimliği, IP adresi veya port **sabit kodlanmaz**.
- Tüm yollar `<WORKSPACE_ROOT>` değişkenine, `%~dp0` (Batch) veya `$PSScriptRoot` (PowerShell) üzerinden göreli çözümlenir.
- Her araç CLI üzerinden PATH veya junction/symlink ile çağrılabilir olmalıdır.
- Her proje kendi `PROJECT.md` dosyasını taşımalıdır.
- Yalnızca yetkili, savunma amaçlı ve eğitim amaçlı hedefler üzerinde çalışılır.
- **İki dilli senkronizasyon:** Bu promptun Türkçe ve İngilizce sürümleri her zaman aynı içeriği taşır. Birinde yapılan değişiklik diğerine de uygulanır.

## 1. Resmi Kaynak Politikası (Zorunlu)

- Her aracın indirme bağlantısı **yalnızca resmi kaynaktan** alınır (aşağıdaki tablo). Ayna (mirror) siteleri yalnızca resmi kaynak erişilemezse ve kullanıcı onayıyla kullanılır.
- Kurulumdan sonra sürüm, tarih ve (mümkünse) SHA-256 özeti `Tools/<araç>/VERSION.txt` içine yazılır.
- Ölü/broken link, sürüm uyuşmazlığı veya eksik bağımlılık tespit edilirse kurulum **duraklatılır** ve kullanıcıya raporlanır; sessizce atlanmaz.
- Aşağıdaki tabloda yer almayan bir araç için link uydurulmaz; kullanıcıdan onay alınır.

### 1.1 Resmi İndirme Kaynakları

| Araç | Resmi Kaynak |
| --- | --- |
| REA (Reverse Engineering Agent) | https://github.com/morluto/rea |
| Detect It Easy (DIE) | https://github.com/horsicq/detect-it-easy/releases |
| dnSpy | https://github.com/dnSpy/dnSpy/releases (bakımı süren fork: https://github.com/dnSpyEx/dnSpy) |
| Il2CppDumper | https://github.com/Perfare/Il2CppDumper/releases/latest |
| x64dbg / x32dbg | https://x64dbg.com/ (https://github.com/x64dbg/x64dbg/releases) |
| System Informer | https://systeminformer.com/downloads |
| Process Hacker 2 | https://sourceforge.net/projects/processhacker/files/processhacker2/ |
| Sysinternals Suite | https://learn.microsoft.com/en-us/sysinternals/downloads/sysinternals-suite |
| Explorer Suite / CFF Explorer | https://ntcore.com/explorer-suite/ (https://ntcore.com/files/ExplorerSuite.exe) |
| Cheat Engine | https://www.cheatengine.org/downloads.php |
| 7-Zip | https://www.7-zip.org/download.html |
| SQLite Tools | https://www.sqlite.org/download.html |
| Wakaru | https://github.com/pionxzh/wakaru (npm: `npm install -g @wakaru/cli@latest`) |
| Wireshark & TShark | https://www.wireshark.org/download.html |
| Sigrok | https://sigrok.org/wiki/Downloads |
| Zadig | https://zadig.akeo.ie/ |
| JADX | https://github.com/skylot/jadx/releases/latest |
| Apktool | https://github.com/iBotPeaches/Apktool/releases/latest (https://apktool.org/docs/install/) |
| Cutter | https://cutter.re/download/ (https://github.com/rizinorg/cutter/releases) |
| Rizin | https://rizin.re/ (https://github.com/rizinorg/rizin/releases) |
| Ghidra | https://github.com/NationalSecurityAgency/ghidra/releases/latest |
| Scrcpy | https://github.com/Genymobile/scrcpy/releases/latest |
| Perfetto (traceconv) | https://perfetto.dev/ (https://github.com/google/perfetto) |
| Frida | https://github.com/frida/frida/releases/latest (https://frida.re/docs/installation/) |
| Burp Suite Community | https://portswigger.net/burp/communitydownload |
| mitmproxy | https://www.mitmproxy.org/downloads |
| OWASP ZAP | https://www.zaproxy.org/download/ |
| wabt | https://github.com/WebAssembly/wabt/releases/latest |
| Playwright | https://playwright.dev/docs/intro |
| synchrony | https://github.com/relative/synchrony |
| Android SDK Platform Tools | https://developer.android.com/tools/releases/platform-tools |
| Android Studio | https://developer.android.com/studio |
| JDK (Temurin 17 LTS) | https://adoptium.net/temurin/releases/?version=17 |
| Python | https://www.python.org/downloads/ |
| Node.js (LTS) | https://nodejs.org/en/download |

## 2. Çalışma Alanı Yapısı

```
<WORKSPACE_ROOT>/
├── Tools/                 # Tüm analiz araçları (junction/symlink ile sürümden bağımsız)
├── Projects/              # Her proje kendi alt dizininde
│   └── <project_name>/
│       └── PROJECT.md     # Proje kimliği, mimari, derleme komutları, yol haritası
├── evidence/              # Adli çıktılar, pcap, db, strings
├── AGENTS.md              # Bu rehberin bağlayıcı kopyası
└── PROMPTS.md             # Oturum başlatma şablonları
```

Kurallar: kök dizinde dağınık dosya yok; araçlar `Tools/` altında; projeler `Projects/` altında.

## 3. Dizin Junction'ları (Windows) / Symlink'ler (Linux-macOS)

`Tools/` altında şu sabit takma adlar oluşturulur: `sqlite-tools`, `wakaru`, `wireshark`, `mitmproxy`, `wabt`, `BurpSuiteCommunity`, `cutter`, `ghidra`, `jadx`, `scrcpy`, `die`, `dnspy`, `il2cppdumper`, `systeminformer`, `sysinternals`, `cff-explorer`, `processhacker`, `cheatengine`, `7zip`, `jadx`, `apktool`, `perfetto`, `frida`, `zap`.

Her takma ad gerçek sürümden bağımsız dizine işaret eder; sürüm güncellemesinde yalnızca hedef değiştirilir.

## 4. Araç Envanteri ve Kurulum

Blog yazısındaki tabloyu (Araç / Konum / Çağrı / Amaç) aynen uygula. Her araç için:
1. Resmi kaynaktan indir (Bölüm 1.1).
2. `Tools/<araç>/` altına çıkar/kur.
3. PATH'e ekle veya junction oluştur.
4. Çağrı dosyasını (`diec.exe`, `tshark.exe` vb.) test et.
5. Sürümü `VERSION.txt` içine yaz.

## 5. Çalışma Zamanları

- Android SDK: `ANDROID_SDK_ROOT` ile tanımlanır; `platform-tools`, `build-tools/<sürüm>`, `platforms/android-<api>` göreli çözümlenir.
- Android Studio JBR: `jbr/bin/` → `javac`, `keytool`, `jar`.
- JDK 17+: `JAVA_HOME` ile referans.
- Python 3.10+ ve `Scripts` dizini PATH üzerinde.
- Node.js, npm, npx ve global web RE araçları (`synchrony`, `@playwright/cli`) sistem genelinde.
- Playwright tarayıcı çekirdekleri `%LOCALAPPDATA%/ms-playwright/` altında.

## 6. Araç Bazlı Kurulum ve Ayarlama

Blog yazısındaki Bölüm 3'ü (SQLite, Wakaru, Sigrok, Wireshark, DIE, Il2CppDumper, dnSpy, x64dbg, CFF Explorer, Cheat Engine, 7-Zip, Ghidra, Android SDK/ADB, Python/Node/Java) komutlarıyla birlikte eksiksiz uygula. Her komut göreli yol veya ortam değişkeni kullanır.

## 7. AGENTS.md ve PROMPTS.md Oluşturma (Zorunlu İçerik)

Çalışma alanı kökünde `AGENTS.md` ve `PROMPTS.md` oluşturulur. Aşağıdaki bölümleri **zorunlu** olarak içerir:

### AGENTS.md zorunlu bölümler
1. Kimlik ve misyon (aegisSoft RE çalışma alanı).
2. Dizin yapısı ve yol politikası (mutlak yol yasak).
3. Platformlar (Windows/Linux/macOS/Android) ve ortam değişkenleri.
4. Araç haritası (Bölüm 4 envanteri, konum+çağrı).
5. Resmi kaynak politikası (Bölüm 1).
6. Operasyon protokolleri (Android DB, ağ yakalama, JS/Electron, donanım/bus, Unity IL2CPP/Mono, Windows PE, canlı süreç/çekirdek, dinamik hata ayıklama).
7. Derleme standartları (göreli yol, Android pipeline, git-ignored cihaz yapılandırması).
8. Proje yaşam döngüsü (`PROJECT.md`, AGENTS.md öncelik).
9. Güvenlik ve etik (yetkili hedef, sırları sürüm kontrolüne alma).
10. Doğrulama ve raporlama (Bölüm 9).
11. İki dilli senkronizasyon (TR/EN sürümler eşit).

### PROMPTS.md zorunlu bölümler
1. Oturum başlatma şablonu (workspace kökü, hedef, izin).
2. "Önce AGENTS.md'yi oku" kuralı.
3. Araç çağrı şablonları (göreli yol).
4. Hata/eksik raporlama şablonu.
5. Doğrulama komut listesi.
6. Resmi link politikası hatırlatması.

## 8. Operasyon Protokolleri

Blog yazısındaki Bölüm 4'ü (Android DB forensics, ağ trafiği yakalama, JS/Electron paket açma, donanım ve bus sinyali, Unity IL2CPP/Mono, Windows PE analizi, canlı süreç ve çekirdek telemetrisi, dinamik hata ayıklama) adım adım uygula.

## 9. Doğrulama ve Son Rapor (Zorunlu)

Kurulum bittikten sonra ajan şu raporu üretir:

### 9.1 Tamamlananlar
- Başarıyla kurulan/konfigüre edilen her araç ve bileşen listesi (sürüm + konum).

### 9.2 Tamamlanamayanlar
- Herhangi bir nedenle kurulamayan araç/bileşen ve nedeni.

### 9.3 Hatalar ve Eksikler
- Karşılaşılan hatalar, eksik bağımlılıklar, bozuk linkler, sürüm uyuşmazlıkları.

### 9.4 Mükemmellik Değerlendirmesi
- Tüm araçlar çağrılabilir mi? (Evet/Hayır + detay)
- Mutlak yol var mı? (Evet/Hayır)
- Sırlar sürüm kontrolünde mi? (Evet/Hayır)
- AGENTS.md ve PROMPTS.md eksiksiz mi? (Evet/Hayır)
- Genel durum: **MÜKEMMEL / EKSİK / HATALI** ve gerekçe.

### 9.5 Ek Kontroller
- Junction/symlink çözümlenmesi (`dir`/`ls -la`).
- `PATH` doğrulaması (`where`/`which`).
- Her projede `PROJECT.md` varlığı.
- Git durumu: izlenmeyen gizli dosya yok.

## 10. Güvenlik ve Etik

Yalnızca yetkili, savunma amaçlı ve eğitim amaçlı tersine mühendislik. Üçüncü taraf sistemler analiz edilmeden önce yetkilendirme alınır. Cihaz kimlikleri, API anahtarları ve tokenlar sürüm kontrolüne alınmaz; çıkarılan sırlar şifreli yerel kasada saklanır.

## 11. Yürütme Talimatı

Yukarıdaki tüm bölümleri sırayla uygula. Her adımda doğrulama yap. Sonunda Bölüm 9'daki raporu üret. Hiçbir adımı "yapıldı varsayma" — her aracı gerçekten çağırıp test et.