install-maintenance-graft-rtk-ponytail-lite

Prompt

# Instalasi dan Pemeliharaan Terverifikasi — Graft + RTK + Ponytail lite

Anda sedang bekerja di repositori saat ini untuk menginstal, memperbarui, memperbaiki, atau memverifikasi stack ini:

- Graft: pemahaman kode, grafik lokal, dan pengayaan LSP.
- RTK: pengurangan noise terminal.
- Ponytail: kebijakan lite, dengan integrasi native saat kompatibel.

Mulailah dengan inventarisasi hanya baca. Kemudian tanyakan pertanyaan yang belum terjawab di bawah.
Setelah jawaban, lakukan operasi yang diizinkan hingga pemeriksaan akhir.

Jangan mulai instalasi sebelum menentukan klien dan cakupan.
Jangan tanya lagi untuk keputusan yang sudah diberikan dalam percakapan ini.

## 1. Inventarisasi, lalu pilihan pengguna

### Inventarisasi tanpa modifikasi

Identifikasi:

- OS, arsitektur, shell, lingkungan: mesin lokal, WSL, SSH, container;
- root repositori, worktree, status Git dan operasi Git yang sedang berlangsung;
- jalur aktual, versi, dan metode instalasi Git, Node, npm, RTK, Graft, dan klien yang tersedia;
- Claude Code, Codex, Kimi, Cursor Agent CLI, dan Cursor IDE secara terpisah;
- Gemini, Copilot CLI, atau klien lain yang sudah ada sebagai target opsional;
- direktori konfigurasi yang benar-benar digunakan, variabel pengalihan, dan orchestrator seperti AgentsRoom;
- konfigurasi pengguna, proyek, plugin, dan hook yang diwariskan yang ada.

Verifikasi identitas `agent` sebelum menganggapnya sebagai Cursor.
Binary yang ada tidak membuktikan autentikasi, fungsi hook, atau pemuatan MCP.

Jangan jalankan pembaruan otomatis, koneksi, atau instalasi selama inventarisasi ini.
Jangan publikasikan nilai rahasia apapun.

Tampilkan tabel singkat:
Client | Binary/versi | Konfigurasi efektif | Status diketahui.

### Pertanyaan yang harus diajukan dalam satu batch

Tanyakan hanya pertanyaan yang jawabannya belum ada:

1. Operasi:
   - Instal komponen yang hilang dan pertahankan versi kompatibel.
   - Perbarui stack ke versi stabil yang terverifikasi.
   - Perbaiki instalasi yang ada sambil mempertahankan versinya.
   - Verifikasi saja, tanpa modifikasi.

2. Klien:
   - Semua klien yang terdeteksi.
   - Pilihan dari daftar yang benar-benar terdeteksi.
   - Juga siapkan konfigurasi untuk beberapa klien yang tidak ada.

3. Cakupan integrasi:
   - Proyek bersama: konfigurasi portabel yang ditujukan untuk repositori.
   - Proyek pribadi: aktivasi untuk repositori ini, file lokal yang tidak versi.
   - Pengguna global: aktivasi untuk proyek pengguna ini.
   - Campuran: pilihan berbeda menurut klien atau komponen.

Jika cakupan campuran, tanyakan hanya klarifikasi yang diperlukan.

Untuk pembaruan, juga tanyakan batasan versi jika belum diketahui.
Jika tidak, usulkan versi stabil yang eksplisit.

Jangan instal atau perbarui aplikasi klien itu sendiri:
operasi ini berkaitan dengan Graft, RTK, Ponytail, dan dependensi yang diperlukan.
Klien yang usang dilaporkan dengan versi yang dibutuhkan dan tindakan yang tersisa.

### Buat pilihan menjadi konkret

Sebelum menulis, tampilkan hasil yang direncanakan:

Komponen/klien | Versi target | Cakupan | File yang ditargetkan | Efek bersama | Cadangan

Jelaskan terutama:

- Eksekutabel yang diinstal di tingkat pengguna dapat melayani beberapa repositori.
- Memperbarui eksekutabel ini memengaruhi semua pengguna lokalnya.
- Plugin mungkin memiliki cache global tapi aktivasi per proyek.
- Hook per proyek masih dapat menggunakan status bersama.
- Indeks Graft tetap spesifik untuk repositori/worktree.
- Konfigurasi global yang disediakan oleh orchestrator dapat diisolasi ke proyek: verifikasi cakupannya yang sebenarnya, bukan hanya namanya.

