unity-editor-mcp AGENTS.md

unity-editor-mcp AGENTS.md is an instructions file for Codex, OpenCode from akiojin/unity-editor-mcp. It costs 3,654 tokens per session, scanned A, original, MIT.

A development guide for a tool that connects AI agents to the Unity game editor, with rules for design, testing, documentation, and releases.

In plain words
What is it for?
Use it when adding or changing Unity editor features, updating tests and reports, managing sample assets, or preparing package releases.
Why use it?
It reduces inconsistent implementation and defines what must be checked before work is considered finished.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/akiojin/unity-editor-mcp/agents-md
Clone the repo
git clone --depth 1 https://github.com/akiojin/unity-editor-mcp

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for unity-editor-mcp AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/akiojin/unity-editor-mcp/agents-md.svg)](https://agentmods.dev/instructions/akiojin/unity-editor-mcp/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/akiojin/unity-editor-mcp/agents-md"><img src="https://agentmods.dev/badge/instructions/akiojin/unity-editor-mcp/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 3,654 This file is loaded in full into every session.
When invoked 3,654 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.03654 $0.03654
Opus 5 $0.01827 $0.01827
Sonnet 5 $0.00731 $0.00731
Haiku 4.5 $0.00365 $0.00365

Measured 3d ago against content hash 99ab97ae116a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

unity-editor-mcp AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 198 lines

How it starts

The opening of the file, as written. The whole thing — 198 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AGENTS.md

このファイルは、このリポジトリでコードを扱う際のガイダンスを提供します。

開発指針

🛠️ 技術実装指針

  • 設計・実装は複雑にせずに、シンプルさの極限を追求してください
  • ただし、ユーザビリティと開発者体験の品質は決して妥協しない
  • 実装はシンプルに、開発者体験は最高品質に
  • CLI操作の直感性と効率性を技術的複雑さより優先

📝 設計ガイドライン

  • 設計に関するドキュメントには、ソースコードを書かないこと

開発品質

完了条件

  • エラーが発生している状態で完了としないこと。必ずエラーが解消された時点で完了とする。

開発ワークフロー

基本ルール

  • 作業(タスク)を完了したら、変更点を日本語でコミットログに追加して、コミット&プッシュを必ず行う
  • 作業(タスク)は、最大限の並列化をして進める
  • 作業(タスク)は、最大限の細分化をしてToDoに登録する
  • 作業(タスク)の開始前には、必ずToDoを登録した後に作業を開始する
  • 作業(タスク)は、忖度なしで進める

テスト実行・出力ポリシー(エージェント向け)

  • 出力フォーマット: すべてのテスト結果は Markdown。仕様とテンプレートは tests/RESULTS_FORMAT.md を参照。
  • 出力先: 1 ラン=1 ファイル運用。tests/.reports/run-<YYYYMMDD_HHmmss>.md に集約(Git管理外、.gitignore 済)。任意で tests/.reports/latest.md を上書き更新。
  • ラン初期化: 最初に Run ID を採番し、パスを tests/.reports/.current-run に保存。以降の全カテゴリはこのパスへ追記(別ファイル作成禁止)。
    • サマリ更新: 各カテゴリ追記後とラン終了時に、先頭のサマリテーブルを再計算して上書き。更新後の全文を tests/.reports/latest.md にも上書きする。
  • ToDo運用: ファイル出力は不要。エージェント(LLM)の ToDo/プラン機能(update_plan 等)に、各カテゴリの全テスト項目を登録し、実行中は in_progress、完了時に completed へ「都度」更新する。
  • 原状回復: 各ケース終了時に必ず原状復帰(チェックリスト行に restored:true を明記)。
  • BLOCKED_ENV の原因記録: ブロック時はチェックリスト行に短い原因語句を必ず併記(例: blocked(Missing .sln))。加えて details に前提チェック結果の内訳(.sln/LSP/index など)を記載する。
  • fail / skip の理由記録: fail は簡潔な原因(期待不一致・検証エラー等)をチェックリスト行に併記し、details に根拠(入力・期待・観測・主要診断)を箇条書き。skip も理由を併記(例: skip(UI 無し))。
  • コミット禁止: テスト結果/ToDo/キャプチャは成果物扱いで Git には含めない(.unity/capture/, tests/.reports/, tests/.todo/ は .gitignore 済)。
  • 参照場所の要約:
    • 実行ログ: ターミナル(stdout)
    • テストレポート本体: tests/.reports/run-<YYYYMMDD_HHmmss>.md(Git管理外。.gitignore 済)
    • 最新ポインタ: tests/.reports/latest.md(当該ランの内容を都度上書き)
    • 追記先ポインタ: tests/.reports/.current-run(各カテゴリはこのパスに追記)
    • ToDo 台帳: tests/.todo/ または tests/TODO.md
    • フォーマット仕様: tests/RESULTS_FORMAT.md

備考(アーカイブ):

  • スクリーンショット/動画の保存先は固定で <workspace>/.unity/capture/。レポートから相対参照可。

コミュニケーションガイドライン

  • 回答は必ず日本語

ドキュメント管理

  • ドキュメントはREADME.md/README.ja.mdに集約する

Assets配下の扱い(サンプル/Unityプロジェクト側)

  • 目的: サンプル・検証・デモ・手動動作確認用のシーン/プレハブ/補助スクリプトを配置。
  • 禁止: unity-editor-mcp 実装本体(ランタイム/エディタ拡張の主要コード)を置かない。UPM配布の対象にも含めない。
  • 編集: 必要最小限に留める。C#編集は外部CLIで行い、Assets側は参照/設定のみで成立させる。

Read the full file on GitHub · 198 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 198 lines · 3,654 tokens per session scan A 99ab97ae116a

Subscribe to this mod's changes

unity-editor-mcp AGENTS.md is an instructions file published in the GitHub repository akiojin/unity-editor-mcp (11 stars, last pushed 12mo ago), licensed MIT. It adds 3,654 tokens to every session, about $0.0183 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.