Konsep inti

Dropstone adalah alat coding agentik yang berjalan di terminal Anda. Ia dapat membaca kode, menjalankan perintah, merencanakan perubahan, mengedit file, dan memverifikasi hasilnya. Halaman ini mencakup ide-ide inti yang hanya perlu Anda pelajari sekali: loop tempat agen berjalan, apa yang dapat diaksesnya, cara kerja sesi, bagaimana konteks dikelola, dan bagaimana izin menjaga Anda tetap memegang kendali.

Loop agentik

Saat Anda memberi Dropstone sebuah tugas, ia bekerja melalui tiga fase: kumpulkan konteks, ambil tindakan, dan verifikasi hasil. Fase-fase ini saling menyatu. Dropstone menggunakan tools di seluruh proses, baik membaca file untuk memahami kode Anda, mengedit untuk membuat perubahan, atau menjalankan tes untuk memeriksa pekerjaannya.

Loop ini beradaptasi dengan apa yang Anda minta. Pertanyaan tentang codebase Anda mungkin hanya memerlukan pengumpulan konteks. Perbaikan bug melalui ketiga fase. Refactor besar mungkin melibatkan verifikasi yang berat. Dropstone memutuskan apa yang dibutuhkan setiap langkah berdasarkan apa yang dipelajarinya dari langkah sebelumnya, merangkai puluhan tindakan dan mengoreksi arah di sepanjang jalan.

Anda juga bagian dari loop ini. Anda dapat menginterupsi kapan saja untuk mengarahkan ulang, menambahkan konteks, atau meminta pendekatan yang berbeda. Dropstone bekerja secara otonom tetapi tetap responsif terhadap masukan Anda.

Loop agentik didukung oleh dua komponen: model yang bernalar, dan tools yang bertindak.

Model

Dropstone menggunakan model coding yang dirancang khusus. Ada tiga tingkatan, masing-masing disesuaikan untuk jenis pekerjaan yang berbeda:

Ganti tingkat dengan /effort low, /effort medium, /effort high, atau /effort xhigh selama sesi, atau Ctrl+T untuk berpindah di antaranya. Saat panduan ini mengatakan "Dropstone memutuskan" atau "Dropstone memilih," itulah model yang melakukan penalaran.

Tools

Tools adalah yang membuat Dropstone agentik. Tanpa tools, model hanya dapat menghasilkan teks. Dengan tools, ia dapat bertindak: membaca kode Anda, mengedit file, menjalankan perintah, mencari di web, dan berinteraksi dengan layanan eksternal. Setiap hasil tool dimasukkan kembali ke dalam loop, menginformasikan keputusan berikutnya.

Tools bawaan terbagi dalam lima kategori:

Dropstone memilih tools mana yang akan digunakan berdasarkan prompt Anda dan apa yang dipelajarinya di sepanjang jalan. Saat Anda mengatakan "perbaiki tes yang gagal," ia mungkin:

1. Menjalankan suite tes untuk melihat apa yang gagal
2. Membaca output error
3. Mencari file sumber yang relevan
4. Membaca file-file tersebut untuk memahami kode
5. Mengeditnya untuk memperbaiki masalah
6. Menjalankan tes lagi untuk memverifikasi

Setiap penggunaan tool mengembalikan informasi yang menginformasikan langkah berikutnya. Itulah loop agentik dalam praktik.

Tools bawaan adalah fondasinya. Anda dapat memperluas apa yang diketahui Dropstone dengan skills, terhubung ke layanan eksternal dengan server MCP, dan mendelegasikan pekerjaan ke subagen. Untuk daftar lengkap tools bawaan, lihat Tools Bawaan.

Apa yang dapat diakses Dropstone

Saat Anda menjalankan dropstone di sebuah direktori, agen mendapatkan akses ke:

• Proyek Anda. File di direktori kerja dan subdirektori Anda, plus file lain dengan izin Anda.
• Terminal Anda. Perintah apa pun yang bisa Anda jalankan sendiri: build tools, git, package manager, utilitas sistem, skrip. Jika Anda bisa melakukannya dari baris perintah, Dropstone juga bisa.
• Status git Anda. Cabang saat ini, perubahan yang belum di-commit, file yang di-stage, dan riwayat commit terbaru.
• AGENTS.md Anda. File markdown di root repo tempat Anda menulis konvensi khusus proyek, perintah build, gotcha, dan apa pun yang harus diketahui Dropstone setiap sesi.
• Ekstensi yang Anda konfigurasi. Server MCP untuk layanan eksternal, skills untuk alur kerja, dan subagen untuk pekerjaan yang didelegasikan.

