Skip to content
← Wszystkie dokumenty specyfikacji

Zgodność

Wersja 1.0. Status: Stabilny. Ten dokument definiuje, co oznacza, że repozytorium jest zgodne z Deep Work Plan — czyli AI-first i sterowalne przez agenta. Słowa kluczowe MUSI, NIE MOŻE, POWINNO, NIE POWINNO oraz MOŻE należy interpretować zgodnie z opisem w RFC 2119.

Zgodność istnieje po to, aby „AI-first“ było obiektywną, sprawdzalną właściwością, a nie wrażeniem. Repozytorium albo spełnia poniższe kryteria, albo nie. Sub-skill verify (/dwp-verify) sprawdza je mechanicznie.

Repozytorium zgodne

Repozytorium zgodne z DWP MUSI spełniać wszystkie poniższe warunki. Każdy artefakt MUSI być przemyślany pod kątem repozytorium — dostosowany do jego rzeczywistych języków, frameworków i komend. Ogólny szablon, placeholder lub treść skopiowana z innego repozytorium nie spełnia kryterium.

  1. AGENTS.md w katalogu głównym. Repozytorium MUSI zawierać w katalogu głównym AGENTS.md, który obejmuje (a) indeks dokumentacji, (b) obowiązkowe reguły dla repozytorium oraz (c) blok Quick Commands, którego komendy są rzeczywiste i uruchamialne w tym repozytorium. Komendy będące placeholderami (na przykład npm test w repozytorium, które nie używa npm) NIE MOGĄ się pojawiać.
  2. CLAUDE.md rozwiązuje się do AGENTS.md. CLAUDE.md MUSI istnieć i rozwiązywać się do AGENTS.md (jako dowiązanie symboliczne lub równoważne rozwiązanie gwarantujące jedno źródło prawdy). Te dwa pliki NIE MOGĄ się rozjechać.
  3. Hierarchia docs/. Repozytorium MUSI zawierać katalog docs/ obejmujący standardowe kategorie (architektura, standardy, testowanie, komendy deweloperskie, bezpieczeństwo oraz onboarding agentów) z rzeczywistą, specyficzną dla repozytorium treścią. Złożone moduły POWINNY mieć własny README.md.
  4. Dom .agents/. Repozytorium MUSI zawierać katalog .agents/ z agents/, commands/ i skills/, a także katalog pod .agents/docs/, który odpowiada temu, co znajduje się na dysku. Komendy dwp-* MUSZĄ być cienkimi delegatorami do zainstalowanego skilla. Ścieżka .claude MUSI rozwiązywać się do .agents.
  5. Przestrzeń robocza .dwp/ w gitignore. Repozytorium MUSI zawierać katalog .dwp/ z plans/ i drafts/, a .dwp/ MUSI być w gitignore. Przestrzeń robocza tmp/ POWINNA istnieć i POWINNA być w gitignore.
  6. Skill metodyki jest rozwiązywalny. Skill Deep Work Plan MUSI być zainstalowany lub do niego dowiązany w taki sposób, aby agent w repozytorium mógł wywoływać jego sub-skille.

Repozytorium jest w pełni zgodne przy zerowej liczbie dodatków. Dodatki (devcontainer, Dailybot, dependency-upgrade) są opcjonalne i NIE MOGĄ być wymagane do zgodności.

Dobrze sformułowany plan

Deep Work Plan w .dwp/plans/ jest dobrze sformułowany, gdy:

  1. Każde zadanie MUSI deklarować jawny zakres, kryteria akceptacji oraz co najmniej jedną bramkę walidacyjną (komendę lub kontrolę, która obiektywnie przechodzi lub zawodzi).
  2. Plan MUSI utrwalać postęp tak, aby praca przetrwała przerwanie i mogła zostać wznowiona przez innego agenta.
  3. Plan MUSI zawierać dwa obowiązkowe zadania końcowe — odkrywanie skilli i agentów oraz raport wykonawczy.
  4. Zadania POWINNY ponownie zakotwiczać się w celu planu przed wykonaniem, aby zapobiec dryfowi w długim horyzoncie.

Weryfikacja zgodności

Zgodność POWINNA być weryfikowana mechanicznie, a nie przez inspekcję. Uruchomienie /dwp-verify generuje raport zaliczenia/niezaliczenia względem powyższych kryteriów: obecności i rzeczywistej treści AGENTS.md, rozwiązania CLAUDE.md, kategorii docs/, zgodności katalogu .agents/ z dyskiem, statusu gitignore dla .dwp/ i tmp/ oraz — dla planu — tego, że każde zadanie ma kryteria akceptacji i bramkę walidacyjną.

Repozytorium POWINNO być ponownie weryfikowane po onboardingu i po każdym ukończonym planie, aby zgodność była utrzymywana, a nie deklarowana jednorazowo.