Skip to content
Deep Work Plan hadir di Product Hunt hari ini Dukung kami

Permukaan agent & pengembang

Deep Work Plan untuk pengembang dan agent AI

deepworkplan.com menghadirkan permukaan yang dapat dibaca mesin di samping halamannya: API agent yang dideskripsikan OpenAPI, server MCP stateless, mirror Markdown native untuk setiap halaman dalam 17 bahasa, dan skill DWP yang dapat dipasang. Semua di halaman ini live, publik, dan gratis — tidak ada yang perlu didaftarkan.

Tanpa autentikasi secara desain

Tidak ada kunci API untuk dibuat, tidak ada alur OAuth, dan tidak ada sandbox yang terpisah dari produksi — permukaan produksi itu sendirilah sandbox-nya. Ini adalah properti metodologi yang disengaja: agent tidak bisa mengisi formulir "hubungi sales", jadi situs ini tidak pernah memintanya.

Read-only

Setiap operasi adalah GET yang aman dan dapat di-cache — kecuali endpoint MCP, yang merupakan POST. Tidak ada operasi tulis, unggahan, atau perubahan status di mana pun.

Tanpa kunci API

Tidak ada registrasi, tidak ada token, tidak ada tingkat rate limit. Akses anonim adalah kontrak terdokumentasi, dinyatakan di /auth.md dan stub penemuan OAuth.

Gratis & open source

Konten situs dan skill DWP berlisensi MIT. Gunakan dalam pekerjaan komersial dan non-komersial tanpa perlu meminta izin.

Machine-first

Error JSON terstruktur pada path /api, body pemulihan 404 Markdown, katalog API RFC 9727, dan manifest kapabilitas ARD — dibangun untuk konsumsi agent.

Merencanakan dan menjalankan dengan skill

