From 7571bac978b91c6f3909c3c4c54b9282ef4dff7f Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Sun, 1 Nov 2026 23:14:57 -0800 Subject: [PATCH 1/2] docs(native-agents): say where a prompt edit actually reaches A native agent's systemPrompt is copied into each install's config, and the runtime reads the copy. The F60 Scout prompt change reached only the demo-pod install on deploy; every other install needed the refresh script. Say so at the field an editor touches. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_015AKgpQ2pr6xRMhN5mcfoHF --- backend/config/native-agents/types.ts | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/backend/config/native-agents/types.ts b/backend/config/native-agents/types.ts index 439aec1df1..09ca181657 100644 --- a/backend/config/native-agents/types.ts +++ b/backend/config/native-agents/types.ts @@ -55,6 +55,10 @@ export interface NativeAgentDefinition { agentName: string; displayName: string; description: string; + // Copied into AgentInstallation.config at install, and the runtime reads the + // copy. A deploy refreshes only the demo-pod install (seed-native-agents); + // every other install gets an edit here only after + // scripts/refresh-native-agent-configs.ts runs (dry run first, then --apply). systemPrompt: string; model: string; triggers: NativeAgentTrigger[]; From ff42050ec0d57424c23284b628a23c04d2fd5504 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Sun, 1 Nov 2026 23:27:41 -0800 Subject: [PATCH 2/2] docs(native-agents): scope the refresh note to the installs each path touches Per CodeRabbit on #3320: the deploy seed skips perUser apps, and the refresh script touches only active installs and writes only with --apply. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_015AKgpQ2pr6xRMhN5mcfoHF --- backend/config/native-agents/types.ts | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/backend/config/native-agents/types.ts b/backend/config/native-agents/types.ts index 09ca181657..252d1dd655 100644 --- a/backend/config/native-agents/types.ts +++ b/backend/config/native-agents/types.ts @@ -56,9 +56,9 @@ export interface NativeAgentDefinition { displayName: string; description: string; // Copied into AgentInstallation.config at install, and the runtime reads the - // copy. A deploy refreshes only the demo-pod install (seed-native-agents); - // every other install gets an edit here only after - // scripts/refresh-native-agent-configs.ts runs (dry run first, then --apply). + // copy. A deploy refreshes only a non-perUser app's demo-pod install + // (seed-native-agents). Other active installs get an edit here only when + // scripts/refresh-native-agent-configs.ts runs with --apply (dry run first). systemPrompt: string; model: string; triggers: NativeAgentTrigger[];