Skip to content
← सभी स्पेक दस्तावेज़

ऐडऑन

संस्करण दायरा: यह संरक्षित v5.0.0 आधार दस्तावेज़ है। वर्तमान मानक, DWP 7.0.0, विशिष्टता अनुक्रमणिका में सूचीबद्ध लागू V6_*.md और V7_*.md एक्सटेंशन भी अनिवार्य करता है। मौजूदा v5 और v6 प्लान अपने दर्ज नियम बनाए रखते हैं।

संस्करण 2.1.0. ऐडऑन कोर Deep Work Plan पद्धति के विस्तार हैं। आठ में से सात वैकल्पिक हैं और अनुरूपता के लिए कभी आवश्यक नहीं — शून्य वैकल्पिक ऐडऑन वाली रिपॉज़िटरी पूर्णतः AI-first और DWP-अनुरूप है। हर वैकल्पिक ऐडऑन ऑनबोर्डिंग के दौरान प्रस्तावित होता है, स्पष्ट रूप से स्वीकार या अस्वीकार होता है, और — स्वीकार होने पर — मौजूदा सेटअप को मिटाने के बजाय समाधान करता है। एक घटक घोषित अपवाद है: संस्करण 2.3.0 से AI Diff Reviewer स्थानीय समीक्षा आवश्यक baseline का हिस्सा है — ऑनबोर्डिंग इसे इंस्टॉल करती है और हर Final Review इसे चलाता है — जबकि इसकी CI सतह ऑप्ट-इन बनी रहती है।

ऐडऑन अनुबंध

हर shipping ऐडऑन चार अनिवार्य घटक भेजता है:

घटक उद्देश्य
Spec RFC-2119 normative विवरण कि ऐडऑन क्या प्रदान करता है और “इस ऐडऑन के अनुरूप” का अर्थ
Reasoning templates एजेंट लक्ष्य रिपॉज़िटरी के stack पर तर्क करके भरता है — copy-paste नहीं
Onboarding hook SKILL.md प्रवेश बिंदु जिसे onboard प्रवाह डेवलपर के स्वीकार पर कॉल करता है
Validation step चेकलिस्ट जो पुष्टि करती है कि ऐडऑन सही लागू हुआ

खोज: onboard प्रवाह skills/deepworkplan/addons/ को गिनता है और हर ऐडऑन को Phase 7b में ऑप्ट-इन चरण के रूप में प्रस्तुत करता है, कोर scaffolding के बाद।

Shipping ऐडऑन (आठ)

आज आठ ऐडऑन ship होते हैं — सात ऑप्ट-इन साथ ही आवश्यक स्थानीय समीक्षा। हर एक का kit catalog पृष्ठ user-facing विवरण के साथ और Deep Work Plan स्किल के अंदर normative spec है। इनमें से चार — devcontainer, Herdr, DeepWorkPlan Vim और Agentkit — पतले इंटीग्रेटर हैं जो tag द्वारा किसी ऐसे उत्पाद से पिन हैं जिसकी अपनी रिपॉज़िटरी और रिलीज़ चक्र है; हर उत्पाद Deep Work Plan के बिना भी काम करता है। स्वीकार किया गया ऐडऑन .dwp/config.json ऐडऑन रजिस्ट्री (DWP 7.0.0) में दर्ज होता है, जो केवल प्रस्ताव या संवर्धन कर सकती है — यह कभी अनुरूपता या किसी योजना को अवरुद्ध नहीं करती।

Devcontainer (पहला ऐडऑन)