Karena Dropstone melihat seluruh proyek Anda, ia dapat bekerja di seluruh proyek. Saat Anda memintanya untuk "perbaiki bug autentikasi," ia mencari file yang relevan, membaca beberapa untuk memahami konteks, membuat edit yang terkoordinasi di seluruh file, menjalankan tes untuk memverifikasi, dan melakukan commit jika Anda minta. Ini berbeda dari asisten kode inline yang hanya melihat file saat ini.

Sesi

Setiap sesi interaktif disimpan secara lokal. Setiap pesan, penggunaan tool, dan hasil ditulis ke catatan sesi, yang memungkinkan untuk membatalkan, melanjutkan, dan mem-fork pekerjaan sebelumnya.

Sesi bersifat independen. Sesi baru dimulai dengan jendela konteks yang segar, tanpa memori percakapan sebelumnya. Pengetahuan persisten berada di AGENTS.md, bukan di riwayat percakapan.

Lanjutkan atau fork sesi

Melanjutkan dengan dropstone --continue (atau dropstone -c) membuka kembali sesi terbaru di direktori saat ini dan menambahkan pesan baru ke dalamnya. Melanjutkan sesi tertentu berdasarkan id menggunakan dropstone --session <id>.

# Lanjutkan sesi terakhir di direktori ini
dropstone -c

# Lanjutkan sesi tertentu
dropstone --session 7f3a82b1

# Fork sesi yang ada menjadi percakapan baru
dropstone --session 7f3a82b1 --fork

Fork menyalin riwayat ke id sesi baru, meninggalkan yang asli tidak tersentuh. Berguna saat Anda ingin mengeksplorasi arah alternatif tanpa kehilangan alur asli.

Jendela konteks

Jendela konteks menampung riwayat percakapan Anda, konten file, output perintah, AGENTS.md, skills yang dimuat, dan instruksi sistem. Saat Anda bekerja, jendela terisi. Dropstone memadatkan konten lama secara otomatis, tetapi instruksi dari awal percakapan bisa hilang.

Beberapa aturan praktis:

• Letakkan aturan persisten di AGENTS.md, bukan di pesan chat. Versi pesan chat akan dipadatkan; versi AGENTS.md dimuat ulang setiap sesi.
• Skills dimuat sesuai permintaan. Dropstone melihat deskripsi skill di awal sesi tetapi hanya memuat konten penuh saat skill dipanggil.
• Subagen mendapatkan konteks segar mereka sendiri. Pekerjaan mereka tidak membebani percakapan utama; saat selesai, mereka mengembalikan ringkasan.

Keamanan: checkpoint dan izin

Dropstone memiliki dua mekanisme keamanan. Checkpoint memungkinkan Anda membatalkan perubahan yang dibuat agen. Izin mengontrol apa yang dapat dilakukan agen tanpa bertanya.

Batalkan dengan checkpoint

Setiap edit file dapat dibalik. Sebelum Dropstone mengedit file, ia mengambil snapshot konten saat ini. Jika ada yang salah, gunakan /undo untuk mundur satu siklus edit pada satu waktu, atau /redo untuk memutar ulang langkah yang dibatalkan.

/undo            # kembalikan siklus edit terakhir
/redo            # putar ulang langkah yang baru saja dibatalkan

Checkpoint bersifat lokal untuk sesi Anda, terpisah dari git. Mereka hanya mencakup perubahan file. Tindakan yang menyentuh sistem remote (database, layanan yang di-deploy, API jaringan) tidak dapat di-checkpoint, itulah sebabnya Dropstone bertanya sebelum menjalankan perintah dengan efek samping eksternal.

Kontrol apa yang dapat dilakukan Dropstone

Dropstone meminta persetujuan pertama kali ia ingin melakukan tindakan sensitif: mengedit file, menjalankan perintah shell, memanggil jaringan. Setujui sekali, dan operasi yang sama berjalan tanpa meminta lagi selama sisa sesi.

