Eklentiler
Sürüm 2.1.0. Eklentiler, temel Deep Work Plan metodolojisine uzantılardır. Beşin dördü isteğe bağlıdır ve uyumluluk için asla gerekli değildir — sıfır isteğe bağlı eklentili bir depo tamamen AI-first ve DWP uyumludur. Her isteğe bağlı eklenti onboarding sırasında sunulur, açıkça kabul veya reddedilir ve — kabul edildiğinde — mevcut kurulumu ezmek yerine uzlaştırır. Bir bileşen beyan edilen istisnadır: 2.3.0 standardından itibaren AI Diff Reviewer yerel incelemesi gerekli temelin bir parçasıdır — onboarding onu kurar ve her Final Review onu çalıştırır — CI yüzeyi ise isteğe bağlı kalır.
Eklenti sözleşmesi
Her üretim eklentisi dört zorunlu bileşen sunar:
| Bileşen | Amaç |
|---|---|
| Spec | Eklentinin ne sağladığının ve “bu eklentiye uyumlu” olmanın ne anlama geldiğinin normatif RFC-2119 açıklaması |
| Reasoning templates | Agent’ın hedef deponun stack’i hakkında akıl yürüterek doldurduğu kılavuzlar — kopyala-yapıştır değil |
| Onboarding hook | Geliştirici kabul ettiğinde onboard akışının çağırdığı SKILL.md giriş noktası |
| Validation step | Eklentinin doğru uygulandığını doğrulayan kontrol listesi |
Keşif: onboard akışı skills/deepworkplan/addons/ dizinini numaralandırır ve her eklentiyi temel iskeletten sonra Faz 7b’de opt-in adım olarak sunar.
Üretim eklentileri (beş)
Bugün beş eklenti sunulmaktadır — dört opt-in artı gerekli yerel inceleme. Her birinin kullanıcıya yönelik ayrıntılı bir kit katalog sayfası ve Deep Work Plan skill’i içinde normatif spec’i vardır.
Devcontainer (birinci eklenti)
Tespit edilen stack’ten akıl yürütülmüş compose tabanlı .devcontainer/ + docker/ kurulumu.
- Kit sayfası: Devcontainer
- Ne ekler: kalıcı AI-CLI auth volume’leri (Claude, Codex, Cursor, gh, Dailybot),
dailybot-project-network,DOCKER_DEV_ENV=vscode, doğrulama alias’ları (codecheck,check,fix,test), halka açık OSS gizli bilgi hijyeni - Davranış: ~%85 sabit iskelet; ~%15 stack’e göre akıl yürütülür. Mevcut devcontainer’lar uzlaştırılır, asla ezilmez
- Ne zaman sunulur: izole dev container’dan faydalanan Docker veya servisli çoğu depo
Dailybot (ikinci eklenti)
Agent ilerleme görünürlüğü için geliştiricinin Dailybot ekibine opt-in bağlantı.
- Kit sayfası: Dailybot — tam yetenek referansı
- DWP eklentisinin bağladıkları: dailybot
reportalt-skill’i ile dört plan yaşam döngüsü raporu (kickoff, significant task, blocked, completion); isteğe bağlı deterministik hook zorlaması (dailybot hook, CLI>= 3.7.0) - Eşleşen skill: DailybotHQ/agent-skill kurulumu (şu an 3.10.3) 14 yetenek sunar — Slack/Teams/Discord/Google Chat sohbeti, check-in’ler, form authoring, ask AI, kudos, depo başına API anahtarları (
.dailybot/env.json), e-posta ve daha fazlası. DWP eklentisi yalnızca report’u bağlar; diğer yetenekler doğrudan Dailybot skill üzerinden çağrılır - Auth: tamamen Dailybot skill’e ertelenmiş (
dailybot loginveyaDAILYBOT_API_KEY); bu eklenti asla kimlik bilgisi saklamaz - Vendor-neutral koruma: temel DWP’nin Dailybot’a sıfır bağımlılığı vardır; herkes için otomatik kurmayın
- Ne zaman sunulur: geliştirici veya ekip zaten Dailybot kullanıyor veya açıkça ekip raporlaması istiyor
Dependency upgrade (üçüncü eklenti)
Paket yöneticisinden bağımsız, toplu, doğrulanmış, geri alınabilir bağımlılık yükseltmeleri.
- Kit sayfası: Dependency upgrade
- Ne ekler: deponun gerçek yöneticisini tespit eder (npm/pnpm/yarn + ncu, pip/poetry/uv, cargo, go mod, bundler, composer, …), semver sınıflandırmalı batch’lerde yükseltir, her batch’ten sonra deponun validation gate’ini çalıştırır, başarısızlıkları geri alır, otomatik commit etmeden özetler
- Komut: yalnızca kabul edildiğinde
/lib-upgrade’i.agents/commands/altına kurar - Ne zaman sunulur: bildirilmiş bağımlılığı olan her depo için sunulur; atıl
/lib-upgradedelege komutu, açıkça reddedilmedikçe onboarding onayı altında kurulur — bir kurulum hiçbir yükseltme çalıştırmaz
Design system (dördüncü eklenti)
Tutarlı UI, CLI veya konuşma çıktısı için herhangi bir kodlama agent’ının okuduğu arayüz yüzeyi kapsamlı DESIGN.md.
- Kit sayfası: Design system
- Ne ekler:
docs/DESIGN.md(AGENTS.md’den referanslanır), tek dosyada üst üste en fazla üç profil: visual-ui (render edilmiş UI token’ları ve bileşenleri), cli-output (anlamsal terminal stilleri, TTY/NO_COLORdegradasyonu), conversational (ses, mesaj anatomisi, düz metin fallback’li platform başına render) - Profil gücü: tespit, teklifi zorunlu kılar; kurulum kabul ile sınırlıdır — hem güdümlü modda hem güven modunda — visual-ui saptandığında güçlü biçimde önerilir; cli-output ve conversational tespit edildiğinde önerilir, her zaman sorulur, asla otomatik uygulanmaz
- Ne zaman sunulur: yalnızca kullanıcıya yönelik arayüz yüzeyi tespit edildiğinde — saf kütüphaneler, headless servisler veya yalnızca altyapı depoları için değil
AI Diff Reviewer (beşinci eklenti — gerekli yerel inceleme, isteğe bağlı CI yüzeyi)
AI Diff Reviewer (marketplace “AI Diff Reviewer”), zorunlu Final Review güvenlik incelemesine yapılandırılmış bir yerel inceleme kazandırır ve isteğe bağlı olarak CI’da pull request’leri kapı altına alır. 2.3.0 standardından itibaren yerel inceleme temelin bir parçasıdır; yalnızca CI yüzeyi isteğe bağlıdır. Bu eklenti her yayında otomatik olarak güncellenir, bu yüzden geçerli sürümü bu metinde asla sabitlenmez — vendored edilen etiketi görmek için eklentinin kendi SKILL.md’sine veya GitHub sürümlerine bakın.
- Kit sayfası: AI Diff Reviewer — tam yetenek referansı
- Onboarding’de gerekli (Faz 7a): vendored skill’in etikete sabitlenmiş kurulumu (
npx --yes skills add DailybotHQ/[email protected] --skill ai-diff-reviewer -y) artı depoya uyarlanmış bir.review/extension.md(generate-extensionaracılığıyla), onboarding onayı altında; hedeflenmiş bir harness yükseltmesi her ikisini de eksik olduğunda uzlaştırır; bir reddediş, beyan edilmiş bir istisna olarak kaydedilir ve kurulana kadarverifytarafından raporlanır - Her Final Review’da gerekli: güvenlik incelemesi, upstream üst varsayılan akışını birikmiş değişiklik kümesi üzerinde çalıştırır ve çıktısını plana yerel
analysis_results/SECURITY_REVIEW.mddosyasına (planın kendi klasörü içinde, asla depo kökünde değil) ekler; eksik bir skill veya uzantı, kaydedilmiş birlocal reviewer not installedbulgusudur — asla sessiz bir atlama değildir ve asla sürpriz bir önyükleme değil: kurulum, onboarding onayına veya açık bir addon çağrısına aittir; tamamlanmış bir geçişten gelencriticalbulgular, düzeltilene veya açıkça kabul edilene kadar tamamlanmayı bloke eder - İsteğe bağlı CI yüzeyi (Flow B): upstream
setupalt-skill’i aracılığıylapr-review.yml(DailybotHQ/ai-diff-reviewer@v2), artı geliştirici tarafından çağrılabilir bir yardımcı olarakapply-review— açıkça sunulur, istenmeden asla kurulmaz, asla varsayılan değildir, asla bir plan görevi değildir - Asla bloke etmeme (yalnızca çağrı): başlayabilen ama hata veren bir yerel inceleme bir kez uyarır, kaydedilir ve devam edilir; görevi asla başarısız kılmaz
- Eşlik (Flow B): paylaşılan
prompt.md+ uzantı metodoloji/önem derecesini hizalar; CI Yineleme Farkındalıklı İnceleme, yerel geçiş tam kalırken 2.+ turları kısaltabilir - Sağlayıcıdan bağımsız güvence: hiçbir Deep Work Plan akışı ticari bir servis, CI sağlayıcısı veya sır gerektirmez — inceleyici, geliştiricinin kendi kodlama agent’ı tarafından çalıştırılan MIT lisanslı, etikete sabitlenmiş bir skill’dir
- Uyumluluk:
verify, eksik bir yerel inceleyiciyi 2.3.0 veya daha yeni bir standart beyan eden depolar için bir başarısızlık olarak, eski depolar için ise bir harness-sürüm bulgusu olarak raporlar
Skill’ler
Skill’ler adıyla çağrılan yeniden kullanılabilir prosedürlerdir. Bir skill tekrarlanabilir bir iş akışını paketler (test çalıştırma, lint düzeltme, bileşen oluşturma).
Metodoloji küçük bir temel alt-skill seti sunar. Bunlar arasında author alt-skill’i bir deponun kendi kit’ini büyütmesini sağlar: /skill-create ve /agent-create ile çağrılır, deponun mevcut .agents/ düzenini ve kurallarını akıl yürütür, ardından bunlara uyan yeni bir skill, agent veya ince komut delegatörü yazar ve kataloğu senkron tutar. Aynı alt-skill Final Review’in skills uzlaştırma geçişini destekler.
Kit girişi: Skill create, Agent create.
Agent’lar
Agent’lar tanımlı bir role sahip uzmanlaşmış çalışanlardır (reviewer, executor, architect). .agents/agents/ altında yaşar ve .agents/docs/ içinde kataloglanır.
Bakım eklentileri
Yukarıdaki dependency-upgrade eklentisi birincil bakım eklentisidir. npm varsaymak yerine deponun gerçek paket yöneticisi hakkında akıl yürütür, yükseltmeleri semver’e göre sınıflandırır, güvenli batch’lerde yükseltir, her batch’ten sonra doğrulama çalıştırır ve başarısız olan batch’i geri alır.
Design-system eklentisi
Üretim eklentileri altında Design system’e bakın. Depo düzeyindeki DESIGN.md, özellik başına teknik tasarım belgesinden farklıdır: DWP plan README’si, görev kabul kriterleri ve validation gate’leri özellik başına tasarımı zaten kapsar. Design-system eklentisi kalıcı, depo-yerel arayüz tasarım bağlamını doldurur.
Preset’ler
Preset’ler DWP’yi belirli bir teknoloji stack’ine uyarlar (Django, React, Go, Astro + Svelte ve daha fazlası). Kit kataloğuna göz atın.
Adapter’lar
Adapter’lar DWP komutlarını belirli bir agent’ın komut sistemine eşler (Claude Code, Cursor, Codex, Gemini, Copilot, OpenClaw ve diğerleri). Adapter girişleri kit’te her agent adının altında bulunur.
Örnekler
Örnekler DWP’yi uygulamada gösterir: önce/sonra karşılaştırmaları, örnek planlar, vaka çalışmaları. Examples ve Dogfood this site’e bakın.
Uyumluluk hatırlatması
Bir depo sıfır eklentiyle tamamen uyumlu OLMALIDIR. Eklentiler katmanlı opt-in yeteneklerdir — asla ön koşul değildir. Conformance’a bakın.