devcontainer-kit (dck, v1.1.1 पर पिन किया गया, इंटरफ़ेस 2) का एक हल्का इंटीग्रेटर: एक Dev Containers टेम्पलेट जिसे dck init रिपॉज़िटरी में उसके अपने कंटेनर के रूप में रेंडर करता है, साथ में dck-dockerfile स्किल।

  • Kit पृष्ठ: Devcontainer
  • क्या जोड़ता है: digest द्वारा पिन की गई रनटाइम की आधिकारिक इमेज से बना docker/local/<service>/Dockerfile (python-3.13, node-24 या debian, कोई साझा बेस इमेज नहीं), dck लॉन्चर (up, shell, rebuild, doctor) के ऊपर dev.sh, एक ऑप्ट-इन परत के रूप में कोडिंग एजेंट, केवल loopback पोर्ट, होस्ट के एजेंट के माध्यम से SSH पर git जिसमें अंदर कोई कुंजी नहीं होती, जब तक डेवलपर अपनी होस्ट प्रोफ़ाइल में [ssh] copy_keys से इसे स्वयं चालू न करे, और मानक लेआउट के साथ प्रति कंटेनर Herdr मशीनें
  • व्यवहार: dck doctor --json (इंटरफ़ेस 2) के माध्यम से पहचाना जाता है; dck init किसी मौजूदा devcontainer का समाधान केवल उसका diff स्वीकार होने के बाद करता है, और पहले फ़ाइल का बैकअप लेता है — कभी ओवरराइट नहीं किया जाता
  • कब प्रस्तावित: अधिकांश रिपॉज़िटरी जहाँ Docker या isolated dev container लाभकारी सेवाएँ हों

Dailybot (दूसरा ऐडऑन)

डेवलपर की Dailybot टीम से ऑप्ट-इन कनेक्शन एजेंट प्रगति दृश्यता के लिए।

  • Kit पृष्ठ: Dailybot — पूर्ण क्षमता संदर्भ
  • DWP ऐडऑन क्या जोड़ता है: dailybot report sub-skill के माध्यम से चार योजना-जीवनचक्र रिपोर्ट (kickoff, significant task, blocked, completion); वैकल्पिक deterministic हुक प्रवर्तन (dailybot hook, CLI >= 3.9.0)
  • जोड़ी गई स्किल: DailybotHQ/agent-skill (पिन किया गया v3.23.20) इंस्टॉल करने से 17 क्षमताएँ — Slack/Teams/Discord/Google Chat पर chat, check-ins, forms authoring, ask AI, kudos, Plan boards और tasks, organization labels, per-repo API keys (.dailybot/env.json), email, और अधिक। DWP ऐडऑन केवल report जोड़ता है; अन्य क्षमताएँ Dailybot स्किल के माध्यम से सीधे invoke होती हैं
  • Auth: पूर्णतः Dailybot स्किल को सौंपा (dailybot login या DAILYBOT_API_KEY); यह ऐडऑन कभी credentials संग्रहीत नहीं करता
  • Vendor-neutral guardrail: कोर DWP की Dailybot पर शून्य निर्भरता; कभी सभी के लिए स्वतः इंस्टॉल न करें
  • कब प्रस्तावित: डेवलपर या टीम पहले से Dailybot उपयोग करती हो, या स्पष्ट रूप से टीम रिपोर्टिंग माँगे

Dependency upgrade (तीसरा ऐडऑन)

Package-manager-agnostic, बैच, सत्यापित, revertible dependency अपग्रेड।

  • Kit पृष्ठ: Dependency upgrade
  • क्या जोड़ता है: रिपॉज़िटरी के वास्तविक manager का पता लगाता है (npm/pnpm/yarn + ncu, pip/poetry/uv, cargo, go mod, bundler, composer, …), semver-वर्गीकृत बैचों में अपग्रेड, हर बैच के बाद रिपॉज़िटरी का validation gate, विफलताएँ revert, बिना auto-commit सारांश
  • कमांड: स्वीकार होने पर केवल /lib-upgrade को .agents/commands/ में इंस्टॉल करता है
  • कब प्रस्तावित: घोषित dependencies वाले हर repo के लिए प्रस्तावित; निष्क्रिय /lib-upgrade डेलिगेटर, स्पष्ट रूप से अस्वीकार न हो, onboarding की सहमति के अंतर्गत इंस्टॉल होता है — इंस्टॉल कोई upgrade नहीं चलाता

Design system (चौथा ऐडऑन)

