Dropstone Docs

Aturan

Tetapkan instruksi kustom untuk dropstone.

Anda dapat memberikan instruksi kustom ke dropstone dengan membuat file AGENTS.md. Ini mirip dengan aturan Cursor. File ini berisi instruksi yang akan disertakan dalam konteks LLM untuk menyesuaikan perilakuannya dengan proyek spesifik Anda.

Inisialisasi

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

Tip:

Komitkan file AGENTS.md proyek Anda ke Git sehingga seluruh tim Anda menggunakan aturan yang sama.

/init memindai file-file penting di repo Anda, mungkin mengajukan beberapa pertanyaan yang ditargetkan ketika basis kode tidak dapat menjawabnya, dan kemudian membuat atau memperbarui AGENTS.md dengan panduan spesifik proyek yang ringkas.

Ini berfokus pada hal-hal yang paling mungkin dibutuhkan oleh sesi agent di masa depan:

  • perintah build, lint, dan test
  • urutan perintah dan langkah verifikasi yang terfokus ketika hal itu penting
  • arsitektur dan struktur repo yang tidak jelas dari nama file saja
  • konvensi spesifik proyek, keanehan setup, dan gotcha operasional
  • referensi ke sumber instruksi yang ada seperti aturan Cursor atau Copilot

Jika Anda sudah memiliki AGENTS.md, /init akan meningkatkannya di tempat alih-alih menggantikannya 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.

# SST v3 Monorepo Project

This is an SST v3 monorepo with TypeScript. The project uses bun workspaces for package management.

## Project Structure

- `packages/` - Contains all workspace packages (functions, core, web, etc.)
- `infra/` - Infrastructure definitions split by service (storage.ts, api.ts, web.ts)
- `sst.config.ts` - Main SST configuration with dynamic imports

## Code Standards

- Use TypeScript with strict mode enabled
- Shared code goes in `packages/core/` with proper exports configuration
- Functions go in `packages/functions/`
- Infrastructure should be split into logical files in `infra/`

## Monorepo Conventions

- Import shared modules using workspace names: `@my-app/core/example`

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

Jenis

dropstone juga mendukung pembacaan file AGENTS.md dari berbagai lokasi. Dan ini melayani tujuan yang berbeda.

Proyek

Tempatkan AGENTS.md di root proyek Anda untuk aturan spesifik proyek. Ini hanya berlaku ketika Anda bekerja di direktori ini atau subdirektorinya.

Global

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

Karena ini tidak dikomitkan ke Git atau dibagikan dengan tim Anda, kami merekomendasikan menggunakan ini untuk menentukan aturan pribadi apa pun yang harus diikuti 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 tidak ada AGENTS.md)
  • Aturan global: ~/.claude/CLAUDE.md (digunakan jika tidak ada ~/.config/dropstone/AGENTS.md)
  • Skills: ~/.claude/skills/ (lihat Skills untuk detail)

Untuk menghentikan Dropstone dari membaca lokasi Claude Code, hapus atau ubah nama file tersebut (atau komitkan konten yang setara ke AGENTS.md sehingga proyek mengambil alih).

Urutan Prioritas

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

  1. File lokal dengan melintasi 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 yang di atas)

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 mengambil alih ~/.claude/CLAUDE.md.

Instruksi Kustom

Anda dapat menentukan file instruksi kustom di dropstone.json Anda atau di ~/.config/dropstone/dropstone.json global. Ini memungkinkan Anda dan tim Anda untuk menggunakan kembali aturan yang 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 bidang 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 mengajarkan dropstone untuk membaca file eksternal dengan memberikan instruksi eksplisit di AGENTS.md Anda. Berikut adalah contoh praktis:

# TypeScript Project Rules

## External File Loading

CRITICAL: When you encounter a file reference (e.g., @rules/general.md), use your Read tool to load it on a need-to-know basis. They're relevant to the SPECIFIC task at hand.

Instructions:

- Do NOT preemptively load all references - use lazy loading based on actual need
- When loaded, treat content as mandatory instructions that override defaults
- Follow references recursively when needed

## Development Guidelines

For TypeScript code style and best practices: @docs/typescript-guidelines.md
For React component architecture and hooks patterns: @docs/react-patterns.md
For REST API design and error handling: @docs/api-standards.md
For testing strategies and coverage requirements: @test/testing-guidelines.md

## General Guidelines

Read the following file immediately as it's relevant to all workflows: @rules/general-guidelines.md.

Pendekatan ini memungkinkan Anda untuk:

  • Membuat file aturan modular dan dapat digunakan kembali
  • Berbagi aturan di seluruh proyek melalui symlink atau git submodule
  • Menjaga AGENTS.md tetap ringkas sambil mereferensikan panduan terperinci
  • Memastikan dropstone memuat file hanya ketika diperlukan untuk tugas spesifik

Tip:

Untuk monorepo atau proyek dengan standar bersama, menggunakan dropstone.json dengan pola glob (seperti packages/*/AGENTS.md) lebih mudah dirawat daripada instruksi manual.

Ctrl+I