Audit and align v1 runtime design

1 files changed, 17 insertions, 1 deletions

diff --git a/README.md b/README.md
index 6e03f75..f17cc99 100644
--- a/README.md
+++ b/README.md
@@ -51,6 +51,15 @@ logging:
   retained_files: 5
 ```
 
+配布された`agent.yaml`と同じdirectoryに任意の`agent.local.yaml`を置くと、環境固有値だけを上書きできます。mapは再帰merge、scalarと配列はlocal側で置換され、merge後の全設定を通常どおり検証します。相対pathは`agent.yaml`のdirectory基準です。local設定から利用者固有のSystem PromptやSkill directoryを指定できます。`agent.local.yaml`と、その参照先prompt／SkillはRelease Bundleへ含まれず、publishでも上書きされません。雛形は`config/agent.local.example.yaml`です。
+
+引数なし、または最初の引数がoptionの場合は`serve`として扱われます。次の2つは同じです。
+
+```powershell
+.\agent-mcp.exe serve --config .\agent.yaml
+.\agent-mcp.exe --config .\agent.yaml
+```
+
 Task状態は`state/mcp-tasks/`へatomic保存されます。再起動時の未完了Taskは`failed/server_restarted`となり、自動再実行されません。
 
 ```yaml
@@ -93,7 +102,7 @@ Ollama通信は管理Broker側から行うため、Sandbox processのnetwork許�
 
 ## Agent Skills
 
-`skills/<skill-name>/SKILL.md`形式と、互換用の`skills/*.md`を読み込みます。SkillはLLMへの補助指示であり、Filesystem/Process/Network権限は付与しません。Skillが使用する実行ファイルは、別途`agent.yaml`でabsolute pathとSHA-256を承認してください。
+`skills/<skill-name>/SKILL.md`形式だけを読み込みます。legacyの`skills/*.md`は読み込みません。SkillはLLMへの補助指示であり、Filesystem/Process/Network権限は付与しません。Skillが使用する実行ファイルは、別途`agent.yaml`でabsolute pathとSHA-256を承認してください。
 
 ## stdio
 
@@ -139,6 +148,13 @@ HTTP logは`X-Forwarded-For`を接続元として信用せず、Authorization、
 
 HTTP request処理はconsole/file出力と同期しません。運用logはbounded queue経由でbackground出力し、consoleが一時停止してもHTTP requestを停止させません。queue飽和時はrequest継続を優先し、drop件数をapplication logへ警告します。
 
+LLM/Audit JSONLはtask、session、event、call単位で絞り込めます。
+
+```powershell
+.\scripts\Read-AgentLog.ps1 -Path .\logs\llm.jsonl -TaskId <task-id> -Tail 100
+.\scripts\Read-AgentLog.ps1 -Path .\logs\audit.jsonl -Event policy.deny -Tail 100
+```
+
 正常停止後、`agent-mcp.exe` descendant、追加ACL、WFP filter、loopback exemption、`state/backups`、`state/journals` が残っていないことを確認してください。loopback exemptionは `CheckNetIsolation.exe LoopbackExempt -s` で確認できます。
 
 ## よくあるエラー