Bu proje boyunca aşağıdaki skill'leri zorunlu olarak kullan. Her skill'i kullanmadan önce ilgili SKILL.md dosyasını oku ve o yönergelere göre hareket et.
Her yeni modül veya faz başlamadan önce:
- @brainstorming → gereksinimi netleştir
- @writing-plans → o faz için detaylı execution planı yaz
- İlgili kod skill'ini uygula (aşağıya bak)
- @test-driven-development → kodu yazmadan önce testi yaz
- @verification-before-completion → faz bitmeden doğrulama koştur
- @python-patterns → tüm .py dosyalarında zorunlu (Type hint, docstring, logging, single responsibility)
- @systematic-debugging → parse hataları ve geometri sorunları için
- @test-driven-development → her analyzer modülü için
- @planning-with-files → çok dosyalı pipeline koordinasyonu için
- @python-patterns → hesap motorları için
- @xlsx → openpyxl pivot tablo + chart üretimi için
- @pdf → ReportLab metraj raporu için
- @data-engineering → pandas DataFrame pipeline'ı için
- @python-patterns → rule_engine ve checker'lar için
- @prompt-engineer → TBDY/TS500 kontrol prompt şablonları için
- @doc-coauthoring → kural açıklamaları ve PDF uygunluk raporu için
- @rag-engineer → Claude API + JSON structured output için
- @prompt-engineer → mühendislik prompt şablonları için
- @project-development → AI pipeline mimarisi için
- @context-optimization → conversation history ve token yönetimi için
- @workflow-automation → watchdog + pipeline orchestrator için
- @api-design → FastAPI endpoint tasarımı için
- @docker-expert → servis paketleme ve deployment için
- @verification-before-completion → API testleri için
(@python-patterns skill'inden türetilmiş, her dosyada zorunlu)
- Her fonksiyon/sınıf için Type hint
- Her public metod için Google-style docstring
- logging.getLogger(name) ile modül bazlı loglama
- Config değerleri asla hardcode edilmez → config.yaml'dan okunur
- Her modül kendi exception sınıfını tanımlar
- Büyük veri işlemlerinde generator kullan (lazy loading)
(@test-driven-development skill'inden türetilmiş)
- Önce test yaz, sonra implementasyon
- Her public metod için en az 1 happy path + 1 edge case test
- Fixture olarak generate_test_dxf.py kullan
- pytest -v --tb=short --cov=src ile coverage %80 altına düşme
(@verification-before-completion skill'inden türetilmiş)
Her faz tamamlanmadan şunları koştur:
- python -m pytest tests/ -v
- python main.py --input output/test_sample.dxf --format all
- İlgili çıktı dosyalarının varlığını kontrol et
- Bir sonraki faza geçmeden önce onay iste
Eğer projeye özel bir yetenek gerekirse (örneğin TBDY kural motoru için özel bir skill):
- @skill-creator skill'ini kullan
- Yeni skill'i .agent/skills/tbdy-checker/ altına kaydet
Hazır mısın? İlk olarak @brainstorming ile Faz 1 gereksinimlerini netleştirelim, ardından @writing-plans ile execution planını yazalım.