इंटरफ़ेस-सतह-दायरे वाला DESIGN.md जिसे कोई भी coding agent सुसंगत UI, CLI, या conversational आउटपुट के लिए पढ़ता है।

  • Kit पृष्ठ: Design system
  • क्या जोड़ता है: docs/DESIGN.md (AGENTS.md से संदर्भित) अधिकतम तीन profiles एक फ़ाइल में: visual-ui (rendered UI tokens और components), cli-output (semantic terminal styles, TTY/NO_COLOR degradation), conversational (voice, message anatomy, per-platform rendering plain-text fallbacks के साथ)
  • Profile strength: पहचान होने पर प्रस्ताव अनिवार्य हो जाता है; इंस्टॉल स्पष्ट स्वीकृति से नियंत्रित है — guided और trust दोनों mode में — visual-ui पता चलने पर पुरज़ोर सिफ़ारिश; cli-output और conversational पता चलने पर अनुशंसित, हमेशा पूछे जाते हैं, कभी auto-applied नहीं
  • कब प्रस्तावित: केवल जब user-facing इंटरफ़ेस सतह पहचानी जाए — pure libraries, headless services, या infra-only रिपॉज़िटरी के लिए नहीं

AI Diff Reviewer (पाँचवाँ ऐडऑन — आवश्यक स्थानीय समीक्षा, वैकल्पिक CI सतह)

