Deep Work Plan dla programistów i agentów AI

Planuj i wykonuj za pomocą skilla

Powyższe API pozwala agentowi czytać tę witrynę. Skill DWP to to, co pozwala agentowi uruchamiać metodykę — zainstaluj go raz w repozytorium, a przyniesie router plus dziewięć sub-skilli, wywoływanych jako komendy ze slashem (albo po nazwie — dla agentów przechwytujących slash, większość używa zamiast tego #, np. #dwp-execute).

Dwa niezależne wybory: format i ile chcesz recenzji

Każdy plan wybiera jedną wartość na każdej osi. Są niezależne — plan Lite może działać w trust, plan Full może działać w guided, i każdy z nich może później przełączyć tryb bez zmiany formatu.

Dziewięć sub-skilli

Każdy sub-skill jest wywoływany jako komenda ze slashem wewnątrz repozytorium, które zainstalowało skilla — nie wobec tej witryny. Pełne odniesienie dla każdego znajduje się w katalogu kitu.

Dwa sposoby, by go uruchomić

Ten sam skill, te same dziewięć komend — format i tryb recenzji zmieniają się wraz z rozmiarem i stawką pracy, nie z narzędziem.

# A small, bounded fix: skip the review round, run it directly.
/dwp-create fix the flaky checkout test trust
/dwp-execute

# Long-horizon work with real stakes: review before anything runs.
/dwp-create migrate the billing service to the new payments API
# ...review the proposed plan, then:
/dwp-execute
# ...interrupted? pick up again, even in a fresh session:
/dwp-resume

Wynik każdego planu — manifest, log postępu, zapisy zadań, dowody bramek — żyje pod ignorowanym przez git katalogiem .dwp/ w samym repozytorium. Nic nie jest wysyłane do deepworkplan.com ani przez niego przechowywane; skill nie wykonuje żadnych połączeń sieciowych.

Punkty końcowe

Główne punkty końcowe agentowego API. Kompletna, typowana specyfikacja — każda operacja, parametr i schemat odpowiedzi — mieszka w dokumencie OpenAPI.

Nieznane ścieżki /api/* zwracają ustrukturyzowany błąd JSON z podpowiedzią rozwiązania, nigdy stronę błędu HTML.

Wersjonowanie i wycofywanie

Wersjonowana rodzina JSON żyje pod /api/v1/ — index, sections, pages i health — a kanoniczne ścieżki bez wersji (/llms.txt, /{page}.md, /api/mcp) należą do tego samego kontraktu v1. Zmiany łamiące zgodność wchodzą wyłącznie w nowej rodzinie /api/v{N+1}/, nigdy wewnątrz v1. Gdy endpoint jest wycofywany, jego odpowiedzi niosą Deprecation: true i datę Sunset co najmniej 180 dni przed usunięciem, a nagłówek Link wskazuje następcę.

Limity zapytań

Odpowiedzi na /api/* niosą nagłówki limitów RFC 9331 — RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset i RateLimit-Policy — dzięki czemu agenci mogą sami dostosowywać tempo w czasie rzeczywistym; odpowiedź 429 dodaje Retry-After. Egzekwowanie jest best-effort na krawędzi (120 zapytań na 60 sekund na odwiedzającego), a dostęp pozostaje anonimowy: bez kluczy, bez rejestracji, bez poziomów.

Serwer MCP

Bezstanowy serwer Model Context Protocol przez Streamable HTTP. Trzy narzędzia tylko do odczytu: get_init_prompt, list_site_sections i read_page. Obsługiwane wersje protokołu to 2025-03-26 i 2025-06-18; sesja nie jest wymagana.

# 1. Initialize (no session needed — the server is stateless)
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

# 2. Discover the tools
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. Call one — read any page as source Markdown
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"read_page","arguments":{"path":"/init"}}}'

Manifest MCP mieści się pod /.well-known/mcp.json, a karta serwera pod /.well-known/mcp/server-card.json. Claude, ChatGPT i każdy klient MCP mogą wywoływać te narzędzia natywnie.

Markdown dla agentów

Każda wyrenderowana strona jest publikowana jako natywny Markdown źródłowy — nie konwersja z HTML. Żądaj Markdown jawnie przez sufiks URL albo przez negocjację treści HTTP na dowolnej stronie.

# Ask for Markdown on any URL (content negotiation)
curl -s https://deepworkplan.com/methodology \
  -H 'Accept: text/markdown'

# Or fetch the .md mirror directly — every page has one, in every language
curl -s https://deepworkplan.com/es/developers.md

Negocjacja treści zwraca ten sam Markdown źródłowy, z którego renderuje witryna, w języku żądanego adresu URL.

Zainstaluj zestaw

Oficjalna ścieżka instalacji umiejętności Deep Work Plan — ta sama komenda, którą punkt końcowy /init przekazuje agentom. Działa z każdym agentem do kodu zgodnym ze skills (Claude Code, Cursor, Codex, Gemini i inne).

# 1. Install the DWP skill — same command the /init endpoint gives agents
npx skills add DailybotHQ/deepworkplan-skill@latest

# 2. Official CLI — zero-dependency client over this API (Node >= 18),
#    prepared in the site repo's cli/ directory pending npm publication
deepworkplan init
deepworkplan read /es/developers

Umiejętność wdraża się (vendoring) do .agents/skills/deepworkplan/ wewnątrz Twojego repozytorium, więc każdy agent dotykający repozytorium dzieli tę samą metodykę. Oficjalna CLI deepworkplan — klient bez zależności na tym samym API (init, sections, read, open, mcp) — jest przygotowana na npm i do publikacji żyje w katalogu cli/ repozytorium serwisu.

Zasoby czytelne maszynowo

• ▸ Specyfikacja OpenAPI (/openapi.json)
• ▸ Deklaracja dostępu i uwierzytelniania agentów (/auth.md)
• ▸ Katalog API, RFC 9727 (/.well-known/api-catalog)
• ▸ Manifest MCP (/.well-known/mcp.json)
• ▸ Kontakt bezpieczeństwa (/.well-known/security.txt)
• ▸ Deskryptor repozytorium witryny (/.well-known/dwp.json)

Skieruj na to agenta

Najszybsza ścieżka to wciąż jedna linijka: przekaż dowolnemu agentowi do kodu prompt /init, a on zainstaluje skill, zrobi onboarding repozytorium i zacznie kończyć głęboką pracę.