Setelah pilihan diperoleh, lanjutkan tanpa konfirmasi berulang.
Minta keputusan baru hanya jika ada batasan yang memerlukan
perluasan cakupan atau perubahan solusi material.

## 2. Aturan pelaksanaan

Urutan:
inventarisasi → pilihan → cadangan → RTK → Graft/LSP → Ponytail →
instruksi → verifikasi → laporan.

Hormati instruksi repositori dan kebijakan yang diterapkan.
Jika sebuah file dikelola oleh AgentsRoom atau orchestrator lain,
gunakan mekanisme resminya; jangan modifikasi langsung file yang dihasilkan.

Sebelum setiap modifikasi:

- validasi format DAN struktur konfigurasi JSON/JSONC/TOML;
- cadangkan file yang terpengaruh di luar repositori, dengan akses terbatas;
- catat versi dan elemen yang diperlukan untuk rollback;
- tinjau dry-run installer jika ada.

File yang tidak valid tidak boleh diganti dengan konfigurasi kosong.

Gabungkan konfigurasi sambil mempertahankan MCP lain, hook, izin,
instruksi, komentar bila memungkinkan, dan baris status.
Jangan ubah aturan persetujuan atau sidik jari kepercayaan.

Pertahankan perubahan Git yang sudah ada. Tidak ada commit, push, reset,
clean, stash, atau perubahan kode aplikasi.
Jika ada konflik yang belum terselesaikan atau operasi Git yang sedang berlangsung, tunda
penulisan di repositori; lanjutkan diagnostik independen.

Jangan instal Graphify, CodeGraph, Caveman, atau Headroom.
Integrasi lama yang bertentangan hanya dihapus setelah identifikasi tepat,
cadangan, dan dalam cakupan yang diizinkan.
Jangan uninstall alat secara global yang digunakan di tempat lain.

Kesalahan memblokir langkah yang bergantung padanya, bukan klien independen lain.
Jangan nyatakan langkah berhasil untuk melewati batasan.

## 3. Kapabilitas dan cakupan: verifikasi sebelum konfigurasi

Konsultasikan bantuan versi yang terinstal dan dokumen yang sesuai
untuk versi yang akan Anda gunakan:

- https://github.com/rtk-ai/rtk
- https://github.com/trailhq/Graft
- https://github.com/DietrichGebert/ponytail
- dokumentasi resmi setiap klien yang dipilih.

Cabang main/develop mungkin menjelaskan fitur yang tidak ada di rilis.
Untuk opsi yang meragukan, periksa rilis, bantuan, atau kode yang dikirim.

Tetapkan untuk setiap integrasi:

Client | Hook proyek yang tersedia | Installer kompatibel |
Cakupan aktivasi | Cakupan status | Bukti

Jangan bingung:
"klien menerima hook proyek"
dan "installer alat ini tahu cara menginstalnya di tingkat proyek."

Titik pemeriksaan untuk diverifikasi ulang di versi saat ini:

- Claude: pengaturan pengguna, proyek bersama, dan proyek lokal.
- Cursor: hook pengguna dan proyek; uji IDE dan CLI secara terpisah.
- Codex: konfigurasi pengguna/proyek dan aktivasi plugin;
  verifikasi mekanisme hook yang benar-benar tersedia.
- Kimi: jangan mengasumsikan konfigurasi hook per proyek;
  bedakan konfigurasi pengguna, instruksi proyek, dan opsi peluncuran.
- Gemini/Copilot: verifikasi mekanisme mereka sendiri jika dipilih.

Jika penginstal tidak menghormati ruang lingkup yang diminta:

1. Cari opsi resmi yang sesuai.
2. Jika tidak, gunakan konfigurasi manual yang terdokumentasi dari adapter yang sama,
   hanya jika protokol dan jalurnya tetap kompatibel.
3. Jika tidak, gunakan fallback dengan instruksi/prefiks eksplisit.
4. Jangan pernah beralih diam-diam ke global.

Periksa hook global yang diwariskan sebelum menambahkan padanan lokalnya:
mereka mungkin menumpuk alih-alih saling menggantikan.
Pertahankan hook keamanan. Laporkan efek global yang tetap aktif.

