refactor: introduce TASK_SOUL.md for task-specific behavior and update related documentation

frontend/src/app/agents/[agentId]/edit/page.tsx

@@ -245,11 +245,22 @@ export default function EditAgentPage() {
     }
     setError(null);
 
+    const existingHeartbeat =
+      loadedAgent.heartbeat_config &&
+      typeof loadedAgent.heartbeat_config === "object"
+        ? (loadedAgent.heartbeat_config as Record<string, unknown>)
+        : {};
+
     const payload: AgentUpdate = {
       name: trimmed,
       heartbeat_config: {
+        ...existingHeartbeat,
         every: resolvedHeartbeatEvery.trim() || "10m",
         target: resolvedHeartbeatTarget,
+        includeReasoning:
+          typeof existingHeartbeat.includeReasoning === "boolean"
+            ? existingHeartbeat.includeReasoning
+            : false,
       } as unknown as Record<string, unknown>,
       identity_profile: mergeIdentityProfile(
         loadedAgent.identity_profile,

frontend/src/app/agents/new/page.tsx

@@ -142,6 +142,7 @@ export default function NewAgentPage() {
         heartbeat_config: {
           every: heartbeatEvery.trim() || "10m",
           target: heartbeatTarget,
+          includeReasoning: false,
         },
         identity_profile: normalizeIdentityProfile(
           identityProfile,

frontend/src/lib/agent-templates.ts

@@ -35,9 +35,19 @@ Be the assistant you'd actually want to talk to. Concise when needed, thorough w
 
 Each session, you wake up fresh. These files _are_ your memory. Read them. Update them. They're how you persist.
 
-If you change this file, tell the user -- it's your soul, and they should know.
+## Task-Adaptive Soul
 
----
+SOUL.md is your stable core.
+Your task-specific behavior should be driven by TASK_SOUL.md.
 
-_This file is yours to evolve. As you learn who you are, update it._
+For each new active task:
+1) Read task context + recent board/group memory.
+2) Refresh TASK_SOUL.md with mission, audience, artifact, quality bar, constraints, collaboration, and done signal.
+3) Execute using that lens.
+
+Promote patterns to:
+- SELF.md when they are personal operating preferences.
+- SOUL.md only when they are durable core principles.
+
+If you change this file, tell the user. But prefer to evolve in SELF.md.
 `;