Add-on

Versi 2.1.0. Add-on adalah ekstensi dari metodologi Deep Work Plan inti. Empat dari lima bersifat opsional dan tidak pernah diperlukan untuk konformitas — repositori tanpa addon opsional sepenuhnya AI-first dan konforman DWP. Setiap addon opsional ditawarkan saat onboarding, diterima atau ditolak secara eksplisit, dan — jika diterima — merekonsiliasi dengan setup yang ada alih-alih menimpanya. Satu komponen adalah pengecualian yang dinyatakan: sejak standar 2.3.0 tinjauan lokal AI Diff Reviewer adalah bagian dari baseline wajib — onboarding menginstalnya dan setiap Final Review menjalankannya — sementara permukaan CI-nya tetap opt-in.

Kontrak addon

Setiap addon yang dikirim menyediakan empat komponen wajib:

Penemuan: alur onboard mengekstrak skills/deepworkplan/addons/ dan menyajikan setiap addon sebagai langkah opt-in di Fase 7b, setelah scaffolding inti.

Addon yang dikirim (lima)

Lima addon tersedia hari ini — empat opt-in ditambah tinjauan lokal yang wajib. Masing-masing memiliki halaman katalog kit dengan detail untuk pengguna dan spec normatif di dalam skill Deep Work Plan.

Devcontainer (addon pertama)

Setup .devcontainer/ + docker/ berbasis compose yang dirasionalkan dari stack yang terdeteksi.

• Halaman kit: Devcontainer
• Yang ditambahkan: volume auth AI-CLI persisten (Claude, Codex, Cursor, gh, Dailybot), dailybot-project-network, DOCKER_DEV_ENV=vscode, alias validasi (codecheck, check, fix, test), kebersihan rahasia OSS publik
• Perilaku: ~85% kerangka stabil; ~15% dirasionalkan per stack. Devcontainer yang ada direkonsiliasi, tidak pernah ditimpa
• Kapan ditawarkan: sebagian besar repo dengan Docker atau layanan yang mendapat manfaat dari dev container terisolasi

Dailybot (addon kedua)

Koneksi opt-in ke tim Dailybot pengembang untuk visibilitas progres agen.

• Halaman kit: Dailybot — referensi kemampuan lengkap
• Yang dihubungkan addon DWP: empat laporan siklus hidup rencana (kickoff, significant task, blocked, completion) melalui sub-skill dailybot report; penegakan hook deterministik opsional (dailybot hook, CLI >= 3.7.0)
• Skill yang dipasangkan: menginstal DailybotHQ/agent-skill (saat ini 3.10.3) mengekspos 14 kemampuan — chat di Slack/Teams/Discord/Google Chat, check-in, authoring formulir, ask AI, kudos, API key per repo (.dailybot/env.json), email, dan lainnya. Addon DWP hanya menghubungkan report; kemampuan lain dipanggil melalui skill Dailybot secara langsung
• Auth: sepenuhnya ditunda ke skill Dailybot (dailybot login atau DAILYBOT_API_KEY); addon ini tidak pernah menyimpan kredensial
• Pagar vendor-neutral: DWP inti memiliki nol ketergantungan Dailybot; jangan pernah menginstal otomatis untuk semua orang
• Kapan ditawarkan: pengembang atau tim sudah menggunakan Dailybot, atau secara eksplisit meminta pelaporan tim

Dependency upgrade (addon ketiga)

Upgrade dependensi agnostik package manager, bertahap, tervalidasi, dan dapat dibalik.

• Halaman kit: Dependency upgrade
• Yang ditambahkan: mendeteksi manajer nyata repo (npm/pnpm/yarn + ncu, pip/poetry/uv, cargo, go mod, bundler, composer, …), upgrade dalam batch yang diklasifikasikan semver, menjalankan validation gate repo setelah setiap batch, membalikkan kegagalan, merangkum tanpa commit otomatis
• Perintah: menginstal /lib-upgrade ke .agents/commands/ hanya jika diterima
• Kapan ditawarkan: ditawarkan untuk setiap repo dengan dependensi yang dideklarasikan; delegator inert /lib-upgrade dipasang di bawah persetujuan onboarding kecuali ditolak secara eksplisit — sebuah instalasi tidak menjalankan upgrade apa pun

Design system (addon keempat)

DESIGN.md dengan cakupan permukaan antarmuka yang dibaca agen kode mana pun untuk output UI, CLI, atau percakapan yang konsisten.

• Halaman kit: Design system
• Yang ditambahkan: docs/DESIGN.md (direferensikan dari AGENTS.md) dengan hingga tiga profil ditumpuk dalam satu file: visual-ui (token dan komponen UI yang dirender), cli-output (gaya terminal semantik, degradasi TTY/NO_COLOR), conversational (suara, anatomi pesan, rendering per platform dengan fallback teks biasa)
• Kekuatan profil: deteksi menjadikan penawaran wajib; instalasi dijaga oleh penerimaan, baik dalam mode terpandu maupun mode trust — visual-ui sangat direkomendasikan saat terdeteksi; cli-output dan conversational direkomendasikan saat terdeteksi, selalu ditanyakan, tidak pernah diterapkan otomatis
• Kapan ditawarkan: hanya ketika permukaan antarmuka pengguna terdeteksi — bukan untuk pustaka murni, layanan headless, atau repo hanya infrastruktur

AI Diff Reviewer (addon kelima — tinjauan lokal wajib, permukaan CI opsional)

