安定した指示を AGENTS.md に置く
repository root の AGENTS.md に、全タスク共通の architecture boundary、build/test command、coding convention、安全規則を書きます。subtree が本当に異なる場合だけ nested AGENTS.md を追加します。
Grok は repository root から working directory へ rules を探索し、競合時は深いファイルが優先されます。短く具体的な規則は、大きな handbook より従いやすくレビューもしやすくなります。
- 実行できる verification commands を書く。
- generated path と protected path を明示する。
- 一時的な作業ではなく architecture constraints を説明する。
証拠を使って Claude Code から移行する
xAI 公式文書は、native .grok assets と共に Claude Code の instruction files、marketplaces、plugins、skills、MCPs、agents、hooks を自動読込できると説明しています。これは出典付きの compatibility claim として扱い、全 extension が同じ動作だと仮定せず実 repository で確認します。
文書化された instruction sources には CLAUDE.md、Claude.md、CLAUDE.local.md、.claude/rules が含まれます。grok import subcommand は Claude Code sessions 向けで、asset discovery に import は不要です。
grok inspect
# 必要なとき互換 Claude Code session history を取り込む
grok importRepository を汚さず一回限りの rule を加える
現在の run だけに必要な狭い指示には --rules を使います。system-prompt override は system prompt 全体を置き換えるため、安易に使いません。
ファイルまたは compatibility settings の変更後に inspect を再実行します。報告された path と概算 token cost を確認し、重複や競合を元のファイルで解消します。
grok --rules "Always use TypeScript. Prefer functional components."
grok inspect