AI Diff Reviewer (marketplace “AI Diff Reviewer”) अनिवार्य Final Review सुरक्षा-जाँच को एक संरचित स्थानीय समीक्षा देता है, और वैकल्पिक रूप से CI में pull requests को गेट करता है। संस्करण 2.3.0 से स्थानीय समीक्षा baseline का हिस्सा है; केवल CI सतह ऑप्ट-इन है। यह ऐडऑन हर release पर स्वतः अपडेट होता है, इसलिए नीचे दिखाया गया tag लिखे जाने के समय का वर्तमान tag है और vendored प्रति से पीछे रह सकता है — वास्तव में इंस्टॉल किए गए tag के लिए ऐडऑन का अपना SKILL.md और उसकी GitHub releases ही प्रामाणिक हैं। इंस्टॉल हमेशा एक प्रकाशित tag पर स्थिर किया जाता है, कभी किसी चलती हुई branch पर नहीं।

  • Kit पृष्ठ: AI Diff Reviewer — पूर्ण क्षमता संदर्भ
  • ऑनबोर्डिंग पर आवश्यक (Phase 7a): vendored skill का tag-pinned इंस्टॉल (npx --yes skills add https://github.com/DailybotHQ/ai-diff-reviewer/tree/v3.3.16 --skill ai-diff-reviewer -y) साथ ही repo के लिए ढाला गया .review/extension.md (generate-extension के माध्यम से), ऑनबोर्डिंग की सहमति के अंतर्गत; अनुपस्थित होने पर एक targeted harness upgrade दोनों को समाधान करता है; अस्वीकृति एक घोषित अपवाद के रूप में दर्ज होती है और इंस्टॉल होने तक verify उसकी रिपोर्ट करता है
  • हर Final Review में आवश्यक: सुरक्षा-जाँच संचित change set पर upstream parent डिफ़ॉल्ट प्रवाह चलाती है और अपना आउटपुट plan-local analysis_results/SECURITY_REVIEW.md (plan के अपने folder के अंदर, repo root में कभी नहीं) में जोड़ती है; अनुपस्थित skill या एक्सटेंशन एक दर्ज local reviewer not installed निष्कर्ष है — कभी चुपचाप नहीं छोड़ा जाता, और कभी अचानक बूटस्ट्रैप नहीं: इंस्टॉल onboarding की सहमति या addon की स्पष्ट invocation से संबंधित है; एक पूर्ण पास के सत्यापित critical निष्कर्ष ठीक या स्पष्ट रूप से स्वीकृत होने तक पूर्णता को रोकते हैं (v3, BC-07 — असत्यापित गंभीर दावे एनोटेटेड चेतावनी के रूप में आते हैं, और incomplete/timeout समीक्षा एक स्वच्छ पास नहीं है, BC-04)
  • वैकल्पिक CI सतह (Flow B): upstream setup sub-skill के माध्यम से pr-review.yml (DailybotHQ/ai-diff-reviewer@v3), साथ ही apply-review (केवल पढ़ने योग्य) और address-review (कमिट, पुश और पुनः सक्रिय; v3.1.1 में नया) डेवलपर द्वारा इनवोक किए जाने वाले सुविधाओं के रूप में — स्पष्ट रूप से प्रस्तावित, बिना अनुरोध कभी इंस्टॉल नहीं, कभी डिफ़ॉल्ट नहीं, कभी प्लान टास्क नहीं
  • कभी अवरोधित नहीं (केवल इनवोकेशन): एक स्थानीय समीक्षा जो शुरू हो सकती हो पर त्रुटि दे दे, तो एक बार चेतावनी दें, दर्ज करें, जारी रखें; वह उस कार्य को कभी विफल नहीं करती
  • समानता (Flow B): साझा prompt.md + एक्सटेंशन पद्धति/गंभीरता संरेखित करते हैं; CI Iteration-Aware Review स्थानीय पास पूर्ण रहते हुए 2+ राउंड को छोटा कर सकता है
  • वेंडर-तटस्थ सुरक्षा: कोई भी Deep Work Plan प्रवाह व्यावसायिक सेवा, CI प्रदाता या secret की आवश्यकता नहीं रखता — reviewer एक MIT, tag-pinned skill है जो डेवलपर के अपने coding agent द्वारा चलाया जाता है
  • अनुरूपता: verify अनुपस्थित स्थानीय reviewer को संस्करण 2.3.0 या नए की घोषणा करने वाली रिपॉज़िटरी के लिए विफलता के रूप में, और legacy रिपॉज़िटरी के लिए harness-संस्करण निष्कर्ष के रूप में रिपोर्ट करता है

Herdr (छठा ऐडऑन)

herdr-peers (पिन v1.1.0, प्रोटोकॉल 1) का एक पतला इंटीग्रेटर, v7 योजनाओं का इंटरैक्टिव डेलिगेशन ट्रांसपोर्ट।

  • Kit पृष्ठ: Herdr
  • क्या जोड़ता है: एक योजना किसी सीमित कार्य को दूसरे Herdr पेन में किसी कोडिंग एजेंट को सौंप सकती है, उसी मशीन पर या ऐसी मशीन पर जिस तक Herdr SSH से पहुँचता है, और उसका एकमात्र अधिकृत उत्तर जर्नल में दर्ज कर सकती है
  • व्यवहार: पीयर प्रोटोकॉल (stamp, grant, reply, loop guard, गहराई और fan-out सीमाएँ) herdr-peers में रहता है, पैक में कभी नहीं; किसी भी उपयोग के लिए अनुबंध grant agent_delegation आवश्यक है, और किसी प्रतिनिधि का परिणाम तब तक केवल दावा रहता है जब तक योजना का अपना runner उसे स्वयं नहीं देख लेता
  • कब प्रस्तावित: Phase 7b के दौरान स्पष्ट ऑप्ट-इन; herdr और herdr-peers का केवल-पढ़ने वाला पता लगाना; ट्रांसपोर्ट केवल Herdr सत्र के भीतर उपयोग योग्य है

DeepWorkPlan Vim (सातवाँ ऐडऑन)

DeepWorkPlan Vim (पिन v1.0.1, इंटरफ़ेस 1) का एक पतला इंटीग्रेटर, Deep Work Plan के लिए टर्मिनल एडिटर (Neovim 0.12+)।

  • Kit पृष्ठ: DeepWorkPlan Vim
  • क्या जोड़ता है: एजेंटों और मनुष्यों के लिए एक वैकल्पिक, मशीन-स्तरीय एडिटर सतह — एक जनरेट किया गया कमांड इंडेक्स, केवल-पढ़ने योग्य योजना ब्राउज़र और Markdown व्यूअर; हर दावा उत्पाद की पिन की गई मशीन-पठनीय सतह से पढ़ा जाता है
  • व्यवहार: मौजूदा Neovim कॉन्फ़िगरेशन स्पष्ट सहमति के बिना कभी ओवरराइट नहीं किया जाता; पता लगाना केवल-पढ़ने वाला है
  • कब प्रस्तावित: Phase 7b के दौरान स्पष्ट ऑप्ट-इन; Neovim 0.12+ अनुपस्थित होने पर केवल सूचनात्मक

Agentkit (आठवाँ ऐडऑन)

coding-agents-kit (ak, पिन v1.1.0, इंटरफ़ेस 1) का एक पतला इंटीग्रेटर, v7 योजनाओं का हेडलेस डेलिगेशन ट्रांसपोर्ट।

  • Kit पृष्ठ: Agentkit
  • क्या जोड़ता है: टर्मिनल कोडिंग एजेंटों पर एक ak कमांड सतह, जिसका उपयोग किसी सीमित योजना कार्य को हेडलेस चलाने के लिए होता है; यह subagents, cancel_children और model_routing क्षमताएँ केवल रनटाइम पर देता है, जब यह सक्षम हो, पहचाना गया हो और संगत इंटरफ़ेस पर हो
  • व्यवहार: किसी भी उपयोग के लिए अनुबंध grant agent_delegation आवश्यक है; kit डिफ़ॉल्ट रूप से एजेंटों को स्वायत्त मोड में लॉन्च करता है और उसका ऑप्ट-आउट (--ask या AGENTKIT_PERMISSIONS=ask) हमेशा प्रभावी रहता है — ऐडऑन कोई स्वायत्तता फ़्लैग नहीं लिखता, जब योजना ऑप्ट-आउट दर्ज करती है तब और केवल-पढ़ने वाले डेलिगेट के लिए हमेशा --ask पास करता है; वह कभी अपने आप कोडिंग-एजेंट CLI इंस्टॉल नहीं करता और कभी प्रदाता कुंजियों के मान नहीं पढ़ता
  • कब प्रस्तावित: Phase 7b के दौरान स्पष्ट ऑप्ट-इन; ak doctor --json के माध्यम से केवल-पढ़ने वाला पता लगाना

Skills

Skills नाम से invoke की जाने वाली पुनः-प्रयोज्य प्रक्रियाएँ हैं। एक skill दोहराने योग्य workflow पैकेज करती है (tests चलाना, lint ठीक करना, component बनाना)।

पद्धति मूल sub-skills का छोटा समूह ship करती है। उनमें, author sub-skill रिपॉज़िटरी को अपनी kit बढ़ाने देती है: /skill-create और /agent-create के माध्यम से invoke, मौजूदा .agents/ लेआउट और परिपाटियों पर तर्क, फिर नई skill, agent, या thin command delegator जो उनसे मेल खाता हो, और कैटलॉग sync रखता है। वही sub-skill Final Review के स्किल्स समाधान पास का समर्थन करती है।

Kit प्रविष्टि: Skill create, Agent create।

Agents

Agents परिभाषित भूमिका वाले विशेषीकृत workers हैं (reviewer, executor, architect)। वे .agents/agents/ के अंतर्गत रहते हैं और .agents/docs/ में catalog होते हैं।

रखरखाव ऐडऑन

dependency-upgrade ऐडऑन (ऊपर) प्राथमिक रखरखाव ऐडऑन है। यह npm मानने के बजाय रिपॉज़िटरी के वास्तविक package manager पर तर्क करता है, semver द्वारा अपग्रेड वर्गीकृत करता है, सुरक्षित बैचों में अपग्रेड, हर बैच के बाद validation, विफल बैच revert।

Design-system ऐडऑन

Shipping ऐडऑन के अंतर्गत Design system देखें। रिपॉज़िटरी-स्तर DESIGN.md per-feature तकनीकी डिज़ाइन दस्तावेज़ से अलग है: DWP की योजना README, कार्य acceptance criteria, और validation gates पहले से per-feature डिज़ाइन कवर करते हैं। design-system ऐडऑन टिकाऊ, repo-native interface डिज़ाइन संदर्भ भरता है।

Presets

Presets DWP को विशिष्ट tech stack (Django, React, Go, Astro + Svelte, और अधिक) के अनुसार अनुकूलित करते हैं। kit catalog ब्राउज़ करें।

Adapters

Adapters DWP कमांड्स को विशिष्ट agent की कमांड प्रणाली (Claude Code, Cursor, Codex, Gemini, Copilot, OpenClaw, और अन्य) से map करते हैं। Adapter प्रविष्टियाँ kit में हर agent नाम के अंतर्गत रहती हैं।

Examples

Examples DWP को व्यवहार में दर्शाते हैं: before/after तुलना, नमूना योजनाएँ, case studies। Examples और Dogfood this site देखें।

अनुरूपता अनुस्मारक

रिपॉज़िटरी शून्य वैकल्पिक ऐडऑन के साथ पूर्णतः अनुरूप होनी चाहिए। ऐडऑन layered ऑप्ट-इन क्षमताएँ हैं — कभी पूर्वापेक्षाएँ नहीं। Conformance देखें।