## 4. RTK

Periksa asal `rtk-ai/rtk`, versi, bantuan, konfigurasi
dan `rtk gain`. Kegagalan `gain` mungkin berasal dari basis atau izin:
ini bukan bukti yang cukup dari paket yang buruk.

Pasang atau perbarui dengan manajer yang sudah digunakan, jika sesuai.
Periksa asal formula atau paket dan versi yang diperoleh.
Hindari instalasi bersamaan dan perubahan PATH yang tidak perlu.
Jangan jalankan `cargo install rtk` secara membabi buta.

Konsultasikan `rtk init --help` untuk versi yang dipilih.
Pilih opsi berdasarkan klien dan ruang lingkup; jangan selalu menyalin
`-g` dari contoh dokumentasi.

Jangan mengasumsikan integrasi Codex selalu berupa instruksi sederhana,
atau bahwa selalu memiliki hook: ini tergantung pada versi RTK.
Periksa juga ketidakcocokan antara opsi inisialisasi.

Dalam konfigurasi yang benar-benar dibaca, gabungkan pengecualian:

    [hooks]
    exclude_commands = ["graft", "curl", "playwright"]

Pertahankan pengecualian yang ada dan verifikasi pertimbangannya.
Jika pengaturan ini bersifat global, tunjukkan efek ini sebelum mengubahnya.
Nonaktifkan telemetri opsional dengan mekanisme yang terdokumentasi,
dalam ruang lingkup yang diizinkan.

RTK adalah satu-satunya komponen yang diizinkan untuk menulis ulang perintah shell.
Hook keamanan, audit, dan persetujuan tetap berlaku.

Jangan menyalin hook Claude ke klien lain tanpa kompatibilitas yang terdokumentasi.
Tanpa penulisan ulang yang efektif, konfigurasikan prefiks eksplisit `rtk`.
Hindari hook ganda dan prefiks ganda.

## 5. Graft dengan LSP

### Instalasi dan privasi

Verifikasi identitas paket `@nanonets/graft`, versi yang diterbitkan
serta persyaratan Node-nya.

Pasang di luar dependensi aplikasi, di lokasi yang sesuai.
Jangan ubah package.json atau file kunci proyek untuk memasang Graft.

Terapkan `DO_NOT_TRACK=1` sejak peluncuran pertama dan di MCP.
Gunakan perintah resmi untuk menonaktifkan telemetri jika tersedia.

Jangan aktifkan Brain, akun, pengayaan LLM, atau `--deep`.
Jangan menjanjikan tanpa jaringan tanpa memverifikasinya.

Jangan jalankan `graft init` secara otomatis.
Utamakan pengkabelan eksplisit; penginstalnya mungkin menulis di luar repositori.

### LSP yang benar-benar operasional

Sebelum menjelajahi kode aplikasi, hormati aturan Graft dari repositori.
Kemudian identifikasi bahasa yang berguna dan konsultasikan integrasi LSP
versi Graft yang dipilih.

Gunakan kembali server kompatibel yang sudah ada.
Pasang hanya server yang diperlukan, dengan versi yang tercatat,
di luar dependensi aplikasi bila memungkinkan.

Periksa:

- executable dan versinya;
- ketersediaannya di PATH proses Graft/MCP;
- prasyarat bahasa dan ruang kerja;
- dukungannya oleh versi Graft ini.

Setelah membaca bantuan, gunakan terutama, jika opsi ini tersedia:

    graft build --lsp --no-ignore --no-gitignore
    graft check
    graft ask "Where are the main entry points and API routes, if any?" --source

Terapkan DO_NOT_TRACK pada perintah ini dengan sintaks shell saat ini.

Periksa arti opsi: pada beberapa versi,
`--no-ignore` dan `--no-gitignore` mencegah penulisan file pengecualian;
mereka tidak berarti "indeks file yang diabaikan."

Kelola secara eksplisit pengecualian Git dari `/graft/` sesuai ruang lingkup yang dipilih.
Verifikasi dengan Git. Jangan hapus file yang sudah dilacak secara otomatis.
Pertahankan anotasi dan konten manusiawi.

