plan-contract

Amaç

Tek bir görev için yürütülebilir, kapsamı belirli bir PLAN.md yazar ve onu mekanik olarak doğrular.

Kaynak Skill amacı

Ne zaman kullanılır

Kanonik görevi yürütülebilir ve dondurulabilir plana dönüştürürken plan-contract kullanılır. Ön bölüm düzenlenebilecek her dosyaya kesin yol verir ve onu kabul ölçütlerine eşler; her ölçüt de kapsama veya teste geri bağlanır. Sınıf ve değişen yüzey hangi mimari, veri, arayüz ve doğrulama bölümlerinin gerektiğini belirler. Bağımlılıklar, sözleşmeler, varsayımlar ve TDD muafiyetleri açıktır. Validator dondurmadan önce yolları, eşlemeleri ve bölümleri denetler. Plan yeni gereksinim üretmez, görev amacı ve kanıtı kaydeder.

Plan dosya listesinden fazlasıdır: somut davranışı, denetimleri, doğrulama komutlarını ve her bağımlılık veya sözleşme değişikliğini belirtir. Yeni dış giriş noktalarına sunucu tarafı doğrulama gerekleri yazılır. Varsayımlar risk ve doğrulama durumunu taşır; yüksek riskli yanıtsız seçimler dondurmayı durdurur. Test muafiyeti özel gerekçe ister ve davranış değiştiren yolun testi kapsamda kalır.

Kaynak Skill amacı

Nasıl çalışır

Becerinin adımları, kaynak sırasıyla

Kaynak Skill akışı

Girdileri oku Taslağa başlamadan TASK.md ölçütlerini ve kısıtlarını, ardından varsa EVIDENCE.md ve INTENT.md dosyalarını oku. Görev sınıfını çalıştırmanın sınıflandırmasından veya önerilen sınıftan belirle.
Kaynak Skill akışı
Aday yolları listele Etki kanıtını kullanarak her ölçüt için değişmesi gereken dosyaları ve onu kanıtlayan testi listele. Var olan her yolu git ls-files ile doğrula; yeni dosyanın üst dizininin var olduğunu kontrol et.
Kaynak Skill akışı
Kapsamı eşle Kesin yol girdilerini ve kabul ölçütü eşlemelerini yaz.
Kaynak Skill akışı
Gerekli bölümleri yaz Yalnız görev sınıfının ve etkilenen yüzeyin gerektirdiği bölümleri ekle.
Kaynak Skill akışı
Planı doğrula Plan validator'ını yollar, eşlemeler ve bölümler geçene kadar çalıştır.
Kaynak Skill akışı
Durak noktasını sun Gözetim gerekiyorsa doğrulanmış planı onaya sun.
Kaynak Skill akışı

Temel kurallar

Depo dosyalarını kalıp veya yinelenen kapsam girdisi olmadan kesin yaz.
Kaynak Temel kurallar
Her yolu ölçüte ve her ölçütü bir yol veya teste geri eşle.
Kaynak Temel kurallar
Kapsamı kanıtın desteklediği en küçük değişiklikte tut.
Kaynak Temel kurallar
Davranış değiştiren her yolun test dosyasını kapsama al; RED ve GREEN kanıtı olmayan her yol için belirli bir tdd_exemption gerekçesi yaz.
Kaynak Temel kurallar
Gereksinimleri uydurmak yerine görevden ve çözülmüş amaçtan al.
Kaynak Temel kurallar

Çıktı ve gate

Çıktı

Kesin kapsam ve gerekli bölümleri olan doğrulanmış planı yaz.
Kaynak Çıktı tanımı

gate

Plan yalnız validator'ı başarılı biterse hazırdır.
Kaynak Gate kuralı

Kaynak

Kaynak Skill tanımı

← Tüm beceriler