Aturan

Anda dapat memberikan instruksi kustom kepada dropstone dengan membuat file AGENTS.md. Ini mirip dengan rules di Cursor. File ini berisi instruksi yang akan disertakan dalam konteks LLM untuk menyesuaikan perilakunya dengan kebutuhan spesifik proyek Anda.

Inisialisasi

Untuk membuat file AGENTS.md baru, Anda dapat menjalankan perintah /init di dropstone.

/init memindai file-file penting di repositori Anda, mungkin mengajukan beberapa pertanyaan yang ditargetkan ketika codebase tidak dapat menjawabnya, lalu membuat atau memperbarui AGENTS.md dengan panduan spesifik proyek yang ringkas.

Fokusnya adalah pada hal-hal yang paling mungkin dibutuhkan oleh sesi agen di masa mendatang:

• perintah build, lint, dan test
• urutan perintah dan langkah verifikasi yang terfokus ketika hal tersebut penting
• arsitektur dan struktur repositori yang tidak terlihat jelas hanya dari nama file
• konvensi spesifik proyek, keunikan pengaturan, dan jebakan operasional
• referensi ke sumber instruksi yang sudah ada seperti rules Cursor atau Copilot

Jika Anda sudah memiliki AGENTS.md, /init akan memperbaikinya di tempatnya alih-alih menggantinya secara membabi buta.

Contoh

Anda juga dapat membuat file ini secara manual. Berikut adalah contoh beberapa hal yang dapat Anda masukkan ke dalam file AGENTS.md.

# Proyek Monorepo SST v3

Ini adalah monorepo SST v3 dengan TypeScript. Proyek ini menggunakan bun workspaces untuk manajemen paket.

## Struktur Proyek

- `packages/` - Berisi semua workspace packages (functions, core, web, dll.)
- `infra/` - Definisi infrastruktur yang dipisahkan per layanan (storage.ts, api.ts, web.ts)
- `sst.config.ts` - Konfigurasi utama SST dengan dynamic imports

## Standar Kode

- Gunakan TypeScript dengan mode strict yang diaktifkan
- Kode bersama ditempatkan di `packages/core/` dengan konfigurasi exports yang tepat
- Functions ditempatkan di `packages/functions/`
- Infrastruktur harus dipisahkan ke dalam file logis di `infra/`

## Konvensi Monorepo

- Impor modul bersama menggunakan nama workspace: `@my-app/core/example`

Kami menambahkan instruksi spesifik proyek di sini dan ini akan dibagikan ke seluruh tim Anda.

Jenis

dropstone juga mendukung pembacaan file AGENTS.md dari beberapa lokasi. Dan ini memiliki tujuan yang berbeda.

Proyek

Tempatkan AGENTS.md di root proyek Anda untuk aturan spesifik proyek. Aturan ini hanya berlaku ketika Anda bekerja di direktori ini atau sub-direktorinya.

Global

Anda juga dapat memiliki aturan global di file ~/.config/dropstone/AGENTS.md. Ini diterapkan di semua sesi dropstone.

Karena file ini tidak di-commit ke Git atau dibagikan dengan tim Anda, kami merekomendasikan untuk menggunakannya guna menentukan aturan pribadi apa pun yang harus diikuti oleh LLM.

Kompatibilitas Claude Code

Untuk pengguna yang bermigrasi dari Claude Code, Dropstone membaca konvensi file Claude Code sebagai fallback:

• Aturan proyek: CLAUDE.md di direktori proyek Anda (digunakan jika AGENTS.md tidak ada)
• Aturan global: ~/.claude/CLAUDE.md (digunakan jika ~/.config/dropstone/AGENTS.md tidak ada)
• Skills: ~/.claude/skills/ (lihat Skills untuk detail)

Untuk menghentikan Dropstone membaca lokasi Claude Code, hapus atau ganti nama file-file tersebut (atau commit konten yang setara ke dalam AGENTS.md sehingga proyek memiliki prioritas).

Prioritas

Ketika Dropstone dimulai, ia mencari file aturan dalam urutan berikut:

1. File lokal dengan menelusuri naik dari direktori saat ini (AGENTS.md, CLAUDE.md)
2. File global di ~/.config/dropstone/AGENTS.md
3. File Claude Code di ~/.claude/CLAUDE.md (jika tidak ada file di atas yang ada)

File pertama yang cocok menang di setiap kategori. Misalnya, jika Anda memiliki AGENTS.md dan CLAUDE.md, hanya AGENTS.md yang digunakan. Demikian pula, ~/.config/dropstone/AGENTS.md memiliki prioritas di atas ~/.claude/CLAUDE.md.

Instruksi Kustom

Anda dapat menentukan file instruksi kustom di dropstone.json atau ~/.config/dropstone/dropstone.json global. Ini memungkinkan Anda dan tim untuk menggunakan kembali aturan yang sudah ada daripada harus menduplikasinya ke AGENTS.md.

Contoh:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["CONTRIBUTING.md", "docs/guidelines.md", ".cursor/rules/*.md"]
}

Anda juga dapat menggunakan URL jarak jauh untuk memuat instruksi dari web.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["https://raw.githubusercontent.com/my-org/shared-rules/main/style.md"]
}

Instruksi jarak jauh diambil dengan batas waktu 5 detik.

Semua file instruksi digabungkan dengan file AGENTS.md Anda.

Mereferensikan File Eksternal

Meskipun dropstone tidak secara otomatis mengurai referensi file di AGENTS.md, Anda dapat mencapai fungsionalitas serupa dengan dua cara:

Menggunakan dropstone.json

Pendekatan yang direkomendasikan adalah menggunakan field instructions di dropstone.json:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["docs/development-standards.md", "test/testing-guidelines.md", "packages/*/AGENTS.md"]
}

Instruksi Manual di AGENTS.md

Anda dapat mengajari dropstone untuk membaca file eksternal dengan memberikan instruksi eksplisit di AGENTS.md. Berikut adalah contoh praktisnya:

# Aturan Proyek TypeScript

## Pemuatan File Eksternal

PENTING: Ketika Anda menemukan referensi file (misalnya, @rules/general.md), gunakan alat Read Anda untuk memuatnya berdasarkan kebutuhan. Referensi tersebut relevan dengan TUGAS SPESIFIK yang sedang dikerjakan.

Instruksi:

- JANGAN memuat semua referensi secara preventif - gunakan lazy loading berdasarkan kebutuhan aktual
- Ketika dimuat, perlakukan konten sebagai instruksi wajib yang menggantikan default
- Ikuti referensi secara rekursif jika diperlukan

## Pedoman Pengembangan

Untuk gaya kode TypeScript dan praktik terbaik: @docs/typescript-guidelines.md
Untuk arsitektur komponen React dan pola hooks: @docs/react-patterns.md
Untuk desain REST API dan penanganan error: @docs/api-standards.md
Untuk strategi pengujian dan persyaratan cakupan: @test/testing-guidelines.md

## Pedoman Umum

Baca file berikut segera karena relevan dengan semua alur kerja: @rules/general-guidelines.md.

Pendekatan ini memungkinkan Anda untuk:

• Membuat file aturan yang modular dan dapat digunakan kembali
• Berbagi aturan antar proyek melalui symlink atau git submodules
• Menjaga AGENTS.md tetap ringkas sambil mereferensikan pedoman yang detail
• Memastikan dropstone memuat file hanya ketika diperlukan untuk tugas spesifik