Build dengan `--lsp` dan kode keluar 0 tidak membuktikan penggunaan LSP.
Cari bukti yang ditargetkan: server benar-benar diluncurkan, hasil resolusi,
tepi yang diperkaya atau diagnostik yang terdokumentasi.

Laporkan berdasarkan bahasa:
LSP diverifikasi / tersedia tanpa pengayaan yang diamati / tidak tersedia / tidak didukung.

Jangan pernah memuat seluruh grafik atau wiring.json dalam konteks.
Periksa juga apakah pengayaan LSP bertahan setelah penyegaran otomatis;
jika tidak dijamin, dokumentasikan rekonstruksi eksplisit yang diperlukan.

### MCP dan kesegaran

Konfigurasikan satu entri Graft efektif per klien.
Temukan file, skema, dan ruang lingkup yang benar-benar didukung.

Untuk setiap server, verifikasi:
perintah yang terpasang, argumen MCP, DO_NOT_TRACK, PATH, dan direktori kerja.

Jangan mengasumsikan bahwa `.kimi-code/mcp.json`, `.mcp.json` atau file lain dimuat otomatis: konfirmasi mekanisme klien atau opsi peluncuran yang diperlukan.

Konfigurasi MCP global dapat diterima hanya jika proses target menangani setiap repositori dengan benar. Jika tidak, pertahankan MCP di tingkat proyek.

Jangan gunakan `npx -y ...@latest` setiap kali startup.
Jangan kontrol versi jalur pribadi absolut atau rahasia.
Jangan buat variabel universal `${workspaceFolder}`.

Dalam profil ini, jangan tambahkan hook Graft apapun.
Tidak ada smart-grep, grep-redirect, atau intersepsi shell Graft.

Periksa penyegaran dan ketiadaan penonaktifan yang tidak disengaja.
Penyegaran yang gagal melarang penyajian grafik sebagai segar.

Periksa integrasi lama dan metadata auto-wiring sebelum migrasi.
Hanya hapus elemen yang teridentifikasi dan sudah dibackup.
Verifikasi bahwa mereka tidak muncul kembali setelah startup dan query MCP.

### Statistik Graft

Pisahkan operasi, penggunaan yang diamati, dan pengumpulan statistik.

Tergantung pada versinya, `graft stats` bergantung pada session hooks.
Tanpa hooks ini, "no session recorded yet" mungkin muncul meskipun permintaan Graft berhasil.

Jangan membuat statistik palsu atau menjalankan `graft init` untuk menghilangkan pesan ini.

Jika pengguna memerlukan statistik asli, tunjukkan kompatibilitas hooks pengukuran yang tersedia dan secara eksplisit minta evolusi profil tanpa hooks sebelum aktivasi apapun.

## 6. Ponytail lite

Utamakan integrasi resmi yang kompatibel dengan klien dan ruang lingkup.
Periksa manifest, event, dan dependensinya.

Bedakan:
instalasi plugin, aktivasi, mode default, dan status mode saat ini.

Periksa sumber yang benar-benar dibaca:
konfigurasi, `PONYTAIL_DEFAULT_MODE`, status persisten, dan data plugin.
`defaultMode: lite` tidak membuktikan bahwa status penuh lama telah diganti.

Jika mode dibagi antar percakapan, tunjukkan hal itu.
Dalam ruang lingkup proyek, jangan ubah default global secara diam-diam.
Gunakan mekanisme lokal yang terdokumentasi atau kebijakan lite melalui instruksi.

Berdasarkan klien:

- Claude/Codex: instalasi dan aktivasi resmi pada ruang lingkup yang tersedia.
  Periksa subperintah sebelum menggunakannya.
  Persetujuan hook tetap di tangan pengguna.
- Cursor: adapter resmi, atau aturan instruksi; hindari penumpukan mereka.
  Jika `scripts/cursor-hooks.js install --project` ada, jalankan skrip
  dari root repositori target menggunakan jalur checkout resmi.
  Tanpa `--project`, periksa tujuan pengguna.
  Periksa jalur yang dihasilkan: hook proyek yang berisi jalur absolut
  ke checkout pribadi tidak portabel dan tidak boleh dikomit.
