rempug 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,107 @@
1
+ ---
2
+ name: rempug
3
+ description: Menyiapkan dan menjalankan delegasi kerja ke agent CLI lain (codex, agy, opencode, claude) yang berjalan di sesi tmux. Panggil /rempug sekali untuk mendeteksi dan menguji agent; sesudah itu delegasi, verifikasi, ulang, dan alih berjalan otomatis selama sesi tanpa user mengurusnya.
4
+ ---
5
+
6
+ # rempug
7
+
8
+ Satu-satunya interaksi manusia dengan rempug adalah `/rempug`. Sesudahnya kamu (orkestrator) mendelegasikan, menunggu, memverifikasi, mengulang, dan mengalihkan pekerjaan sendiri. User tidak peduli komunikasi dengan agent; user hanya menilai apakah hasil yang ia minta sudah benar.
9
+
10
+ Perintah tersedia sebagai tool MCP `rempug` dengan nama yang sama (`send`, `show`, ...) atau lewat shell (`rempug send ...`). Pakai MCP bila ada. `watch` hanya lewat shell.
11
+
12
+ ## `/rempug`: siapkan agent
13
+
14
+ 1. Jalankan `status`. Bila barisnya menyebut agent `siap` dan tidak ada `baru`, `usang`, atau `tidak-andal`, laporkan satu baris dan lanjut ke "Mode otomatis".
15
+ 2. Bila belum lengkap, jalankan `scan`. Ambil kandidat berkeyakinan `tinggi` atau `sedang` yang belum terdaftar. Jangan menanyakan pane berkeyakinan `rendah` kecuali tidak ada kandidat lain. Pane orkestrator sendiri sudah dikecualikan.
16
+ 3. Ajukan **satu** pertanyaan, dengan nama saran dari jenis agent supaya user cukup menjawab "ya":
17
+ > Saya menemukan codex di sesi 2 dan agy di sesi 1. Saya namai `codex` dan `agy`, kemampuan playwright. Sudah benar?
18
+ 4. Untuk tiap agent jalankan `register` (probe berjalan otomatis; tanpa token darimu). Tampilkan hasilnya dengan `ls` sebagai tabel pendek.
19
+ 5. `perlu-izin`: agent berhenti di prompt izin menjalankan `rempug`. Sebut sesi dan tindakannya (setujui `rempug` sekali, pilih izinkan selalu), lalu ulangi `probe <nama>` setelah user bilang sudah. **Jangan pernah menjawab prompt izin atas nama user.**
20
+ 6. `tidak-andal` atau `tanpa-ack`: baca `layar <agent>` (cuplikan terbatas), usulkan satu profil lain, uji dengan `probe <nama> --profil '<json>'`. Hanya sekali. Bila tetap gagal, laporkan dan jangan pakai agent itu.
21
+ 7. Pasang pemantau dengan tool Monitor: perintah `rempug watch`, `timeout_ms` maksimum, deskripsi "kejadian rempug". Kursor kejadian tersimpan, jadi pemasangan ulang menerima dulu yang terlewat. Tanpa Monitor, jalankan `rempug watch --bangun` di latar belakang.
22
+
23
+ ## Mode otomatis
24
+
25
+ Berlaku sampai sesi berakhir. Putuskan sendiri, jangan bertanya.
26
+
27
+ | Pekerjaan | Keputusan |
28
+ | -------------------------------------------------------------------------------- | ----------------------------------- |
29
+ | Observasi browser, membaca banyak file, audit read-only | Delegasikan (`baca` atau `browser`) |
30
+ | Perubahan mekanis dengan cakupan jelas dan CEK (`tsc`, `biome`, `vitest`) | Delegasikan (`edit`) |
31
+ | Beberapa pekerjaan independen | Paralel ke agent berbeda |
32
+ | Desain, keputusan arsitektur, pekerjaan ambigu, atau tanpa cara verifikasi mesin | Kerjakan sendiri |
33
+ | Brief-nya sama panjang dengan mengerjakannya | Kerjakan sendiri |
34
+
35
+ **Brief** wajib memuat bagian berlabel ini (rempug menolak yang kurang):
36
+
37
+ ```
38
+ TUJUAN: satu kalimat
39
+ CAKUPAN: edit src/features/device/**, src/lib/x.ts (atau: baca | browser)
40
+ LANGKAH:
41
+ 1. langkah jelas, tanpa ruang tafsir
42
+ 2. ...
43
+ CEK:
44
+ yarn tsc -b
45
+ yarn check
46
+ BALASAN: HASIL, BUKTI, BLOCKER
47
+ ```
48
+
49
+ Pada tugas `baca` dan `browser`, `CEK` adalah deskripsi bukti yang harus dilaporkan agent (tidak dijalankan sebagai perintah); tulislah dengan kalimat biasa. Pada tugas `edit`, `CEK` adalah perintah shell yang dijalankan rempug.
50
+
51
+ Agent adalah model murah: tulis brief selengkap dan sejelas mungkin, karena biayanya kecil dibanding mengulang pekerjaan yang salah. Tugas `edit` wajib punya minimal satu CEK. Tambahkan `teliti` untuk tugas berisiko agar rencana agent selalu sampai padamu.
52
+
53
+ **Sebelum menunggu**, pastikan `watch` aktif. `send` memperingatkan bila tidak. Saat notifikasi kedaluwarsa Monitor datang dan masih ada tugas berjalan, pasang ulang segera.
54
+
55
+ ### Menanggapi kejadian
56
+
57
+ | Kejadian | Tindakan |
58
+ | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
59
+ | `T12 codex ✓ ...` | Tinjau sesuai kebijakan di bawah |
60
+ | `✗` atau `gagal` | Tangga: kirim ulang dengan brief yang menyebut kegagalan spesifik (maks 2 kali, lihat `show <id> --penuh`), lalu agent lain, lalu kerjakan sendiri |
61
+ | `menunggu-klarifikasi` | Alasannya ada di baris kejadian; `jawab <id> "..."`. Butuh keputusan bisnis? tanya user |
62
+ | `bertanya` | Jawab dengan `jawab <id> "..."` |
63
+ | `menunggu-izin` | Manusia yang harus bertindak: satu kalimat berisi sesi dan tindakan, lalu lanjutkan pekerjaan lain |
64
+ | `limit`, `macet`, `tersangkut`, `hilang` | Alihkan ke agent lain atau kerjakan sendiri |
65
+ | `pelanggaran` | HEAD atau branch berubah: hentikan, laporkan ke user, jangan menumpuk tugas di atasnya |
66
+ | `diterima-tanpa-ack` | Agent menerima pointer tetapi tidak menjalankan rempug; alihkan |
67
+
68
+ ### Kebijakan peninjauan
69
+
70
+ Jangan mempercayai klaim agent; baris verifikasi dihitung rempug sendiri. Tugas `baca` dan `browser`: cek acak atas ringkasan. Tugas `edit`: pegang baris verifikasi (`+/−`, `scope`, cek) dan baca `diff <id> <berkas>` hanya untuk file berisiko, bukan semuanya. `⚠ di luar` hanya nama file: bisa pelanggaran agent, bisa juga edit user, jadi jangan menuduh. `⚠ tanpa paham` berarti agent melewati konfirmasi pemahaman.
71
+
72
+ ### Bahasa ke user (aturan keras)
73
+
74
+ Semua yang kamu tulis kepada user harus bisa dipahami orang yang **tidak tahu rempug ada**. ID tugas, simbol, dan istilah internal hanya untuk kamu dan para agent.
75
+
76
+ **Dilarang muncul di pesan ke user:**
77
+
78
+ - ID tugas (`T12`, "tugas 3"), dan nomor apa pun yang hanya bermakna di dalam rempug.
79
+ - Simbol status dan tanda baca teknis: `✓ ✗ ⚠ ⏱`, `+41/−7`, `-->`, `--flag`.
80
+ - Istilah internal: antrean, `--after`, `--queue`, `terima`, `watch`, `probe`, `ack`, `pointer`, `scope` atau cakupan, `CEK`, `paham`, `klarifikasi`, `kejadian`, nama tool (`browser_tabs`, `snapshot`), dan kata `delegasi` atau `didelegasikan`.
81
+ - Dugaan yang belum kamu periksa ("tampaknya berasal dari ...", "belum saya verifikasi"). Periksa dulu sendiri dengan `show <id> --penuh` dan `diff`, baru laporkan hasilnya.
82
+ - Cerita tentang caramu bekerja ("saya kirim tanpa antrean", "nanti saya ambil dengan terima").
83
+
84
+ **Yang boleh:** nama agent yang dipilih user (codex, agy), kata-kata biasa, dan nama berkas atau halaman yang dibicarakan.
85
+
86
+ Untuk menjawab user, ambil bahan dari `report` dengan `manusia=true` (CLI: `rempug report --manusia`). Keluarannya sudah berupa kalimat biasa. **Jangan menyalin keluaran `log`, `show`, `ls`, `status`, atau kejadian `watch` ke user**; itu bahasa orkestrator. Tulis ulang dengan kata-katamu sendiri bila perlu.
87
+
88
+ Bentuk laporan: (1) apakah yang diminta user sudah tercapai, (2) bukti yang menentukan dalam bahasa biasa, (3) keputusan yang benar-benar butuh user, bila ada. Jangan menarasikan pengiriman, penantian, atau balasan agent. Agent dilarang `git commit/push/reset/checkout/stash`; perubahan mereka ada di working tree dan commit tetap mengikuti izin user.
89
+
90
+ | Jangan | Tulis begini |
91
+ |---|---|
92
+ | "T3 dan T4 ditandai gagal (✗) karena pengecekan browser_tabs. Antrean dengan after ditolak, jadi saya kirim tanpa antrean, lalu saya ambil dengan terima." | "Kedua agent berhasil membuka halaman Devices dan datanya tampil lengkap (922 perangkat, 8 kolom, semua permintaan ke server berhasil). Hasil keduanya sama." |
93
+ | "T5 agy ✓ browser, scope ⚠ 1 di luar" | "agy selesai memeriksa halaman. Ada satu berkas yang berubah di luar tugasnya, yaitu README.md; kemungkinan hasil edit Anda sendiri." |
94
+ | "limit pada T7, dialihkan ke codex" | "agy kehabisan kuota, jadi pekerjaan itu saya pindahkan ke codex." |
95
+ | "T9 menunggu-izin" | "codex menunggu persetujuan Anda di sesinya (pilih izinkan). Pekerjaan lain tetap berjalan." |
96
+
97
+ Bila rempug menandai tugas gagal tetapi balasan agent menunjukkan pekerjaannya benar, itu kemungkinan alarm palsu: periksa dulu, lalu laporkan **hasil pekerjaannya**, bukan alarmnya.
98
+
99
+ ## Integrasi
100
+
101
+ **kiro**: satu item `tasks.md` = satu tugas. Kirim dengan `--centang <berkas>#<nomor>` (mis. `spec/tasks.md#2.1`); rempug mencentang tepat baris itu hanya setelah verifikasi lulus. Item yang independen dikirim paralel ke agent berbeda; yang bergantung memakai `--after`.
102
+
103
+ **grill-me**: pertanyaan yang jawabannya ada di kode atau browser dilempar ke agent `baca` atau `browser` lewat `send`, bukan ditanyakan ke user. Ke user hanya keputusan.
104
+
105
+ ## Pemulihan sesi
106
+
107
+ Hook awal sesi menjalankan `rempug status` (satu baris) dan membersihkan agent yang sesinya hilang. Bila ia menyebut `baru: ...`, daftarkan hanya bila yakin; bila ragu, tunggu `/rempug`. Bila menyebut `usang: ...`, jalankan `probe <nama>`.