deepworkplan-onboard

Ubah sebuah repositori menjadi codebase AI-first yang spec-driven. Ini adalah sub-skill onboard dari skill Deep Work Plan.

Fungsinya

deepworkplan-onboard memeriksa repositori yang nyata — bahasa, framework, package manager, command build/test/lint, modul, konvensi pengujian, bentuk deployment — lalu menghasilkan artefak yang teradaptasi untuknya. Ia menalar; ia tidak pernah menyalin template atau meninggalkan placeholder.

Penggunaan

/deepworkplan-onboard

Perilaku

1. Reconnaissance — deteksi stack dan command validasi yang sebenarnya; cocokkan dengan preset onboarding terdekat.
2. Arketipe — klasifikasikan sebagai repositori individual atau orchestrator hub.
3. Hasilkan AGENTS.md + symlink CLAUDE.md dengan blok Quick Commands yang nyata.
4. Hasilkan docs/ (arsitektur, standar, pengujian, keamanan, dan lainnya) serta dokumen per modul.
5. Hasilkan .agents/ (agent, command dwp-* yang ramping, skill sesuai stack, katalog) + .claude → .agents.
6. Pasang skill dan siapkan .dwp/ ber-gitignore (plan, draft) serta ruang kerja sementara tmp/.
7. Pasang tinjauan lokal AI Diff Reviewer yang wajib; deteksi setiap addon, tingkatkan yang digunakan repositori, dan tawarkan yang cocok (tidak pernah satu pun hanya untuk melengkapi set); lalu lakukan swauji.

Catatan

Sebuah repositori sepenuhnya konform tanpa addon opsional sama sekali; tinjauan lokal AI Diff Reviewer adalah bagian dari baseline sejak standar 2.3.0. Realitas yang terdeteksi selalu mengalahkan asumsi preset.

Referensi skema v7

Untuk rencana v7 — default paket 7.x saat ini — katalog skema yang dapat dibaca mesin diterbitkan pada URL stabil berikut. Proyeksi aktif adalah snapshot yang digunakan bersama dengan v6; plan-state/v6.json maupun plan-state/v7.json tidak ada.

• Plan manifest: https://deepworkplan.com/schema/plan-manifest/v7.json
• Plan contract: https://deepworkplan.com/schema/plan-contract/v7.json (kontrak v6 ditambah penanda tugas parallel_safe opsional)
• Journal event: https://deepworkplan.com/schema/journal-event/v7.json (menambahkan peristiwa delegation)
• Plan snapshot (proyeksi aktif, digunakan bersama dengan v6): https://deepworkplan.com/schema/plan-snapshot/v6.json
• Context manifest (digunakan bersama dengan v6): https://deepworkplan.com/schema/context-manifest/v6.json
• Konfigurasi repositori: https://deepworkplan.com/schema/dwp-config/v1.json
• Deskriptor addon: https://deepworkplan.com/schema/addon-descriptor/v1.json
• Paket serah terima swarm: https://deepworkplan.com/schema/dwp-handoff/v1.json
• Catatan benchmark: https://deepworkplan.com/schema/benchmark-record/v1.json
• Catatan pembelajaran: https://deepworkplan.com/schema/learnings-record/v1.json

Rencana v6 mempertahankan skema v6-nya (manifest, kontrak, peristiwa jurnal); rencana v5 yang ada tetap menggunakan skema status v5, dan rencana lama tidak pernah ditulis ulang secara diam-diam.

Paket 7.x saat ini membuat rencana baru menggunakan v7 secara default. Rencana yang ada mempertahankan generasi tercatat; migrasi memerlukan permintaan eksplisit. Rencana baru mendapat ID numerik yang meningkat monoton dengan sedikitnya tiga digit (misalnya PLAN_001_add_payment_webhooks/). Skema v5 yang dibekukan menghitung ID numerik sebagai satu kata, sehingga slug v5 terdiri dari 2–4 kata dan slug v7 dari 2–5 kata. Folder lama tanpa nomor PLAN_<slug>/ tetap dapat dibaca dan tidak pernah diganti namanya. Jika ada rencana bernomor, latest merujuk ke rencana dengan ID numerik tertinggi.