Dodatki

Wersja 2.1.0. Dodatki to rozszerzenia podstawowej metodyki Deep Work Plan. Cztery z pięciu są opcjonalne i nigdy nie są wymagane do zgodności — repozytorium bez opcjonalnych addonów jest w pełni AI-first i zgodne z DWP. Każdy opcjonalny addon jest proponowany podczas onboardingu, wyraźnie akceptowany lub odrzucany, a po akceptacji uzgadnia się z istniejącą konfiguracją zamiast ją nadpisywać. Jeden komponent jest zadeklarowanym wyjątkiem: od standardu 2.3.0 lokalny przegląd AI Diff Reviewer jest częścią wymaganej linii bazowej — onboarding go instaluje, a każde Final Review go uruchamia — podczas gdy jego powierzchnia CI pozostaje opcjonalna.

Kontrakt addonu

Każdy dostępny addon dostarcza cztery obowiązkowe komponenty:

Odkrywanie: przepływ onboard enumeruje skills/deepworkplan/addons/ i prezentuje każdy addon jako opcjonalny krok w Phase 7b, po podstawowym scaffoldingu.

Dostępne addony (pięć)

Dziś dostępne są pięć addonów — cztery opcjonalne plus wymagany lokalny przegląd. Każdy ma stronę katalogu kit ze szczegółami dla użytkownika oraz normatywną specyfikację w skillu Deep Work Plan.

Devcontainer (pierwszy addon)

Konfiguracja .devcontainer/ + docker/ oparta na compose, wywnioskowana z wykrytego stacku.

• Strona kit: Devcontainer
• Co dodaje: trwałe wolumeny auth AI-CLI (Claude, Codex, Cursor, gh, Dailybot), dailybot-project-network, DOCKER_DEV_ENV=vscode, aliasy walidacji (codecheck, check, fix, test), higiena sekretów public-OSS
• Zachowanie: ~85% stabilnego szkieletu; ~15% wywnioskowane per stack. Istniejące devcontainery są uzgadniane, nigdy nadpisywane
• Kiedy proponować: większość repo z Dockerem lub usługami korzystającymi z izolowanego kontenera dev

Dailybot (drugi addon)

Opcjonalne połączenie z zespołem Dailybot programisty dla widoczności postępu agenta.

• Strona kit: Dailybot — pełna referencja możliwości
• Co łączy addon DWP: cztery raporty cyklu życia planu (kickoff, significant task, blocked, completion) przez sub-skill dailybot report; opcjonalne deterministyczne wymuszanie hooków (dailybot hook, CLI >= 3.7.0)
• Sparowany skill: instalacja DailybotHQ/agent-skill (obecnie 3.10.3) udostępnia 14 możliwości — czat na Slack/Teams/Discord/Google Chat, check-iny, tworzenie formularzy, ask AI, kudos, klucze API per-repo (.dailybot/env.json), e-mail i więcej. Addon DWP łączy tylko report; pozostałe możliwości wywołuje się bezpośrednio przez skill Dailybot
• Auth: w pełni delegowane do skilla Dailybot (dailybot login lub DAILYBOT_API_KEY); ten addon nigdy nie przechowuje poświadczeń
• Zabezpieczenie neutralne wobec dostawcy: podstawowy DWP ma zero zależności od Dailybot; nigdy nie instaluj automatycznie dla wszystkich
• Kiedy proponować: programista lub zespół już korzysta z Dailybot lub wyraźnie prosi o raportowanie zespołowe

Dependency upgrade (trzeci addon)

Aktualizacje zależności niezależne od menedżera pakietów, partiami, zwalidowane i odwracalne.

• Strona kit: Dependency upgrade
• Co dodaje: wykrywa rzeczywisty menedżer repo (npm/pnpm/yarn + ncu, pip/poetry/uv, cargo, go mod, bundler, composer, …), aktualizuje w partiach sklasyfikowanych semver, uruchamia bramkę walidacji repo po każdej partii, cofa niepowodzenia, podsumowuje bez auto-commitu
• Polecenie: instaluje /lib-upgrade w .agents/commands/ tylko po akceptacji
• Kiedy proponować: proponowany dla każdego repo z zadeklarowanymi zależnościami; nieaktywny delegator /lib-upgrade instaluje się za zgodą onboardingu, chyba że zostanie jawnie odrzucony — instalacja nie uruchamia żadnego upgrade’u

Design system (czwarty addon)

DESIGN.md o zakresie powierzchni interfejsu, który czyta każdy agent kodujący dla spójnego UI, CLI lub wyjścia konwersacyjnego.

• Strona kit: Design system
• Co dodaje: docs/DESIGN.md (referencja z AGENTS.md) z maksymalnie trzema profilami w jednym pliku: visual-ui (tokeny i komponenty renderowanego UI), cli-output (semantyczne style terminala, degradacja TTY/NO_COLOR), conversational (głos, anatomia wiadomości, renderowanie per platforma z fallbackami plain-text)
• Siła profilu: wykrycie czyni propozycję obowiązkową; instalacja jest uzależniona od akceptacji — tak w trybie guidowanym, jak i trust — visual-ui zdecydowanie zalecany po wykryciu; cli-output i conversational zalecane przy wykryciu, zawsze pytane, nigdy auto-stosowane
• Kiedy proponować: tylko gdy wykryto powierzchnię interfejsu dla użytkownika — nie dla czystych bibliotek, usług headless ani repo tylko infra

AI Diff Reviewer (piąty addon — wymagany lokalny przegląd, opcjonalna powierzchnia CI)

