コンテンツにスキップ
OpenCode
app.header.homeapp.header.docs

ルール

opencodeのカスタム命令を設定します。

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

初期化する

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

This AGENTS.md ファイルが生成されます。これは、opencode がプロジェクトをより適切にナビゲートするのに役立ちます。

既存の AGENTS.md ファイルがある場合、これはそれに追加しようとします。

例

このファイルを手動で作成することもできます。以下は、AGENTS.md ファイルに含めることができるいくつかの例です。

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`

ここにプロジェクト固有の手順を追加します。これはチーム全体で共有されます。

種類

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

プロジェクト

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

グローバル

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

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

Claude Code Compatibility

Claude Code から移行するユーザーのために、OpenCode はフォールバックとして Claude Code のファイル規則をサポートしています。

  • プロジェクト ルール: プロジェクト ディレクトリ内の CLAUDE.md (AGENTS.md が存在しない場合に使用されます)
  • グローバル ルール: ~/.claude/CLAUDE.md (~/.config/opencode/AGENTS.md が存在しない場合に使用)
  • スキル: ~/.claude/skills/ — 詳細については、エージェント スキル を参照してください。

クロード コードの互換性を無効にするには、次の環境変数のいずれかを設定します。

Terminal window
export OPENCODE_DISABLE_CLAUDE_CODE=1        # Disable all .claude support
export OPENCODE_DISABLE_CLAUDE_CODE_PROMPT=1 # Disable only ~/.claude/CLAUDE.md
export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills

優先順位

opencode が開始されると、次の順序でルール ファイルが検索されます。

  1. ローカル ファイル (現在のディレクトリから上に移動) (AGENTS.md、CLAUDE.md)
  2. グローバル ファイル (~/.config/opencode/AGENTS.md)
  3. クロード コード ファイル (~/.claude/CLAUDE.md にあります) (無効になっていない限り)

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

カスタム指示

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

例：

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

リモート URL を使用して Web から命令をロードすることもできます。

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

リモート命令は 5 秒のタイムアウトでフェッチされます。

すべての命令ファイルは AGENTS.md ファイルと結合されます。

外部ファイルの参照

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

opencode.json の使用

推奨されるアプローチは、instructions の opencode.json フィールドを使用することです。

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

AGENTS.md のマニュアル手順

AGENTS.md で明示的な命令を指定することで、opencodeに外部ファイルを読み取るように教えることができます。実際の例を次に示します。

AGENTS.md
# 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.

このアプローチにより、次のことが可能になります。

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