Originally published on Medium — this is a mirror.
GitHub Spec Kit, AI agentların (Cursor, Claude, Copilot gibi) belirli bir mimari disiplin ve dokümantasyon planı çerçevesinde kod üretmesini sağlayan bir araç seti. Bu metodoloji, "Vibe Coding" sürecini yapılandırılmış bir mühendislik akışına dönüştürür.
1. Kurulum ve Başlangıç
Spec Kit, Python paket yöneticisi uv üzerinden kurulur:
# uv kurulumu
curl -LsSf https://astral.sh/uv/install.sh | sh
# Spec Kit CLI kurulumu
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
2. Projeyi Yapılandırma
Mevcut projenin kök dizininde yapılandırmayı başlatmak için:
specify init . --here --ai cursor-agentBu komut, proje dizinine .specify klasörünü ekler. Bu klasör AI için "hafıza" merkezidir.
3. Anayasa (Constitution) Oluşturma
AI'nın uyması gereken kuralları belirlemek için .specify/memory/constitution.md dosyası oluşturulur. Bu dosyada kullanılacak teknolojiler, klasör yapısı ve kod yazım standartları tanımlanır.
4. İş Akışı (The Workflow)
Spec Kit şu beş aşamalı komut setiyle çalışır:
/speckit.specify— Yeni özelliğin gereksinimlerini markdown formatında dökümante eder./speckit.plan— Mevcut kod yapısını analiz ederek yapılacak değişikliklerin planını çıkarır./speckit.tasks— Planı küçük görevlere böler./speckit.analyze— Planın mevcut kodla tutarlılığını denetler./speckit.implement— Agent, yeni bir git branch'i açar ve kodlama süreci başlatır.
Neden Kullanılmalı?
- Mimari Tutarlılık: AI, projenin en başında belirlenen kuralların dışına çıkamaz.
- İzole Geliştirme: Her özellik otomatik olarak farklı bir branchte geliştirilir, main/master etkilenmez.
- Bağlam Yönetimi:
.specify/memoryaltındaki geçmiş dosyaları sayesinde AI, projenin hangi aşamada olduğunu unutmaz.