Agent & Skill Linter

Agent ve skill dosyalarinin kalite kontrolu. Yanlis yapilandirilmis dosyalar runtime'da sessizce basarisiz olur -- linter bunu onler.

Agent Dosyasi Kurallari

Frontmatter (ZORUNLU)

---
name: agent-adi          # kebab-case, dosya adiyla AYNI olmali
description: Tek satir   # 20-200 karakter arasi
tools: ["Read", "Bash"]  # Gecerli tool listesi
model: opus              # Opsiyonel: opus | sonnet
---

Frontmatter Validasyonu

Kural	Kontrol	Hata Seviyesi
name mevcut	Frontmatter'da name var mi?	ERROR
name = dosya adi	name: sleuth == sleuth.md	ERROR
name kebab-case	code-reviewer OK, codeReviewer FAIL	ERROR
description mevcut	Bos olmamali	ERROR
description uzunlugu	20-200 karakter	WARN
tools array	String array olmali	ERROR
tools gecerli	Sadece bilinen tool isimleri	WARN
model gecerli	opus, sonnet veya bos	ERROR

Body Kurallari

Kural	Kontrol	Hata Seviyesi
System prompt var	Frontmatter'dan sonra icerik var	ERROR
50+ satir	Cok kisa agent tanimlari yetersiz	WARN
2000 satir max	Cok uzun dosyalar token israf eder	WARN
Markdown basliklar	En az 1 ## basligi var	WARN

Skill Dosyasi Kurallari

Frontmatter (ZORUNLU)

---
name: skill-adi          # kebab-case
description: Aciklama    # 20-300 karakter
---

Skill Validasyonu

Kural	Kontrol	Hata Seviyesi
Dosya adi	SKILL.md veya skill.md	ERROR
name mevcut	Frontmatter'da	ERROR
name = klasor adi	name: tdd-workflow == skills/tdd-workflow/	WARN
description mevcut	Bos olmamali	ERROR
Icerik var	Frontmatter'dan sonra en az 20 satir	WARN
Kod ornegi var	En az 1 code block	INFO

Lint Calistirma

Bash Script

#!/bin/bash
# scripts/lint-agents.sh