- Kimi: cari adapter resmi yang kompatibel. Jika tidak ada, kebijakan lite
  di AGENTS.md; tambahkan skill lokal minimal hanya jika berguna
  dan jika format serta pemuatannya dikonfirmasi.
  Identifikasi sebagai adaptasi, tanpa menjanjikan perintah atau statistik asli.
- Klien terpilih lain: terapkan verifikasi yang sama, tanpa secara otomatis mentransposisi
  event Claude/Codex.

Pertahankan checkout adapter pada versi atau commit yang teridentifikasi.
Jangan git pull pada checkout yang telah dimodifikasi.
Jangan tambahkan statusline atau indikator visual.

Uji mode efektif dalam sesi baru.

## 7. Instruksi umum ringkas

Gabungkan blok yang dibatasi oleh:

    <!-- agent-stack:start -->
    ...
    <!-- agent-stack:end -->

di AGENTS.md. Pertahankan semua konten eksternal dan tambahan manusia.
Jangan salin prompt instalasi ini ke dalam instruksi agen.

Blok harus menyatakan:

### Graft

Untuk memahami atau memodifikasi kode, eksplorasi aplikasi terlebih dahulu:
`graft ask "<pertanyaan tepat>" --source`, atau alat MCP Graft yang benar-benar terekspos.

Instruksi, skill, Git, konfigurasi, dan penemuan MCP dapat mendahului.
Setelah orientasi, baca langsung bagian yang berguna.
Untuk pemanggil, gunakan perintah/alat jejak yang tersedia.

Jika grafik usang: periksa, rekonstruksi yang disesuaikan dengan LSP, lalu kueri baru.
Setelah pencarian gagal: graft grep terarah, lalu baca langsung
atau rg terbatas dengan penjelasan batasannya.

File yang disediakan, stack trace, konfigurasi, atau bahasa yang tidak terindeks
memungkinkan pembacaan terarah langsung.
Ketidakhadiran dalam grafik tidak membuktikan tidak adanya kode atau pemanggil.

Setelah modifikasi: graft blast, basis Git terverifikasi, dan tes relevan.
Tanpa --name, tanpa pemuatan grafik penuh.
Laporkan jumlah panggilan aktual dan kesalahan apapun.

### RTK

Hook terverifikasi: biarkan penulisan ulang bertindak tanpa prefix ganda.
Jika tidak: beri prefix eksplisit pada perintah yang kompatibel.
Jangan pernah lewatkan Graft melalui RTK.

Untuk output penuh: panggil ulang --full jika tersedia, atau proxy.
Jangan otomatis menjalankan ulang perintah dengan efek samping.
Pertahankan pipeline dan pengalihan.

Sebelum validasi: diff asli tidak terkompresi, diff --cached,
diff --check dan inspeksi terpisah file baru.
Tidak ada staging otomatis.

### Ponytail lite

Implementasikan permintaan dengan benar dan gunakan kembali yang sudah ada.
Laporkan secara singkat solusi yang jauh lebih sederhana.
Pertahankan validasi, keamanan, izin, aksesibilitas, transaksi
dan tes yang diperlukan. Verifikasi penggunaan sebelum penghapusan atau penggabungan.

Full hanya atas permintaan eksplisit, jangan pernah ultra secara default.
Audit tidak memicu desain ulang.
Koreksi diutamakan untuk keamanan, parser, konkurensi, dan migrasi.

Jangan klaim bahwa mode bersama adalah lokal untuk percakapan.
Setelah full yang diizinkan, verifikasi kembali ke lite.
Off tidak menghapus instruksi yang sudah disuntikkan.

### Loading

Konfirmasi bagaimana setiap klien benar-benar memuat instruksi ini.
Gunakan impor/adapter minimal yang terdokumentasi.
Hindari duplikasi dan impor melingkar.

RTK tetap satu-satunya penulis ulang shell.
Tidak ada hook Graft dalam profil ini.

## 8. Pembaruan dan Perbaikan

Prompt yang sama harus dapat dijalankan ulang tanpa duplikat.

Dalam mode pembaruan:

1. Baca ulang pilihan ruang lingkup dan status yang sebelumnya diverifikasi.
2. Bandingkan versi terpasang, versi target, dan perubahan yang tidak kompatibel.
3. Cadangkan sebelum migrasi apapun.
4. Perbarui hanya komponen yang dipilih.
5. Segarkan plugin/adapter dengan mekanisme resmi mereka.
6. Evaluasi ulang kemampuan: fallback lama dapat diganti
   dengan integrasi asli yang kini tersedia, dalam ruang lingkup yang sama.
