İskele — Kullanım Kılavuzu (TR)

Bu kılavuz, skill’in yedi adımlı döngüsünün Türkçe anlatımıdır. Normatif kaynak skill’in kendisidir: skill/iskele/SKILL.md. İngilizce karşılığı: ../en/usage-guide.md.

Kurulum

cp iskele.skill ~/.claude/skills/
pip install -r skill/iskele/scripts/requirements.txt

Yedi adım — özet

Zinciri kurmak

Çizelgeyi üret

python skill/iskele/scripts/backlog_to_tracker.py \
  --backlog 03-gorev-listesi.md --out tracker.xlsx --config iskele.config.json

Backlog satır formatı (parser bunu arar):

### Epik F1.2 — Süreç & adım
- [ ] **F1-BE-04** (M) Süreç CRUD API. **Bağ.:** F1-BE-02, F1-BE-03
  - *Kabul:* Yetki kontrolüyle çalışır; yetkisiz istek 403 alır.

Kurallar:

• ID benzersiz olmalı — mükerrer ID uyarı üretir.
• Tahmin (S), (M) veya (L).
• Bağ.: yoksa — yaz; boş bırakma.
• Kabul kriteri koşulabilir olmalı.

Çizelgede ne elle doldurulur

Ozet sekmesi COUNTIF/COUNTIFS formülleriyle çalışır — oraya elle sayı yazma, formülü bozarsın.

Raporu yeniden üret

python skill/iskele/scripts/progress.py \
  --xlsx tracker.xlsx --html 07-ilerleme-raporu.html --config iskele.config.json

• --check — yazmaz, hesaplanan özeti basar.
• --self-test — gömülü regresyon testlerini koşar.
• --force — hatalara rağmen yazar (önerilmez; sessiz yanlış gösterge üretir).

Script yalnız GEN:...:BEGIN / GEN:...:END arasını yeniden yazar. Raporun gerisini rahatça elle düzenleyebilirsin.

Efor-ağırlıklı ilerleme

ilerleme % = Σ(tamamlanan görevlerin eforu) / Σ(tüm görevlerin eforu)

Varsayılan ağırlıklar S=0.75 · M=1.5 · L=4 (iş-günü). Değiştireceksen üç yerde birden değiştir: backlog ölçeği, iskele.config.json, rapor dipnotu.

Kredi kuralı. Varsayılan ikilidir: yalnız Tamamlandi kredi alır. Devama kısmi kredi vermek ilerlemeyi şişirir ve “neredeyse bitti” yanılsaması üretir; vereceksen bilinçli yap ve rapora yaz.

Döngünün v1.x ile kazandıkları

Yukarıdaki yedi adım sabit çekirdektir. Bunlar onun üstüne eklendi, her biri gerçek bir projede görülmüş bir hatadan; normatif metin SKILL.md ve onun adlandırdığı referanslardır.

• Kabul kriteri tüketim tarafından yazılır — “sistem X üretir” değil, “kullanıcı X’e ulaşır”. Üretim tarafı bir kriter, yetenek erişilemez olsa bile geçer. Ve üreten görev tüketen ikizini adlandırır: kullanıcının göreceği bilgiyi üreten her görev ya okuma yüzeyini kendi kriterinde taşır ya da onu getiren görevin kimliğini yazar (→ F3-FE-03). Backlog’u katmana göre kesmek bu boşluğu varsayılan yapar.
• Kapıda senaryo provası — DoD’nin ve go/no-go’nun göremediği seviye: alanın gerçek durumları modelde ifade edilebiliyor mu (ifade edilebilir, yazılı bir sınır ya da bir bulgu), ve iki özellik aynı anda aktifken kimin güvencesi kırılır? Cevap çizelgenin Cift sayfasında yaşar, her çift için bir satır; rapor onu GEN:CIFT olarak basar ve bakılmamış çiftleri ayrıca sayar. Senaryoları alan sahibi verir ve faz açılırken yazılırlar, kapıya varınca değil.
• Go/no-go’da check_adr.py — parça 06‘daki ADR zincirini doğrular: durum sözlüğü, çözülen ileri işaretçiler, supersede tutarlılığı ve her kararın tarttığı seçenekleri listelemesi.
• Parça 11, AGENTS.md — makineye dönük tabela: bu proje ne, her kural nerede yaşıyor, ne yasak.
• Okuma yüzeyi küçük kalır — ADR günlüğü üretilmiş tek satırlık bir indeksten okunur, kapanan fazlar arsiv/ klasörüne taşınır (taşınır, asla silinmez). Arşivlemek bir okuma kararıdır, kapsam kararı değil: yüzde her durumda çizelgeden gelir.
• Beklenti farkı — isteğe bağlı GercekEfor sütunu (geçen süre değil, gerçekten çalışılan efor) gerçek / tahmini efor oranını verir, ve config’teki estimate_basis bu sayının ne diye adlandırılabileceğine karar verir (varsayılan unknown). Birim maliyet iki paydayla raporlanır, ve tools/session_cost.py yerel Claude Code dökümlerinden gerçek token kullanımını toplar — bir oturumu bir göreve atamak insan hükmü olarak kalır, [H] ile işaretlenir.
• Devir iki yönde de dosyadır — iskele_to_registry.py backlog’u Mizan önkayıtlarına, kiyas_to_backlog.py Kıyas tohumlarını görevlere çevirir, iskele_results.py ise tamamlanan görevleri registry’ye sonuç olarak geri yazar. Yalnızca ekler ve tier’ı asla değiştirmez: terfi başkasının kararıdır.

Kırmızı çizgiler

• Sahte kesinlik. Tahmini hassas sayı gibi sunma; tabanını ve kalibresiz olduğunu söyle, ilk faz gerçekleşince yeniden kalibre et.
• Mutlu-yol doğrulaması. “Doğruladım” demeden önce hangi girdiyle sorusunu cevapla; en az bir kenar durum dene.
• Sessiz varsayım. Üreteç bilinmeyen değeri sessizce varsayılana düşürmesin; görünür uyarı ver ya da yazma.
• Faz atlama ve kapsam sürüklenmesi. Kapı geçilmeden sonraki faza geçme; “kapsam dışı”nı açıkça yaz.
• Kendi işini denetleme. Kiti sen ürettiysen denetimi de sen yapıyorsan hakem = yazar; bunu beyan et.
• Uydurma sayı. Rapordaki her sayı ya hesaplanmıştır ya tahmin olarak işaretlidir.

Sık karşılaşılan tuzaklar

ı/i katlaması. Karışık Türkçe/İngilizce veride büyük/küçük harf dönüşümü platforma göre değişir. Yapısal adları (sekme, sütun, ID) ASCII tut; hücre içeriği Türkçe olabilir.

“Kısmen bitti” görevler. Bir görev kısmen bitebiliyorsa fazla büyüktür; böl. Aksi hâlde çizelge bir yalanı taşır ve rapor onu yüzdeye çevirir.

Çizelgeyi elle senkron tutmak. Backlog değiştiyse üreteci koştur. İki kaynağı elle eşit tutma girişimi hep sapmayla biter.