Gunakan Tab untuk beralih antara dua mode operasi selama sesi:

• Mode Build. Default. Dropstone dapat mengedit file dan menjalankan perintah (tergantung persetujuan). Gunakan ini saat Anda ingin mengirimkan perubahan.
• Mode Plan. Hanya-baca. Dropstone dapat menyelidiki codebase, mengumpulkan konteks, dan menghasilkan rencana, tetapi tidak dapat mengedit atau mengeksekusi apa pun. Gunakan ini saat Anda ingin mempelajari sistem sebelum mengubahnya.

Untuk menyetujui perintah sebelumnya dan melewati prompt sepenuhnya, daftarkan mereka di konfigurasi izin proyek Anda. Misalnya:

{
  "permissions": {
    "allow": ["git status", "git diff", "npm test", "npm run lint"]
  }
}

Untuk kebijakan tingkat organisasi, pola yang lebih terperinci, dan cara kerja resolusi cakupan, lihat Panduan Izin.

Bekerja secara efektif dengan Dropstone

Beberapa pola yang cenderung menghasilkan hasil yang lebih baik.

Ini adalah percakapan

Anda tidak perlu prompt pertama yang sempurna. Mulailah dengan apa yang Anda inginkan, lihat apa yang dilakukan agen, lalu koreksi:

perbaiki bug login

tidak, masalahnya ada di penanganan sesi, bukan validasi formulir

Anda tidak memulai dari awal. Anda beriterasi. Setiap giliran menyempurnakan pemahaman agen.

Interupsi dan arahkan

Anda dapat mengarahkan ulang Dropstone kapan saja:

• Tekan Esc untuk berhenti segera. Panggilan tool saat ini dibatalkan dan Dropstone menunggu instruksi berikutnya.
• Ketik koreksi dan tekan Enter tanpa menunggu. Dropstone membacanya segera setelah tindakan saat ini selesai dan menyesuaikan sebelum memutuskan langkah berikutnya.

Bersikap spesifik di awal

Semakin presisi prompt awal Anda, semakin sedikit koreksi yang Anda perlukan. Referensikan file, sebutkan batasan, tunjukkan pola contoh:

alur checkout rusak untuk pengguna dengan kartu kedaluwarsa.
lihat di src/payments/ untuk masalahnya, terutama token refresh.
tulis tes yang gagal terlebih dahulu, lalu perbaiki.

Prompt yang samar berfungsi, tetapi Anda akan menghabiskan lebih banyak waktu untuk mengarahkan. Prompt spesifik seperti di atas sering berhasil pada percobaan pertama.

Beri Dropstone sesuatu untuk diverifikasi

Agen bekerja lebih baik ketika ia dapat memeriksa pekerjaannya sendiri. Sertakan kasus tes, output yang diharapkan, atau kriteria penerimaan:

implementasikan validateEmail. kasus tes:
  'user@example.com' -> true
  'invalid'           -> false
  'user@.com'         -> false
jalankan tes setelahnya.

Jelajahi sebelum mengimplementasikan

Untuk masalah yang kompleks, pisahkan riset dari coding. Beralih ke mode plan (Tab), minta Dropstone mempelajari kode yang relevan, sempurnakan rencana melalui percakapan, lalu kembali ke mode build untuk mengeksekusi:

baca src/auth/ dan jelaskan bagaimana kita menangani sesi saat ini.
lalu usulkan rencana untuk menambahkan dukungan OAuth.

Tinjau rencana, tolak apa pun yang tidak Anda setujui, lalu biarkan Dropstone mengimplementasikan. Pendekatan dua fase ini menghasilkan hasil yang lebih konsisten daripada langsung ke kode.

Delegasikan, jangan perintah

Perlakukan Dropstone seperti kolega yang cakap. Beri konteks dan arah, lalu percayai agen untuk mencari tahu detailnya:

alur checkout rusak untuk pengguna dengan kartu kedaluwarsa.
kode yang relevan ada di src/payments/.
selidiki dan perbaiki.

Anda tidak perlu menentukan file mana yang harus dibaca, perintah mana yang harus dijalankan, atau urutan apa yang harus dilakukan. Dropstone mencarinya dari prompt.

Apa selanjutnya