7. Migrasi hanya kunci dan blok yang milik stack ini.
8. Bangun ulang grafik jika perlu dan periksa ulang LSP.
9. Mulai ulang proses MCP/klien yang diperlukan:
   proses yang ada mungkin masih menjalankan versi lama.
10. Putar ulang pemeriksaan dan tes integrasi yang dimodifikasi.

Jangan instal ulang komponen yang sudah sesuai tanpa perlu.
Jangan jalankan pembaruan umum paket mesin.

Dalam mode perbaikan, pertahankan versi kecuali ada ketidakcocokan yang terbukti
dan keputusan pembaruan eksplisit.

Siapkan rollback terarah: versi sebelumnya, cadangan,
dan perintah tepat. Jangan sembarangan mengembalikan seluruh file
jika perubahan lain telah terjadi sejak cadangannya.

Eksekusi kedua tanpa perubahan yang diminta tidak boleh membuat
hook, server MCP, atau bagian instruksi duplikat apapun.

## 9. Pemeriksaan dan Bukti

Uji secara terpisah:

- Eksekusi RTK dan kompresi eksplisit;
- pemicu hook otomatis, pengecualian, dan pass-through mentah;
- Graft: kesegaran, hasil yang sesuai dengan repositori, dan pengayaan LSP;
- MCP: server fungsional DAN pemuatan aktual di setiap klien;
- Ponytail: aktivasi dan mode efektif;
- tidak ada duplikat dan wiring sendiri yang muncul kembali;
- validitas akhir konfigurasi dan cakupan efektif.

File yang ada bukan bukti pemuatan.
Probe MCP eksternal bukan bukti pemuatan di klien.
Prefix RTK eksplisit bukan bukti hook otomatis.

Untuk setiap klien yang tersedia dan terautentikasi, buka sesi baru
di repositori, dengan proteksi biasanya, dan berikan tiket netral ini:

"Tanpa memodifikasi kode, temukan titik masuk utama.
Jika ada API, tunjukkan di mana rutenya dipasang dan jejak
jalur ke logika bisnis. Sebutkan file dan baris."

Jangan tambahkan "gunakan Graft".
Periksa panggilan alat yang terlihat, bukan penalaran internal.
Simpan bukti minimal dan sunting data sensitif.

Jika persetujuan, login, atau aksi UI hilang:
TIDAK DITES / AKSI PENGGUNA, jangan pernah anggap berhasil.

## 10. Deliverable

Dalam cakupan yang diizinkan, simpan dokumentasi pemeliharaan singkat:

- pilihan operasi, klien, dan cakupan;
- versi tepat, asal, dan tanggal verifikasi;
- mekanisme konfigurasi dan batasan;
- rekonstruksi Graft/LSP;
- prosedur pembaruan, verifikasi, dan rollback.

Untuk instalasi bersama, gunakan `docs/agent-stack.md`.
Untuk instalasi pribadi/global, simpan informasi spesifik mesin
keluar dari file yang di-versi.
Dalam mode hanya verifikasi, serahkan laporan tanpa membuat file ini.

Laporkan perintah menentukan, hasilnya, file yang diubah,
backup, dan aksi pengguna tepat.

Inventarisasi hook akhir:
klien, asal, cakupan, event, matcher, peran, dan perintah yang disunting.

Akhiri dengan:

Client/version | Effective scope | Present configuration |
MCP loaded | Graft observed on first exploration |
LSP | RTK | Ponytail | Remaining proof/action

Gunakan status eksplisit:
CONFIGURED / LOADED / USAGE OBSERVED / NOT TESTED / BLOCKED / NOT APPLICABLE.

Klasifikasikan file:
TO COMMIT AFTER REVIEW / TO IGNORE / MACHINE CONFIGURATION.

Jalur pribadi, rahasia, cache, grafik, backup, dan transkrip
harus tidak disertakan dalam file yang akan di-commit.

Tampilkan status Git akhir dan perubahan yang diperkenalkan oleh intervensi ini,
membedakannya dari perubahan yang sudah ada sebelumnya. Jangan commit apa pun.

Tag