---
title: "Kod Tabanından Doğrulanabilir İş Kurallarına: codebase-graph-prd-rules"
url: https://blog.edumints.com/kod-tabanindan-dogrulanabilir-is-kurallarina-codebase-graph-37pilkia
category: "AI Araçları"
date: 2026-09-24T15:11:52.095Z
publisher: Edumints Blog
lang: tr-TR
source_name: "GitHub"
source_url: https://github.com/xsoway/codebase-graph-prd-rules
---

# Kod Tabanından Doğrulanabilir İş Kurallarına: codebase-graph-prd-rules

## codebase-graph-prd-rules Nedir ve Ne Yapar?
**codebase-graph-prd-rules**, karmaşık yazılım projelerinin kaynak kodlarını grafik tabanlı analiz yöntemleriyle inceleyerek doğrulanabilir, izlenebilir iş kuralları (business rules) ve ürün gereksinim dokümanlarına (PRD) dönüştüren iki gelişmiş yapay zeka ajanı becerisi (**AI-agent skill**) sunar. Bu beceriler, projenin tamamını uçtan uca ele alan genel analiz (**whole-project**) ve izole bileşenlere odaklanan modüler analiz (**single-module**) olmak üzere iki farklı kapsamda çalışır.

Sistem; kod tabanını anlamsal bir kod grafiği (**code-graph**) olarak modeller, çıkarılan her iş kuralını kaynak koddaki kanıtlarla eşleştirip derecelendirir (**evidence-graded**) ve çıktı kalitesini değerlendirme metrikleriyle (**evaluation-backed**) güvenceye alır.

## Neden Popüler ve Geliştiriciler İçin Değeri Ne?
Yazılım geliştiriciler ve ürün yöneticileri için en zorlu süreçlerden biri, dokümantasyonu eskimiş, eksik veya hiç yazılmamış kod tabanlarındaki iş kurallarını hatasız biçimde gün yüzüne çıkarmaktır. Klasik büyük dil modelleri (LLM) geniş kod tabanlarını özetlerken bağlamı kaybedebilir, varsayımlar üretebilir veya kritik uç durum (edge-case) mantıklarını atlayabilir.

`codebase-graph-prd-rules` projesi geliştiricilere şu somut avantajları kazandırır:
- **Kaynak Kanıtlı Doğrulama:** Ajan tarafından tespit edilen her bir kural; dosya yolu, fonksiyon adı ve satır referanslarıyla ilişkilendirilerek kanıt derecesine göre puanlanır.
- **Halüsinasyon Riskinin Azaltılması:** Salt metin tabanlı tahminler yerine kod grafiği üzerinden ilerleyen grafik rehberli (**graph-guided**) yaklaşım, uydurma kural üretimini engeller.
- **Tersine Mühendislik ve Dokümantasyon Hızı:** Yıllardır birikmiş teknik borç ve belgesiz eski (legacy) kodlar, günler süren manuel incelemeler yerine dakikalar içinde PRD formatına aktarılır.
- **Ajan Belleği Desteği:** `self-memory` yeteneği sayesinde ajan, analiz boyunca edindiği bağlamı hafızasında tutarak tutarlı çıktılar üretir.

## Pratik Kullanım Senaryoları
- **Karmaşık Ödeme ve Fatura Modülü Analizi:** Tek modül becerisi kullanılarak bir e-ticaret sistemindeki dinamik indirim, vergi hesaplama ve iade kuralları kaynak satırlarıyla birlikte çıkarılabilir.
- **Monolitten Mikroservise Geçiş:** Tüm proje becerisi çalıştırılarak parçalanması hedeflenen monolitik uygulamanın alan sınırları (domain boundaries) ve servis bağımlılıkları haritalandırılabilir.
- **Yazılım Geliştirici Onboarding Süreçleri:** Ekibe yeni katılan geliştiricilerin veya ürün sahiplerinin projedeki iş mantığını hızlıca kavraması için otomatik kılavuzlar oluşturulabilir.
- **Uyum ve Regülasyon Denetimi:** Finansal veya kişisel veri işleyen kritik servislerin mevzuata uygun kurallarla çalışıp çalışmadığı otomatik olarak denetlenebilir.

## Benzer Araçlarla Karşılaştırma
- **Standart LLM ve Chatbot İstemleri:** Genel yapay zeka sohbet araçları ve basit RAG boru hatları, kod bloklarını parçalara böldüğünde fonksiyon çağrı zincirlerini kaybeder. Bu proje ise kod grafiği ile çağrı hiyerarşisini korur.
- **Geleneksel Dokümantasyon Araçları (Doxygen, Sphinx):** Yalnızca kod içi yorumları, fonksiyon imzalarını ve tip tanımlarını belgeler. Arka planda çalışan karmaşık doğrulama ve karar kurallarını analiz edemez.
- **GitHub Copilot ve Cursor:** Kod tamamlama ve yerel fonksiyon açıklamasında etkilidir; ancak tüm projeyi tarayıp kanıt puanlamalı, üretime hazır resmi bir PRD dokümanı derleme hedefine odaklanmaz.

[[Orijinal kaynağa buradan ulaşabilirsiniz.](https://github.com/xsoway/codebase-graph-prd-rules)](https://github.com/xsoway/codebase-graph-prd-rules)

---

Bu konuyu derinlemesine öğrenmek isterseniz: [Production'da Agent Güvenilirliği](https://edumints.com/kesfet/production-agent-orchestration-crewai-ve-autogen-i-u3cu) modülüne göz atın.

---

**Kaynak:** [GitHub](https://github.com/xsoway/codebase-graph-prd-rules)
**Yayıncı:** [Edumints Blog](https://blog.edumints.com) · Alıntılarken bu URL'ye bağlantı verin: https://blog.edumints.com/kod-tabanindan-dogrulanabilir-is-kurallarina-codebase-graph-37pilkia