AI Diff Reviewer (marketplace “AI Diff Reviewer”) memberi pemeriksaan keamanan Final Review wajib sebuah tinjauan lokal terstruktur, dan secara opsional mengontrol pull request di CI. Sejak standar 2.3.0 tinjauan lokal adalah bagian dari baseline; hanya permukaan CI yang opt-in. Addon ini diperbarui otomatis setiap rilis, sehingga versi terkininya tidak pernah dipatok dalam teks ini — periksa SKILL.md milik addon itu sendiri atau rilis GitHub-nya untuk tag yang benar-benar di-vendor.

• Halaman kit: AI Diff Reviewer — referensi kemampuan lengkap
• Wajib saat onboarding (Fase 7a): instalasi skill vendored yang dipatok pada tag (npx --yes skills add DailybotHQ/[email protected] --skill ai-diff-reviewer -y) plus .review/extension.md yang disesuaikan dengan repo (melalui generate-extension), di bawah persetujuan onboarding; upgrade harness tertarget merekonsiliasi keduanya bila hilang; penolakan dicatat sebagai pengecualian yang dinyatakan dan dilaporkan oleh verify hingga terinstal
• Wajib di setiap Final Review: pemeriksaan keamanan menjalankan alur default induk upstream atas kumpulan perubahan yang terakumulasi dan menambahkan outputnya ke analysis_results/SECURITY_REVIEW.md milik plan tersebut (di dalam folder plan itu sendiri, bukan di root repo); skill atau ekstensi yang hilang menjadi temuan local reviewer not installed yang tercatat — tidak pernah dilewati diam-diam, dan tidak pernah menjadi bootstrap kejutan: instalasi milik persetujuan onboarding atau invokasi addon yang eksplisit; temuan critical dari penerusan yang selesai memblokir penyelesaian hingga diperbaiki atau diterima secara eksplisit
• Permukaan CI opsional (Flow B): pr-review.yml (DailybotHQ/ai-diff-reviewer@v2) melalui sub-skill setup upstream, plus apply-review sebagai pendamping yang dipanggil pengembang — ditawarkan secara eksplisit, tidak pernah diinstal tanpa diminta, tidak pernah menjadi default, tidak pernah menjadi tugas rencana
• Tidak pernah memblokir (hanya pemanggilan): tinjauan lokal yang bisa dimulai tetapi gagal bersifat peringat-sekali-catat-dan-lanjut; itu tidak pernah menggagalkan tugas
• Paritas (Flow B): prompt.md bersama + ekstensi menyelaraskan metodologi/tingkat keparahan; Tinjauan Sadar Iterasi CI dapat mempersingkat putaran 2+ sementara penerusan lokal tetap penuh
• Pengamanan netral vendor: tidak ada alur Deep Work Plan yang memerlukan layanan komersial, penyedia CI, atau rahasia — reviewer adalah skill MIT yang dipatok pada tag dan dijalankan oleh coding agent pengembang sendiri
• Konformitas: verify melaporkan reviewer lokal yang hilang sebagai kegagalan untuk repositori yang menyatakan standar 2.3.0 atau lebih baru, dan sebagai temuan versi-harness untuk repositori lama

Skill

Skill adalah prosedur yang dapat digunakan kembali yang dipanggil berdasarkan nama. Skill mengemas alur kerja yang dapat diulang (menjalankan tes, memperbaiki lint, membuat komponen).

Metodologi menyediakan seperangkat kecil sub-skill inti. Di antaranya, sub-skill author memungkinkan repositori menumbuhkan kit sendiri: dipanggil melalui /skill-create dan /agent-create, menalar tentang tata letak .agents/ dan konvensi repo yang ada, lalu menulis skill, agen, atau delegator perintah tipis baru yang sesuai, dan menjaga katalog tetap sinkron. Sub-skill yang sama menopang pass rekonsiliasi skills pada Final Review.

Entri kit: Skill create, Agent create.

Agen

Agen adalah pekerja khusus dengan peran yang ditentukan (reviewer, executor, architect). Mereka berada di .agents/agents/ dan dikatalogkan di .agents/docs/.

Addon pemeliharaan

Addon dependency-upgrade (di atas) adalah addon pemeliharaan utama. Addon ini menalar tentang package manager aktual repositori alih-alih mengasumsikan npm, mengklasifikasikan upgrade berdasarkan semver, mengupgrade dalam batch aman, menjalankan validasi setelah setiap batch, dan membalikkan batch yang gagal.

Addon design-system

Lihat Design system di bawah addon yang dikirim. DESIGN.md tingkat repo berbeda dari dokumen desain teknis per fitur: README rencana DWP, kriteria penerimaan tugas, dan validation gate sudah mencakup desain per fitur. Addon design-system mengisi konteks desain antarmuka yang tahan lama dan native repo.

Preset

Preset mengadaptasi DWP ke stack teknologi tertentu (Django, React, Go, Astro + Svelte, dan lainnya). Jelajahi katalog kit.

Adapter

Adapter memetakan perintah DWP ke sistem perintah agen tertentu (Claude Code, Cursor, Codex, Gemini, Copilot, OpenClaw, dan lainnya). Entri adapter berada di kit di bawah nama setiap agen.

Contoh

Contoh mendemonstrasikan DWP dalam praktik: perbandingan sebelum/sesudah, rencana contoh, studi kasus. Lihat Examples dan Dogfood this site.

Pengingat konformitas

Repositori HARUS sepenuhnya konforman dengan nol addon. Addon adalah kemampuan opt-in berlapis — bukan prasyarat. Lihat Conformance.