API di atas memungkinkan agent membaca situs ini. Skill DWP adalah yang memungkinkan agent menjalankan metodologinya — pasang sekali di sebuah repositori, dan skill ini membawa router beserta sembilan sub-skill, dipanggil sebagai slash command (atau dengan namanya, untuk agent yang meng-intercept slash — kebanyakan memakai # sebagai gantinya, misalnya #dwp-execute).

Dua pilihan independen: format, dan seberapa banyak review yang Anda inginkan

Setiap rencana memilih satu nilai dari masing-masing sumbu. Keduanya independen — rencana Lite bisa berjalan dalam mode trust, rencana Full bisa berjalan dalam mode guided, dan keduanya bisa berganti mode nanti tanpa mengganti format.

Lite

Catatan tugas hidup langsung di README rencana, di balik anchor #task-N yang stabil — tanpa file tugas terpisah. Dibuat untuk pekerjaan kecil dan berbatas: satu concern, kira-kira satu sesi kerja. Tetap rencana yang lengkap: id tugas yang stabil, sebuah Touched Surface, kriteria penerimaan, sebuah validation gate, dan Final Review — tidak pernah sekadar sketsa yang dipangkas.

Full

Satu file per tugas di bawah N.task_<slug>.md, untuk pekerjaan berjangka panjang yang berlangsung berjam-jam atau berhari-hari, atau ketika sebuah rencana memiliki dependensi nyata antar tugas. Sebuah rencana Lite dipromosikan ke Full belakangan dengan /dwp-refine promote saat catatan ringkas tidak lagi cukup — promosi tidak pernah menjalankan ulang pekerjaan yang sudah selesai.

Guided (bawaan)

dwp-create menganalisis goal, menguraikannya, dan mewujudkan rencana yang dapat ditinjau — yang sudah merupakan rencana nyata dan dapat dieksekusi, bukan sekadar draf yang akan dibuang — lalu bertanya: pertahankan, promosikan Lite ke Full, edit, atau hentikan. Manusia tetap berada dalam loop sebelum pekerjaan produk apa pun dimulai. Direkomendasikan untuk beberapa kali pertama, atau untuk apa pun yang risikonya lebih tinggi.

Trust (atau auto)

Tambahkan trust (atau auto) sebagai kata terakhir — misalnya /dwp-create <goal> trust — dan agent melewati putaran review, mewujudkan rencana yang sudah disetujui sebelumnya, dan langsung mengembalikan perintah execute. Jalan pintas power-user begitu Anda percaya pada alurnya; tetap mencatat setiap keputusan dan gate, hanya saja tidak berhenti untuk bertanya.

Sembilan sub-skill

Setiap sub-skill dipanggil sebagai slash command di dalam repositori yang memasang skill tersebut — bukan terhadap situs web ini. Referensi lengkap untuk masing-masing ada di kit catalog.

Sembilan sub-skill
/dwp-create <goal> Mengubah sebuah goal menjadi rencana — Lite secara bawaan, Full untuk pekerjaan yang lebih besar, kedua mode dipilih dari tabel di atas.
/dwp-execute Menjalankan rencana yang ada tugas demi tugas: membacanya secara utuh, mengeksekusi setiap tugas secara berurutan, memvalidasi gate-nya, memperbarui progres.
/dwp-refine Menambah, menghapus, atau menyusun ulang urutan tugas dalam rencana yang ada sambil menjaga pekerjaan yang sudah selesai beserta buktinya yang tercatat.
/dwp-resume Merekonstruksi status dari file-file rencana itu sendiri dan melanjutkan rencana yang terhenti dari tugas pertamanya yang belum selesai.
/dwp-status Melaporkan progres sebuah rencana — tugas yang selesai, sedang berjalan, tertunda — tanpa membuat perubahan apa pun.
/dwp-verify Memeriksa secara mekanis apakah repositori bersifat AI-first dan apakah rencananya terbentuk dengan baik. Tidak mengubah apa pun; melaporkan lulus atau gagal.
/deepworkplan-onboard Menjadikan sebuah repositori AI-first: bernalar tentang stack-nya, lalu menghasilkan AGENTS.md, docs/, .agents/ yang disesuaikan, dan .dwp/ yang di-gitignore.
/skill-create, /agent-create Sub-skill penulis: menumbuhkan kit milik repositori itu sendiri — sebuah skill yang dapat dipakai ulang untuk prosedur yang berulang, atau sebuah agent untuk peran berulang dengan model dan tool-nya sendiri.
/dwp-upgrade Memeriksa apakah ada rilis skill baru yang dipublikasikan dan, hanya setelah persetujuan eksplisit, memasangnya lalu menjalankan ulang onboarding sebagai proses baru — setiap rencana yang sedang berjalan di bawah .dwp/ dibiarkan tidak tersentuh.

Dua cara menjalankannya

Skill yang sama, sembilan perintah yang sama — format dan mode review berubah mengikuti besar dan taruhan pekerjaannya, bukan alatnya.

Perbaikan kecil dan berbatas — Lite, trust

Satu concern, kira-kira satu sesi kerja, risiko rendah: lewati putaran review dan biarkan agent langsung mewujudkan serta menjalankan rencana Lite.

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

Pekerjaan berjangka panjang — Full, guided

Ada dependensi nyata antar tugas, atau risikonya lebih tinggi: tinjau rencana yang diusulkan sebelum pekerjaan produk apa pun dimulai, promosikan ke Full jika ternyata goal-nya membutuhkan itu, lalu eksekusi dan lanjutkan lintas sesi sesuai kebutuhan.

Terminal — slash command
# 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

Output setiap rencana — manifest, progress log, catatan tugas, bukti gate — hidup di dalam direktori .dwp/ yang di-gitignore, di dalam repositori itu sendiri. Tidak ada yang dikirim ke atau disimpan oleh deepworkplan.com; skill ini sama sekali tidak melakukan panggilan jaringan.

Endpoint

Endpoint inti dari API agent. Spesifikasi lengkap dan bertipe — setiap operasi, parameter, dan skema respons — berada di dokumen OpenAPI.

Endpoint
GET /openapi.json Spesifikasi OpenAPI 3.1 dari seluruh API agent.
GET /llms.txt Indeks panduan LLM terkurasi — titik masuk yang direkomendasikan untuk agent.
GET /init.md Prompt adopsi DWP kanonik (jadikan repositori apa pun AI-first).
GET /{page}.md Halaman apa pun sebagai Markdown sumber native — dalam semua 17 bahasa (mis. /es/developers.md).
GET /api/health.json Penanda health statis dengan link ke spesifikasi dan portal ini.
GET /api/v1/index.json Katalog berversi dari keluarga v1: jalur endpoint, versi situs, dan tautan ke spesifikasi.
GET /api/v1/sections.json Peta situs sebagai JSON bertipe — nama, jalur, dan deskripsi per bagian.
GET /api/v1/pages.json Setiap endpoint Markdown dalam setiap bahasa, dikelompokkan per kode bahasa.
GET /api/v1/health.json Penanda kesehatan berversi — cermin v1 dari /api/health.json.
POST /api/mcp Server MCP (Streamable HTTP, stateless): initialize, ping, tools/list, tools/call.
GET /.well-known/ai-catalog.json Manifest kapabilitas ARD — agentmap yang dinyatakan di robots.txt.

Path /api/* yang tidak dikenal mengembalikan error JSON terstruktur dengan petunjuk resolusi, bukan halaman error HTML.

Pemberversian dan deprekasi

Keluarga JSON berversi berada di bawah /api/v1/ — index, sections, pages, dan health — dan jalur kanonik tanpa versi (/llms.txt, /{page}.md, /api/mcp) termasuk dalam kontrak v1 yang sama. Perubahan yang merusak kompatibilitas hanya dikirim dalam keluarga /api/v{N+1}/ baru, tidak pernah di dalam v1. Saat sebuah endpoint dideprekasi, responsnya membawa Deprecation: true dan tanggal Sunset setidaknya 180 hari sebelum penghapusan, dan header Link menunjuk ke penerusnya.

Batas laju permintaan

Respons pada /api/* membawa header batas laju RFC 9331 — RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, dan RateLimit-Policy — agar agent dapat mengatur dirinya secara real-time; respons 429 menambahkan Retry-After. Penegakan dilakukan sebaik mungkin di edge (120 permintaan per 60 detik per pengunjung) dan akses tetap anonim: tanpa kunci, tanpa pendaftaran, tanpa tingkatan.

Server MCP

Server Model Context Protocol stateless melalui Streamable HTTP. Tiga tool read-only: get_init_prompt, list_site_sections, dan read_page. Versi protokol 2025-03-26 dan 2025-06-18 didukung; tidak ada sesi yang diperlukan.

Terminal — JSON-RPC over HTTP
# 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 berada di /.well-known/mcp.json dan kartu server di /.well-known/mcp/server-card.json. Claude, ChatGPT, dan klien MCP apa pun dapat memanggil tool ini secara native.

Markdown untuk agent

Setiap halaman yang dirender diterbitkan sebagai Markdown sumber native — bukan konversi HTML. Minta Markdown secara eksplisit dengan sufiks URL atau melalui negosiasi konten HTTP di halaman mana pun.

Terminal — negosiasi konten
# 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

Negosiasi konten mengembalikan Markdown sumber yang sama dengan yang dirender situs, dalam bahasa URL yang Anda minta.

Pasang kit

Jalur instalasi resmi untuk skill Deep Work Plan — perintah yang sama dengan yang diberikan endpoint /init kepada agent. Bekerja dengan coding agent apa pun yang kompatibel dengan skills (Claude Code, Cursor, Codex, Gemini, dan lainnya).

Terminal — skills CLI dan CLI resmi
# 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

Skill di-vendor ke dalam .agents/skills/deepworkplan/ di dalam repositori Anda, sehingga setiap agent yang menyentuh repo berbagi metodologi yang sama. CLI resmi deepworkplan — klien tanpa dependensi di atas API yang sama (init, sections, read, open, mcp) — telah disiapkan untuk npm dan berada di direktori cli/ repositori situs hingga dipublikasikan.

Sumber daya yang dapat dibaca mesin

Arahkan sebuah agent ke sini

Jalur tercepat tetap satu baris: berikan prompt /init kepada coding agent mana pun dan ia memasang skill, onboarding repositori Anda, dan mulai menyelesaikan deep work.