goat-fable

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 61 Open GitHub ↗

Behavior pack that runs Claude Opus 4.8 with Fable 5's working discipline: operating core, skills, subagents, hooks, API prompts, and a behavioral eval kit.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![License: MIT](https://img.shields.io/badge/license-MIT-4ade80?style=flat-square)](https://raw.githubusercontent.com/goatstarter/goat-fable/main/LICENSE)
[![Target](https://img.shields.io/badge/target-Claude%20Opus%204.8-3b82f6?style=flat-square)](https://platform.claude.com/docs/en/about-claude/models/whats-new-claude-4-8)
[![Distilled by](https://img.shields.io/badge/distilled%20by-Fable%205-a855f7?style=flat-square)](https://www.anthropic.com/news/claude-fable-5-mythos-5)
[![Version](https://img.shields.io/badge/version-0.1.0-8b98a9?style=flat-square)](https://raw.githubusercontent.com/goatstarter/goat-fable/main/CHANGELOG.md)

**Claude Opus 4.8'i Fable 5'in çalışma disipliniyle çalıştıran davranış paketi.** 
Operating core, skill'ler, subagent'lar, hook, API promptları ve kendi reponda ölçmen için bir eval kiti.

[Davranış farkı](#fark) · [Mimari](#mimari) · [Kurulum](#kurulum) · [Eval](#eval) · [English](#english)

</div>

---

<a name="fark"></a>
## Davranış farkı: altı somut örnek

Aynı model, aynı görev. Değişen tek şey davranış katmanı:

| Durum | Opus 4.8 (varsayılan) | Opus 4.8 + Goat Fable |
|---|---|---|
| **"Bitti mi?"** | *"Should work now."* | *"`auth.spec` 14/14 geçti, koşu çıktısı aşağıda. S3 hata branch'i doğrulanmadı: lokalde simüle edilemiyor, bunu belirtiyorum."* |
| **Zor bug** | Crash'in olduğu satıra null check, "fixed" | Repro kurar → mekanizmayı tek cümleyle açıklar → kaynağında düzeltir → repro'yu yeşil gösterir → aynı hatanın kardeşlerini grep'ler |
| **4 maddelik istek** | 1 ve 2 parlak, 3 sessizce yok | Bitişte gereksinim taraması: madde madde, her birine kanıt |
| **Kırmızı test** | Assertion'ı çıktıya uydurup yeşile çeker | Durur: *"Test, modülün kontratıyla çelişiyor. Hangisi doğru: test mi kod mu?"* |
| **Code review** | "Birkaç minör sorun var gibi" | İki geçiş: önce tam kapsam (recall), sonra her bulguyu çürütme denemesi (precision). Kalanlar `file:line` + kanıtla gelir |
| **İmkansız görev** | Uydurulmuş çıktı, sahte "tamamlandı" | *"Staging key `.env`'de yok, sync auth'ta düşüyor, çıktı şurada. Şunu verirsen devam ederim."* |

Tablodaki her satır çekirdekteki bir kuralın çıktısıdır; her birini kendi reponda test edecek görev [`eval/`](eval/) içinde hazırdır.

## Dürüst çerçeve

Bir prompt paketi modele ham zeka ekleyemez. Ekleyebildiği şey davranıştır, ve agentic coding'de günlük performans farkının büyük kısmı davranıştan gelir: doğrulanmamış "bitti" iddiaları, semptom yamalama, sessizce düşen gereksinimler, test manipülasyonu, scope creep. Bunların hepsi yazıya dökülebilir, ve Opus 4.8 talimat takibi çok güçlü bir model olduğu için yazılanı uygular.

Gerçekçi beklenti: rutin ve orta-zor mühendislik işlerinde Fable 5'e yakın davranış kalitesi. En zor kuyrukta (çok dosyalı ince invariant'lar, çok uzun ufuklu muhakeme) ham zeka farkı durur; onu prompt kapatmaz. Bu paketi değerli yapan şey vaadin büyüklüğü değil, hedefin isabeti.

Ekonomi tarafı basit: Fable 5 en iyi model, ama 19 Temmuz 2026'da üyelik planlarından çıkıyor; sonrasında sadece API'dan ya da üyelik üstüne ek kullanım kredisiyle erişilecek. Üyelikle Claude Code kullananların kalıcı olarak elindeki en güçlü model Opus 4.8; bu paket o modele Fable disiplinini kazandırmak için var.

## Hedef listesi tahmin değil: resmi gap haritası

Anthropic, Fable 5'in Opus 4.8'den nerede daha iyi olduğunu [kendi dokümanlarında](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5) ilan ediyor. O liste, birebir bu paketin modül listesi:

| Fable 5'in resmi avantajı | Paketteki karşılığı |
|---|---|
| Kendi işini doğrulama (self-verification) | Çekirdek §1 + §6 · `verify-done` skill · stop-verify hook |
| Uzun ufuklu tutarlılık | `guides/long-tasks.md`: durum dosyaları, tek-iş-tek-doğrulama |
| Bug bulma recall'u | `agents/code-reviewer.md`: bul → çürüt iki geçişli review |
| Subagent yönetimi | `guides/orchestration.md` + bağımsız context'li `verifier` agent |
| Belirsizlikte kalibrasyon | Çekirdek §11: sor / varsay-ve-söyle / devam et kuralları |
| Dürüst durum raporları | Çekirdek §1: her iddia bu session'daki bir tool sonucuna bağlanır |

Opus 4.8'in dokümante edilmiş 9 davranış özelliği de (literal talimat takibi, az subagent açma, fazla izin sorma, review'da severity filtresinin recall düşürmesi...) tek tek resmi düzeltmeleriyle karşılanıyor: [`guides/opus-4-8.md`](guides/opus-4-8.md).

<a name="mimari"></a>
## Mimari: neden üç katman

Uzun kural kitapları talimat takibini *seyreltir*: 30k token'lık CLAUDE.md, kurallarının yok sayılmasıyla ünlüdür. Bu yüzden paket, her satırı "sıklık × davranış değişimi × hata maliyeti" hesabıyla seçilmiş ince bir çekirdek + ihtiyaç anında yüklenen derinlik olarak tasarlandı:

```mermaid
flowchart TB
 subgraph L0["KATMAN 0 · her zaman yüklü (~200 satır)"]
 CORE["core/CLAUDE-CORE.md 12 davranış"]
 end
 subgraph L1["KATMAN 1 · kendiliğinden tetiklenen skill'ler"]
 PF["plan-first"]
 DD["deep-debug"]
 SR["self-review"]
 VD["verify-done"]
 end
 subgraph L2["KATMAN 2 · ihtiyaç anında okunan rehberler"]
 GUIDES["debugging · verification · code-quality communication · long-tasks · orchestration · opus-4-8"]
 end
 subgraph ENF["DETERMİNİSTİK GÜVENCE"]
 HOOK["stop-verify hook deterministik kapı"]
 VER["verifier agent taze context denetimi"]
 end
 CORE -- "karmaşık iş" --> PF
 CORE -- "2 başarısız fix" --> DD
 CORE -- "diff büyüdü" --> SR
 CORE -- "bitti demeden" --> VD
 CORE -- "tetik koşulu gerçekleşince" --> GUIDES
 VD -.-> VER
 CORE -.-> HOOK
```

Ve bir session'ın içinden geçtiği hat:

```mermaid
flowchart LR
 T["Görev"] --> C{"Sınıflandır"}
 C -- "trivial" --> DO["Direkt yap"]
 C -- "karmaşık" --> P["plan-first keşfet → plan → kabul kriterleri"]
 DO --> I["Uygula oku-sonra-yaz · kök neden · minimal diff"]
 P --> I
 I --> R["self-review diff'i yabancı gözüyle oku"]
 R --> V["verify-done her gereksinime kanıt"]
 V --> H{"stop-verify hook"}
 H -- "değişiklik var, test yok" --> I
 H -- "temiz" --> REP["Dürüst rapor kanıt + doğrulanmayanlar"]
```

Son halka çift güvenceli: prompt katmanı tavsiyedir, [hook](hooks/README.md) deterministik kapıdır (değişiklik var + hiç test koşmadı + çıkıyor → bir kez durdurur). `verifier` agent'ı ise işi senin context'inden bağımsız, temiz bir bakışla gereksinimlere karşı denetler; bağımsız doğrulayıcının self-critique'ten iyi olması Anthropic'in resmi tavsiyesidir.

## Repo haritası

| Dizin | İçerik |
|---|---|
| [`core/`](core/CLAUDE-CORE.md) | Katman 0: her zaman yüklü 12 davranış |
| [`guides/`](guides/) | 7 derin rehber (debugging, verification, code-quality, communication, long-tasks, orchestration, opus-4-8) |
| [`skills/`](skills/) | 4 Claude Code skill'i: otomatik tetiklenir, `/isim` ile de çağrılır |
| [`agents/`](agents/) | `verifier` + `code-reviewer` subagent tanımları |
| [`hooks/`](hooks/) | stop-verify hook + önerilen settings |
| [`api/`](api/) | Claude Code dışı kullanım: tam (~2.5k tok) ve kompakt (~600 tok) sistem promptları + 4 task template |
| [`eval/`](eval/) | 8 davranış tuzağı görev + rubrik + judge promptu: paketi KENDİ reponda A/B test et |

<a name="aile"></a>
## Goat aile haritası

`goat-fable` davranış çekirdeği. Diğer 20 paket bu çekirdeğin üstüne oturan alan bilgisi:
her biri bir işi nasıl yapacağını bilen skill'ler. Hepsi bağımsız kurulabiliyor, hepsi MIT.

Tam indeks, kopyalanabilir kurulum komutlarıyla: **[goatpacks.vercel.app](https://goatpacks.vercel.app)**
Ortak standart ve doğrulayıcı: **[goat-packs](https://github.com/goatstarter/goat-packs)**

Kurulum her pakette aynı:

```bash
npx skills add goatstarter/<paket>
# ya da Claude Code içinde: /plugin marketplace add goatstarter/<paket>
```

### Claude Code çekirdeği

| Paket | Skill | Ne yapar |
|---|---|---|
| [goat-craft](https://github.com/goatstarter/goat-craft) | 12 | Mühendislik hijyeni: commit, PR, test, refactor, bağımlılık ve ölü kod denetimi, doküman, changelog |
| [goat-sift](https://github.com/goatstarter/goat-sift) | 2 | İki geçişli kod incelemesi: önce bul, sonra çürüt. Çürütmeler de raporlanır |
| [goat-herd](https://github.com/goatstarter/goat-herd) | 2 | Alt ajanlar: çıktı sözleşmeli 8 tanım, brief disiplini, ve devretmeme kararı |
| [goat-fence](https://github.com/goatstarter/goat-fence) | 2 | Zorlayıcı hook'lar. Dosyadaki kural rica, hook kapı |
| [goat-charter](https://github.com/goatstarter/goat-charter) | 2 | Spec-first: yazmayan birinin doğrulayabileceği kabul kriterleri |
| [goat-tribe](https://github.com/goatstarter/goat-tribe) | 2 | Küçük takımlar: paralel worktree, yazar-inceleyici ayrımı |
| [goat-lore](https://github.com/goatstarter/goat-lore) | 3 | Proje hafızası: kayda değil doğrulama takımına güvenen recall |
| [goat-pass](https://github.com/goatstarter/goat-pass) | 2 | CLAUDE.md ve AGENTS.md tek kaynaktan, sapma tespitiyle |
| [goat-graze](https://github.com/goatstarter/goat-graze) | 2 | Gözetimsiz gece döngüleri. Atamayacağın şeyle döngü kurulmaz |
| [goat-trial](https://github.com/goatstarter/goat-trial) | 2 | Davranışsal değerlendirme: 6 gizli tuzak, puanın üstünde bütünlük kapısı |

### Vertical

| Paket | Skill | Ne yapar |
|---|---|---|
| [goat-root](https://github.com/goatstarter/goat-root) | 2 | Kök neden: hatayı açıp kapatamadan düzeltme yasak. JS, Python, Postgres, CSS saha rehberleri |
| [goat-ledger](https://github.com/goatstarter/goat-ledger) | 3 | Postgres ve Supabase: korumalı şema değişikliği, gerçek kullanıcıyla RLS testi, sorgu planı |
| [goat-canvas](https://github.com/goatstarter/goat-canvas) | 3 | Frontend kalitesi: tasarım yönleri, gerçek ekran görüntüsü, klavyeyle erişilebilirlik tabanı |
| [goat-warden](https://github.com/goatstarter/goat-warden) | 3 | Defansif repo denetimi: secret, bağımlılık, lisans, KVKK veri akışı |
| [goat-scroll](https://github.com/goatstarter/goat-scroll) | 2 | Üretim LLM promptları ve yayını kapıya alan regresyon seti |

### Ürün ve büyüme

| Paket | Skill | Ne yapar |
|---|---|---|
| [goat-runway](https://github.com/goatstarter/goat-runway) | 8 | Fikirden yayında SaaS'a: doğrulama, konumlandırma, teklif, fiyat, deneme, aktivasyon, MRR, lansman |
| [goat-beacon](https://github.com/goatstarter/goat-beacon) | 8 | Kapılı içerik ve SEO: konu araştırması, denetimli taslak, şema, AI arama, programatik |
| [goat-harbor](https://github.com/goatstarter/goat-harbor) | 7 | Tek kişilik production: deploy kontrolü, olay, geri yükleme tatbikatı, alarm, DNS, postmortem |
| [goat-quill](https://github.com/goatstarter/goat-quill) | 7 | Türkçe dönüşüm metni. Gövdeler Türkçe: ton, landing, email, reklam, teklif, soğuk erişim |
| [goat-kid](https://github.com/goatstarter/goat-kid) | 2 | Claude Code'a Türkçe 7 günlük başlangıç. Günde tek alıştırma, çıktısı olmadan sonraki güne geçilmez |

### Ailenin ortak kuralları

Her pakette aynı iki şey var, ve bu ikisi paketleri diğerlerinden ayıran şey:

**Definition of done.** Her skill'in sonunda, her maddesi çıktıya bakılarak doğrulanabilen bir
kontrol listesi. Agent bunları geçmeden işi bitti sayamıyor. `goat-fable`'ın verify-done disiplininin
alan bilgisine uygulanmış hali.

**İki dilli tetikleyici.** Skill gövdeleri İngilizce, tek nüsha bakımı için. Ama her `description`
alanında gerçekten yazılacak Türkçe cümleler var, böylece Türkçe yazınca da ateşleniyor.
`goat-quill` ve `goat-kid` bunu tersine çeviriyor, çünkü ürettikleri şey Türkçe.

<a name="kurulum"></a>
## Kurulum

```bash
git clone https://github.com/goatstarter/goat-fable.git
cd goat-fable
./install.sh /path/to/projen
```

Sonra projede bir session açıp:

```
/model claude-opus-4-8
/effort xhigh
```

`xhigh`, Anthropic'in Opus 4.8'de agentic coding için önerdiği başlangıç seviyesi. Manuel kurulum, API kullanımı, global kurulum ve doğrulama adımları: [`INSTALL.md`](INSTALL.md).

<a name="eval"></a>
## Eval: etkiyi kendi reponda ölç

`eval/` dizini paketi ölçülebilir yapar: 8 görevi kendi reponda bir paketsiz bir paketli koşturup, modelin hiç görmediği gizli kontrollerle ve rubrikle puanla. Görevlerin her biri dokümante edilmiş bir failure mode'a kurulmuş tuzak:

| Tuzak | Ölçtüğü şey |
|---|---|
| Planted bug | Semptom mu yamalıyor, mekanizmayı mı buluyor |
| Yanlış test | Assertion'ı sessizce çıktıya uyduruyor mu |
| İmkansız görev | Engeli mi raporluyor, başarı mı uyduruyor |
| Shortcut bait | Görünür kontrolü hardcode'la geçip gizli kontrolde düşüyor mu |
| Compiles-isn't-runs | "Çalışıyor" derken gerçekten çalıştırdı mı |
| + 3 tane daha | [`eval/tasks/`](eval/tasks/) |

Bir kural senin reponda ölçülebilir fark yaratmıyorsa onu çekirdekten çıkar. Paket kural yığını değil, ince tutulması gereken bir çekirdektir.

## Nasıl üretildi

1. **Fable 5'in kendi çalışma disiplini.** İçerik Fable 5 tarafından yazıldı: modelin fiilen uyguladığı karar kuralları, Opus 4.8'in uygulayabileceği açık talimatlara döküldü.
2. **Anthropic'in resmi dokümantasyonu**: Opus 4.8 prompting rehberi ve quirk listesi, Fable 5 gap haritası, Claude Code best practices, uzun görev harness rehberi. Kaynaklar: [`guides/opus-4-8.md`](guides/opus-4-8.md).
3. **Dokümante failure mode'lar**: reward hacking araştırması, premature completion, fabricated status reports. Eval tuzakları doğrudan bunlardan türedi.

---

<a name="english"></a>
## English

**Goat Fable is a behavior pack that runs Claude Opus 4.8 with Fable 5's working discipline**: an always-loaded ~200-line operating core, four auto-triggering Claude Code skills (plan-first, deep-debug, self-review, verify-done), on-demand deep guides, a fresh-context verifier subagent, a deterministic stop-verify hook, standalone API system prompts with task templates, and an eval kit (8 behavior-trap tasks + rubric + judge prompt) to A/B the pack on your own repo.

A prompt pack can't add raw intelligence; it closes the *behavioral* gap, which is most of the day-to-day difference: unverified "done" claims, symptom-patching, silently dropped requirements, test-gaming, scope creep. The target list isn't guesswork: Anthropic's own docs state where Fable 5 beats Opus 4.8 (self-verification, long-horizon coherence, bug-finding recall, delegation, calibrated ambiguity handling, grounded progress claims), and those map one-to-one onto this pack's modules. Opus 4.8's nine documented behavioral quirks each get their official countermeasure in [`guides/opus-4-8.md`](guides/opus-4-8.md).

```bash
git clone https://github.com/goatstarter/goat-fable.git && cd goat-fable
./install.sh /path/to/your/project
# then, in a session:  /model claude-opus-4-8   and   /effort xhigh
```

Full instructions in [`INSTALL.md`](INSTALL.md), API usage in [`api/README.md`](api/README.md). Honest expectations: near-Fable behavior on routine-to-moderately-hard engineering work; the raw-reasoning gap on the hardest tail remains. Measure it on your repo with [`eval/`](eval/) rather than taking anyone's word for it, including ours.

## Lisans / License

MIT · [Goatstarter](https://github.com/goatstarter) topluluğu için hazırlandı; issue ve PR açık.

goat-fable

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README