atdd

Files (1)

• SKILL.md

SKILL.md (first lines)

# ATDD Skill

> **KURAL: Netleştirme soruları kullanıcıya değil, otomatik yanıtlanır.**
> `AskUserQuestion` bu skill'de artık KULLANILMAZ — aşağıdaki 4z adımı
> soruları doğrudan bir **Sonnet 5 alt-ajanına** (`Agent`, `model: "sonnet"`,
> `reasoning_effort: "low"`) dispatch eder. Kullanıcı hiç durdurulmaz.
> `claude-omni`/OmniRoute bu akıştan tamamen çıkarıldı (2026-09-05) —
> işlevsizdi (kurulum/child-process/kredi sorunları canlı olarak tekrar
> tekrar tespit edildi) ve fallback zaten her seferinde Sonnet 5'e
> düşüyordu. Cevaplar atdd.md'ye "Sonnet 5 alt-ajanı tarafından yanıtlandı"
> notuyla işlenir — kullanıcı cevabıymış gibi gizlenmez.

## Kullanılacak destek skiller
- `caveman`, `ponytail` (full) — her zaman aktif.
- `superpowers:brainstorming` — kapsam belirsizse, 8-12 soruluk soru listesini hazırlamadan önce.

Bu skill, sonraki pipeline adımlarının (`plan`/`code-copilot`/`test-copilot`/
`verify`/`red-team`) referans aldığı **tek gerçek kaynağı** (`atdd.md`)
üretir. Tek işi budur — Jira senkronizasyonu **`jira-sync`** skill'inde, 
Saga senkronizasyonu **`saga`** skill'inde, adımlar arası geçiş **`pipeline`** 
skill'indedir. Bu araçları karıştırma: burada doğrudan Jira/Saga çağrısı 
yapma (bunun yerine ilgili skill'i çağır), burada bir sonraki skill'e otomatik geçme.

## Adımlar

0. **Fast-Track Kontrolü:** Görev çok küçük, basit ve düşük riskliyse (örn. yazım hatası, CSS renk değişimi, ufak linter düzeltmesi), ATDD sürecini BAŞLATMA. Doğrudan `fast-track` skill'ine devret.
1. **Görev slug'ı belirle.** Kullanıcının isteğinden kısa bir `kebab-case`
   slug türet (örn. `pdf-export-butonu`). Kullanıcıya onaylat.
2. **Jira veya Saga bağlamı gerekiyorsa ilgili skill'i (`jira-sync` veya `saga`) çağır, kendin sorgulama.**
   - Kullanıcı bir Jira ID verdiyse (örn. "KAN-14'ten devam") önce `jira-sync`
     ile issue'yu çek, dönen bilgiyi (özet, AC, öncelik, `saga_task_id`) burada kullan.
   - Kullanıcı bir Saga ID verdiyse (örn. "Saga #254'ten devam") `saga` skill'ini
     çağırarak (özellikle `mcp__saga__task_get` üzerinden) task'ın güncel bilgilerini
     (title, description, priority vs.) çekip burada kullan. İkinci kez sorgu atma.
   - **Ne Jira ne Saga ID'si verilmediyse (yerel/yeni görev) — yine de bir
     Saga task'ı olmalı, yoksa oluştur.** `mcp__saga__task_list` (veya
     `tracker_search`) ile bu task-slug için zaten bir Saga kaydı var mı
     kontrol et; yoksa `mcp__saga__task_create` ile aç. Başlık formatı
     **zorunlu**: `<proje klasörü adı> - <görev başlığı>` (örn.
     `linkedin - omniroute-ayri-profil`). Dönen `task_id`'yi atdd.md'nin
     frontmatter'ına (`saga_task_id`) yaz — bu, uzun bir pipeline sohbeti
     yarıda kesilip yeni bir sohbette devam edilmek zorunda kalırsa (bkz.
     `pipeline` skill'inin "context doldu" notu) ilerlemenin kaybolmaması
     içindir.
3. **Kullanıcının mesajında zaten netleşmiş kategorileri tespit et.** Aşağıdaki
   9 kategoriyi gözden geçir; kullanıcı bir kategoriyi zaten somut ve
   belirsizlik bırakmayacak şekilde yanıtlamışsa (mesajında veya jira-sync'in
   getirdiği AC'lerde) o kategori için **yeniden sorma** — mevcut bilgiyi
   "Sorular ve Cevaplar" bölümüne `(kullanıcı mesajından)` notuyla yaz.
4. **Adaptif olarak 8-12 soru sor** (minimum 8, maksimum 12 — kaç kategori
   zaten netse o kadar az sor, hiçbiri netse üst sınıra çık). Kategoriler:
   - Kullanıcı rolü / persona ("kim kullanacak?")
   - Ana hedef / "neden" (bu özellik hangi sorunu çözüyor?)
   - Happy path senaryosu (adım adım, somut girdi/çıktı)
   - En az 2 edge case / hata senaryosu
   - **Davranış sözleşmesi: hangi durumda ne dönecek** (aşağıda 4a —
     bu kategori atlanamaz, "hata olursa hata döner" cevabı kabul edilmez)
   - Başarı ölçütü / benchmark (ölçülebilir: süre, doğruluk, coverage,
     performans, hata oranı vb. — sayısal hedef iste, "iyi olsun" yetmez)
   - Kapsam dışı (explicitly out of scope — ne YAPILMAYACAK)
   - Bağımlılıklar / etkilenen mevcut dosyalar-modüller
   - Performans/güvenlik kısıtı varsa
   - Geri dönüş/rollback beklentisi (hata olursa ne olmalı)
   - Kabul kriteri sahibi kimin onayı yeterli (kullanıcı mı, otomatik test mi)
   - Test stratejisi oranı (unit/integration/e2e yüzdeleri) — kullanıcı
     bilmiyorsa proje tipine göre makul bir varsayılan öner (örn. backend
     API: 70/20/10) ve onaylat, "belirtilmedi" bırakma
   - Bilinen riskler/varsayımlar/bilinmeyenler (varsa)

4z. **Soruları Sonnet 5 alt-ajanına (low reasoning effort) dispatch et —
   `AskUserQuestion` YOK.**
   4. adımdaki soru listesini kullanıcıya sorma. Prompt'u hazırla:

   ```
   Aşağıdaki özellik için ATDD netleştirme sorularını YANITLA.
   BU BİR ARAŞTIRMA GÖREVİ DEĞİL — hiçbir tool (Read/Grep/Glob/
   WebSearch/Bash vb.) KULLANMA, kod tabanını tarama. SADECE aşağıda
   verilen bağlamdan en makul cevabı seç/üret. Bağlam yetersizse bile
   araştırmaya başlama — en makul varsayımı gerekçesiyle yaz.
   Her soru için en makul/varsayılan seçeneği seç (veya seçenek yoksa
   kısa bir cevap üret), 1 cümlelik gerekçeyle. Kullanıcının orijinal
   isteği: <kullanıcının mesajı>. Proje bağlamı: <atdd.md'nin
   task_slug'ı, ilgiliyse jira-sync/plan.md'den gelen özet>.
   Sorular:
   1. <soru 1 + varsa seçenekler>
   2. ...
   Yanıt formatı: her soru için 'N. <seçilen cevap> — <gerekçe>'.
   ```

   ```
   Agent({
     description: "Answer ATDD clarification questions for <task-slug>",
     subagent_type: "general-purpose",
     model: "sonnet",
     reasoning_effort: "low",
     run_in_background: false,
     prompt: "<yukarıdaki prompt, birebir>"
   })
   ```
   Cevaplar "Sorular ve Cevaplar" bölümüne `(Sonnet 5 low alt-ajanı
   tarafından yanıtlandı: <gerekçe>)` notuyla işlenir — kendi başına
   değiştirme/yeniden yorumlama. Sonuç, taslak doldurulurken 5. adımda
   kullanılır, kullanıcı cevabı gibi gösterilmez.

   İstisna: kullanıcı mesajında zaten net bir cevap varsa (3. adım), o
   kategori için alt-ajana SORULMAZ, doğrudan `(kullanıcı mesajından)`
   notuyla kullanılır — gereksiz Sonnet 5 çağrısı yapılmaz.

4a. **Davranış sözleşmesini tablo olarak çıkar — zorunlu adım.**

   Belirsiz bırakılan hata davranışı, bu boru hattının en pahalı hata
   sınıfını üretiyor: **başarı bildiren ama hiçbir şey yapmayan çağrı.**
   2026-08-16'da Codex köprüsünde birebir bu yaşandı — `write_code()`
   `success: True` döndürdü, tek dosya bile değişmemişti; sonraki adım buna
   güvenip üstüne inşa edecekti. Sözleşme yazılmadığı için "hiçbir şey
   yazamadım" durumunun ne dönmesi gerektiği hiç kararlaştırılmamıştı.

   Her yeni özellik/fonksiyon/uç için şu tabloyu doldur. Satırları sen
   önerirsin, 4z adımındaki Sonnet 5 low alt-ajanı çağrısına bu tabloyu da

From yutronax/atdd-pipeline-skills, MIT.

More from yutronax/atdd-pipeline-skills