AI Diff Reviewer (marketplace “AI Diff Reviewer”) nadaje obowiązkowemu przeglądowi bezpieczeństwa Final Review strukturalny lokalny przegląd i opcjonalnie blokuje pull requesty w CI. Od standardu 2.3.0 lokalny przegląd jest częścią linii bazowej; tylko powierzchnia CI jest opcjonalna. Ten addon jest automatycznie odświeżany przy każdym release’ie, więc jego aktualna wersja nigdy nie jest przypięta w tym tekście — sprawdź własny SKILL.md addonu lub jego wydania na GitHubie, aby poznać faktycznie zwendorowany tag.

• Strona kit: AI Diff Reviewer — pełna referencja możliwości
• Wymagany przy onboardingu (Phase 7a): instalacja vendored skilla przypięta do tagu (npx --yes skills add DailybotHQ/[email protected] --skill ai-diff-reviewer -y) plus dopasowane do repo .review/extension.md (przez generate-extension), za zgodą onboardingu; ukierunkowany upgrade harnessu uzgadnia oba elementy, gdy ich brakuje; odmowa jest zapisywana jako zadeklarowany wyjątek i zgłaszana przez verify do czasu instalacji
• Wymagany w każdym Final Review: przegląd bezpieczeństwa uruchamia domyślny przepływ nadrzędny upstream skilla na skumulowanym zestawie zmian i dołącza jego wynik do lokalnego dla planu analysis_results/SECURITY_REVIEW.md (wewnątrz własnego folderu planu, nigdy w katalogu głównym repo); brakująca skill lub rozszerzenie to zapisane znalezisko local reviewer not installed — nigdy ciche pominięcie i nigdy zaskakujący bootstrap: instalacja należy do zgody onboardingu albo jawnego wywołania addonu; wyniki critical ze zakończonego przebiegu blokują ukończenie do czasu naprawy lub wyraźnej akceptacji
• Opcjonalna powierzchnia CI (Flow B): pr-review.yml (DailybotHQ/ai-diff-reviewer@v2) przez upstream sub-skill setup, plus apply-review jako towarzysz wywoływany przez dewelopera — proponowany wyraźnie, nigdy instalowany nieproszony, nigdy domyślny, nigdy zadanie planu
• Nigdy nie blokuje (tylko wywołanie): lokalny przegląd, który mógł wystartować, ale kończy się błędem, to ostrzeżenie raz, zapis i kontynuacja; nigdy nie zawiedzie z tego powodu zadania
• Parytety (Flow B): wspólny prompt.md + rozszerzenie wyrównuje metodologię/ważność; CI Iteration-Aware Review może skrócić rundy 2+ podczas gdy lokalny przebieg pozostaje pełny
• Ochrona neutralna wobec dostawcy: żaden przepływ Deep Work Plan nie wymaga komercyjnej usługi, dostawcy CI ani sekretu — reviewer to skill na licencji MIT przypięty do tagu, uruchamiany przez własnego agenta kodującego dewelopera
• Zgodność: verify zgłasza brakujący lokalny reviewer jako niepowodzenie dla repozytoriów deklarujących standard 2.3.0 lub nowszy oraz jako znalezisko wersji harnessu dla starszych repozytoriów

Skille

Skille to powtarzalne procedury wywoływane po nazwie. Skill pakuje powtarzalny przepływ pracy (uruchamianie testów, naprawa lintu, tworzenie komponentu).

Metodyka dostarcza mały zestaw podstawowych sub-skilli. Wśród nich sub-skill author pozwala repozytorium rozwijać własny kit: wywoływany przez /skill-create i /agent-create, analizuje istniejący układ .agents/ i konwencje, tworzy nowy skill, agenta lub cienki delegator poleceń pasujący do nich i utrzymuje katalog w synchronizacji. Ten sam sub-skill wspiera przebieg uzgadniania skilli w Final Review.

Wpis kit: Skill create, Agent create.

Agenci

Agenci to wyspecjalizowani wykonawcy o zdefiniowanej roli (reviewer, executor, architect). Mieszkają w .agents/agents/ i są katalogowani w .agents/docs/.

Dodatki utrzymaniowe

Dodatek dependency-upgrade (powyżej) to główny addon utrzymaniowy. Analizuje rzeczywisty menedżer pakietów repo zamiast zakładać npm, klasyfikuje aktualizacje według semver, aktualizuje w bezpiecznych partiach, uruchamia walidację po każdej partii i cofa nieudane partie.

Dodatek design-system

Zobacz Design system w sekcji dostępnych addonów. DESIGN.md na poziomie repo różni się od technicznego dokumentu projektowego per funkcja: README planu DWP, kryteria akceptacji zadań i bramki walidacji już pokrywają projekt per funkcja. Addon design-system wypełnia trwały, repo-natywny kontekst projektowania interfejsu.

Presety

Presety dostosowują DWP do konkretnego stacku technologicznego (Django, React, Go, Astro + Svelte i więcej). Przeglądaj katalog kit.

Adaptery

Adaptery mapują polecenia DWP na system poleceń konkretnego agenta (Claude Code, Cursor, Codex, Gemini, Copilot, OpenClaw i inne). Wpisy adapterów w kit znajdują się pod nazwą każdego agenta.

Przykłady

Przykłady pokazują DWP w praktyce: porównania przed/po, przykładowe plany, studia przypadków. Zobacz Examples i Dogfood this site.

Przypomnienie o zgodności

Repozytorium MUSI być w pełni zgodne z zerem addonów. Addony to warstwowe, opcjonalne możliwości — nigdy warunki wstępne. Zobacz Conformance.