1 files changed, 7 insertions, 3 deletions
diff --git a/doc/Design.md b/doc/Design.md
index 5a8d0f0..032723e 100644
--- a/doc/Design.md
+++ b/doc/Design.md
@@ -1,4 +1,4 @@
-# AI Agent Sandbox MCP Server — 設計書
+# WinAgent Sandbox MCP — 設計書
 
 **文書名:** `Design.md`  
 **版:** 0.1 Draft  
@@ -831,8 +831,12 @@ errorは内部codeとlocalized messageを分離し、ログ/auditにはcode、MC
 | 10 | Release/Operational E2E | self-contained Bundle単独起動、stdio/HTTP実利用 |
 
 ### 21.1 Release設計
-- mainと昇格hostを同じversion/RIDで`dotnet publish -c Release -r win-x64 --self-contained true`し、mainをBundle root、昇格hostを固定`admin/` subdirectoryへ配置する。
-- Bundleはversion付きZIP、展開済みdirectory、file manifest、SHA-256 checksumから成る。
+- Application Versionの正本はRepository rootの`Directory.Build.props`にある`VersionPrefix`とする。Configuration schema versionおよびMCP protocol versionとは独立して管理する。.NET SDK標準のAssemblyVersion、FileVersion、InformationalVersion生成を使用し、Source Revision suffixとWindowsの4要素version表現を許容する。
+- mainと昇格hostを同じApplication Version/RIDで`dotnet publish -c Release -r win-x64 --self-contained true`し、mainを固定名`winagent-sandbox-mcp/`のBundle root、昇格hostを固定`admin/` subdirectoryへ配置する。helper compatibility preflightはmain/helper versionのmajor/minor/buildをparseして比較する。
+- `build/Release/publish/winagent-sandbox-mcp/`はRelease artifact生成用staging成果物であり、利用者deploymentではない。publishごとに一時directoryで完全生成・検査した後、固定Bundle directoryをclean置換する。旧version付きdirectoryは自動移動または削除しない。
+- Bundleはversionを含まない展開済みdirectory、file manifest、version付きZIP、SHA-256 checksumから成る。ZIPの内部rootとExecutable名はversionを持たず、ZIP/checksum filenameだけにApplication Versionを含める。
+- Release BundleとZIPへ`agent.local.yaml`、`local/`、`logs/`、`state/`、Applied Configuration Storeまたは過去のtest/development資産を含めない。生成時とZIPのfresh展開後に禁止項目を検査する。
+- 利用者deploymentのupgradeではExecutableと既定資産だけを置換し、利用者のlocal設定、Prompt、Skill、logs、state、Applied Configuration Storeを上書きしない。installer/deployment upgrade scriptは提供しない。deployment pathを変更した場合は新config pathで`show`後に`apply`する。
 - main manifestは`asInvoker`、`admin/agent-mcp-admin.exe` manifestは`requireAdministrator`かつ`uiAccess=false`とする。mainは`AppContext.BaseDirectory/admin/agent-mcp-admin.exe`だけを参照し、PATH検索やConfigurationによる差替えを許さない。
 - 起動時の相対pathは実行ファイルdirectoryを基準に解決し、ソースツリーを参照しない。
 - 現行Operational E2Eは配布既定の`deepseek-v4-flash:cloud`を使用する。rate limit、接続失敗、model unavailableをapplication PASSとして扱わない。