ルール

AGENTS.md ファイルを作成することで、dropstone にカスタム指示を提供できます。これは Cursor のルールに似ています。LLM のコンテキストに含まれる指示が含まれており、特定のプロジェクトに合わせて動作をカスタマイズできます。

初期化

新しい AGENTS.md ファイルを作成するには、dropstone で /init コマンドを実行します。

/init はリポジトリ内の重要なファイルをスキャンし、コードベースが答えられない場合は対象を絞った質問をいくつか行い、その後 AGENTS.md を作成または更新して、簡潔なプロジェクト固有のガイダンスを提供します。

将来のエージェント セッションが最も必要とする可能性が高いものに焦点を当てています：

• ビルド、lint、テストコマンド
• コマンドの順序と、重要な場合に焦点を当てた検証ステップ
• ファイル名だけからは明らかでないアーキテクチャとリポジトリ構造
• プロジェクト固有の規約、セットアップの癖、運用上の落とし穴
• Cursor や Copilot ルールなどの既存の指示ソースへの参照

既に AGENTS.md がある場合、/init は盲目的に置き換えるのではなく、その場で改善します。

例

このファイルを手動で作成することもできます。AGENTS.md ファイルに入れることができるものの例を以下に示します。

# SST v3 モノレポ プロジェクト

これは TypeScript を使用した SST v3 モノレポです。プロジェクトはパッケージ管理に bun ワークスペースを使用しています。

## プロジェクト構造

- `packages/` - すべてのワークスペース パッケージが含まれています（functions、core、web など）
- `infra/` - サービス別に分割されたインフラストラクチャ定義（storage.ts、api.ts、web.ts）
- `sst.config.ts` - 動的インポート付きのメイン SST 設定

## コード標準

- strict モードが有効な TypeScript を使用します
- 共有コードは `packages/core/` に適切なエクスポート設定で配置します
- 関数は `packages/functions/` に配置します
- インフラストラクチャは `infra/` の論理ファイルに分割する必要があります

## モノレポ規約

- ワークスペース名を使用して共有モジュールをインポートします：`@my-app/core/example`

ここにプロジェクト固有の指示を追加しており、これはチーム全体で共有されます。

タイプ

dropstone は複数の場所から AGENTS.md ファイルを読み取ることもサポートしています。これはさまざまな目的に役立ちます。

プロジェクト

プロジェクト固有のルールについては、プロジェクト ルートに AGENTS.md を配置します。これらは、このディレクトリまたはそのサブディレクトリで作業している場合にのみ適用されます。

グローバル

~/.config/dropstone/AGENTS.md ファイルにグローバル ルールを設定することもできます。これはすべての dropstone セッションに適用されます。

これは Git にコミットされたり、チームと共有されたりしないため、LLM が従うべき個人的なルールを指定するために使用することをお勧めします。

Claude Code 互換性

Claude Code から移行するユーザーの場合、Dropstone はフォールバックとして Claude Code のファイル規約を読み取ります：

• プロジェクト ルール：プロジェクト ディレクトリの CLAUDE.md（AGENTS.md が存在しない場合に使用）
• グローバル ルール：~/.claude/CLAUDE.md（~/.config/dropstone/AGENTS.md が存在しない場合に使用）
• スキル：~/.claude/skills/（詳細は Skills を参照）

Dropstone が Claude Code の場所を読み取るのを停止するには、それらのファイルを削除または名前変更するか（または同等のコンテンツを AGENTS.md にコミットして、プロジェクトが優先されるようにします）。

優先順位

Dropstone が起動すると、ルール ファイルを次の順序で探します：

1. ローカル ファイル - 現在のディレクトリから上へ走査（AGENTS.md、CLAUDE.md）
2. グローバル ファイル - ~/.config/dropstone/AGENTS.md
3. Claude Code ファイル - ~/.claude/CLAUDE.md（上記のいずれも存在しない場合）

各カテゴリで最初にマッチしたファイルが優先されます。たとえば、AGENTS.md と CLAUDE.md の両方がある場合、AGENTS.md のみが使用されます。同様に、~/.config/dropstone/AGENTS.md は ~/.claude/CLAUDE.md より優先されます。

カスタム指示

dropstone.json またはグローバル ~/.config/dropstone/dropstone.json でカスタム指示ファイルを指定できます。これにより、AGENTS.md に複製する必要がなく、既存のルールを再利用できます。

例：

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

リモート URL を使用して、Web からの指示を読み込むこともできます。

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

リモート指示は 5 秒のタイムアウトで取得されます。

すべての指示ファイルは AGENTS.md ファイルと組み合わされます。

外部ファイルの参照

dropstone は AGENTS.md のファイル参照を自動的に解析しませんが、2 つの方法で同様の機能を実現できます：

dropstone.json の使用

推奨される方法は、dropstone.json の instructions フィールドを使用することです：

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

AGENTS.md のマニュアル指示

AGENTS.md に明示的な指示を提供することで、dropstone に外部ファイルを読み取るように教えることができます。実用的な例を以下に示します：

# TypeScript プロジェクト ルール

## 外部ファイル読み込み

重要：ファイル参照（例：@rules/general.md）に遭遇した場合は、Read ツールを使用して必要に応じて読み込みます。これらは特定のタスクに関連しています。

指示：

- すべての参照を事前に読み込まないでください - 実際の必要性に基づいて遅延読み込みを使用します
- 読み込まれた場合、コンテンツを必須の指示として扱い、デフォルトをオーバーライドします
- 必要に応じて参照を再帰的にフォローします

## 開発ガイドライン

TypeScript コード スタイルとベスト プラクティスについては：@docs/typescript-guidelines.md
React コンポーネント アーキテクチャとフック パターンについては：@docs/react-patterns.md
REST API 設計とエラー処理については：@docs/api-standards.md
テスト戦略とカバレッジ要件については：@test/testing-guidelines.md

## 一般的なガイドライン

すべてのワークフローに関連しているため、次のファイルを直ちに読み込みます：@rules/general-guidelines.md。

このアプローチにより、以下が可能になります：

• モジュール化された再利用可能なルール ファイルを作成する
• シンボリック リンクまたは git サブモジュール経由でプロジェクト間でルールを共有する
• AGENTS.md を簡潔に保ちながら詳細なガイドラインを参照する
• dropstone が特定のタスクに必要な場合にのみファイルを読み込むようにする