openclaw-telegram-manager 2.8.0 → 2.9.0

package/dist/plugin.js

@@ -8816,7 +8816,7 @@ __export(value_exports2, {
 
 // src/lib/types.ts
 var CURRENT_REGISTRY_VERSION = 6;
-var CAPSULE_VERSION = 3;
+var CAPSULE_VERSION = 4;
 var MAX_POST_ERROR_LENGTH = 500;
 var MAX_NAME_LENGTH = 100;
 var DOCTOR_ALL_COOLDOWN_MS = 60 * 60 * 1e3;
@@ -8867,20 +8867,9 @@ var RegistrySchema = Type.Object({
   maxTopics: Type.Integer({ minimum: 1 }),
   topics: Type.Record(Type.String(), TopicEntrySchema)
 });
-var OVERLAY_FILES = {
-  coding: ["ARCHITECTURE.md", "DEPLOY.md"],
-  research: ["SOURCES.md", "FINDINGS.md"],
-  marketing: ["CAMPAIGNS.md", "METRICS.md"],
-  general: []
-};
 var BASE_FILES = [
   "README.md",
   "STATUS.md",
-  "TODO.md",
-  "COMMANDS.md",
-  "LINKS.md",
-  "CRON.md",
-  "NOTES.md",
   "LEARNINGS.md"
 ];
 function topicKey(groupId, threadId) {
@@ -9147,151 +9136,87 @@ function buildAuditEntry(userId, cmd, slug, detail) {
 // src/lib/capsule.ts
 import * as fs4 from "node:fs";
 import * as path4 from "node:path";
-var BASE_TEMPLATES = {
-  "README.md": (name) => `# ${name}
+var README_UNIVERSAL = (name) => `# ${name}
 
-_Describe what this topic is about._
-`,
-  "STATUS.md": (name) => `# Status: ${name}
-
-## Last done (UTC)
-
-${(/* @__PURE__ */ new Date()).toISOString()}
+## What is this about?
 
-Topic created. Waiting for first instructions.
+_Describe what this topic is about._
 
-## Next actions (now)
+## Goal
 
-_None yet._
+_What does success look like?_
 
-## Upcoming actions
+## Key resources
 
-_None yet._
-`,
-  "TODO.md": (name) => `# TODO: ${name}
+_URLs, repos, paths, dashboards \u2014 anything the AI needs after a reset._
+`;
+var README_TYPE_SECTIONS = {
+  coding: () => `
+## Architecture
 
-## Backlog
+_Components, data flow, key decisions._
 
-- [T-1] _e.g. Set up project scaffolding_
-- [T-2] _Waiting for next task_
-- [T-3] _Waiting for next task_
+## Deployment
 
-## Completed
+_Environments, deploy steps, rollback._
 
-_None yet._
-`,
-  "COMMANDS.md": (name) => `# Commands: ${name}
+## Commands
 
-_Build, deploy, test, and other commands for this topic. Kept here so they're not lost on reset._
+_Build, test, deploy \u2014 kept here so they survive a reset._
 `,
-  "LINKS.md": (name) => `# Links: ${name}
+  research: () => `
+## Sources
 
-## Key paths & URLs
+_Papers, articles, datasets, APIs._
 
-_Not set yet \u2014 add repository paths, dashboards, service URLs, or anything the agent needs after a reset._
-`,
-  "CRON.md": (name) => `# Cron: ${name}
+## Findings
 
-_Cron job IDs and schedules for this topic._
+_Key findings, evidence, recommendations._
 `,
-  "NOTES.md": (name) => `# Notes: ${name}
-
-_Anything worth remembering about this topic._
-`,
-  "LEARNINGS.md": (name) => `# Learnings: ${name}
-
-_Hard-won insights, mistakes, and workarounds._
-_Agent prepends here automatically. Most recent entries first._
-`
-};
-var OVERLAY_TEMPLATES = {
-  "ARCHITECTURE.md": (name) => `# Architecture: ${name}
+  marketing: () => `
+## Campaigns
 
-## Components
-
-_None yet._
+_Active campaigns, audiences, channels._
 
-## Data flow
+## Metrics
 
-_None yet._
-
-## Key decisions
-
-_None yet._
+_KPIs, targets, tracking dashboards._
 `,
-  "DEPLOY.md": (name) => `# Deployment: ${name}
-
-## Paths
-
-_Repository and runtime/data paths go here._
-
-## Environments
-
-_None yet._
-
-## Deploy steps
-
-_None yet._
-
-## Rollback
-
-_None yet._
-`,
-  "SOURCES.md": (name) => `# Sources: ${name}
-
-## Papers & articles
-
-_None yet._
-
-## Datasets & APIs
-
-_None yet._
-
-## Other references
-
-_None yet._
-`,
-  "FINDINGS.md": (name) => `# Findings: ${name}
-
-## Key findings
-
-_None yet._
+  general: () => ""
+};
+var BASE_TEMPLATES = {
+  "README.md": (name, type) => {
+    const universal = README_UNIVERSAL(name);
+    const extra = type ? README_TYPE_SECTIONS[type](name) : "";
+    return universal + extra;
+  },
+  "STATUS.md": (name) => `# Status: ${name}
 
-## Evidence & data
+## Last done (UTC)
 
-_None yet._
+${(/* @__PURE__ */ new Date()).toISOString()}
+Topic created. Waiting for first instructions.
 
-## Recommendations
+## Next actions (now)
 
 _None yet._
-`,
-  "CAMPAIGNS.md": (name) => `# Campaigns: ${name}
 
-## Active campaigns
+## Upcoming actions
 
 _None yet._
 
-## Audiences & channels
+## Backlog
 
-_None yet._
+- [T-1] _e.g. Set up project scaffolding_
 
-## Timeline & budget
+## Completed
 
 _None yet._
 `,
-  "METRICS.md": (name) => `# Metrics: ${name}
-
-## KPIs & targets
-
-_None yet._
-
-## Tracking & dashboards
-
-_None yet._
-
-## Performance data
+  "LEARNINGS.md": (name) => `# Learnings: ${name}
 
-_None yet._
+_Hard-won insights, mistakes, and workarounds._
+_Agent prepends here automatically. Most recent entries first._
 `
 };
 var CAPSULE_FILE_MODE = 416;
@@ -9308,15 +9233,7 @@ function scaffoldCapsule(projectsBase, slug, name, type) {
     const templateFn = BASE_TEMPLATES[file];
     if (templateFn) {
       const filePath = path4.join(capsuleDir, file);
-      fs4.writeFileSync(filePath, templateFn(name), { mode: CAPSULE_FILE_MODE });
-    }
-  }
-  const overlays = OVERLAY_FILES[type];
-  for (const file of overlays) {
-    const templateFn = OVERLAY_TEMPLATES[file];
-    if (templateFn) {
-      const filePath = path4.join(capsuleDir, file);
-      fs4.writeFileSync(filePath, templateFn(name), { mode: CAPSULE_FILE_MODE });
+      fs4.writeFileSync(filePath, templateFn(name, type), { mode: CAPSULE_FILE_MODE });
     }
   }
 }
@@ -9337,19 +9254,28 @@ function upgradeCapsule(projectsBase, slug, name, type, currentVersion) {
     if (!fs4.existsSync(filePath)) {
       const templateFn = BASE_TEMPLATES[file];
       if (templateFn) {
-        fs4.writeFileSync(filePath, templateFn(name), { mode: CAPSULE_FILE_MODE });
+        fs4.writeFileSync(filePath, templateFn(name, type), { mode: CAPSULE_FILE_MODE });
         addedFiles.push(file);
       }
     }
   }
-  const overlays = OVERLAY_FILES[type];
-  for (const file of overlays) {
-    const filePath = path4.join(capsuleDir, file);
-    if (!fs4.existsSync(filePath)) {
-      const templateFn = OVERLAY_TEMPLATES[file];
-      if (templateFn) {
-        fs4.writeFileSync(filePath, templateFn(name), { mode: CAPSULE_FILE_MODE });
-        addedFiles.push(file);
+  if (currentVersion < 4) {
+    const statusPath = path4.join(capsuleDir, "STATUS.md");
+    if (fs4.existsSync(statusPath)) {
+      const content = fs4.readFileSync(statusPath, "utf-8");
+      if (!content.includes("## Backlog")) {
+        const appendix = "\n## Backlog\n\n- [T-1] _e.g. Set up project scaffolding_\n\n## Completed\n\n_None yet._\n";
+        fs4.writeFileSync(statusPath, content.trimEnd() + "\n" + appendix, { mode: CAPSULE_FILE_MODE });
+      }
+    }
+    const readmePath = path4.join(capsuleDir, "README.md");
+    if (fs4.existsSync(readmePath)) {
+      const content = fs4.readFileSync(readmePath, "utf-8");
+      if (content.includes("_Describe what this topic is about._") && !content.includes("## Goal")) {
+        const templateFn = BASE_TEMPLATES["README.md"];
+        if (templateFn) {
+          fs4.writeFileSync(readmePath, templateFn(name, type), { mode: CAPSULE_FILE_MODE });
+        }
       }
     }
   }
@@ -9710,8 +9636,8 @@ Context hierarchy (strictly ordered):
 
 Determinism rules:
 - After /reset, /new, or context compaction: ALWAYS re-read your topic files
-  first \u2014 STATUS.md, then TODO.md, then LEARNINGS.md (last 20 entries), then
-  COMMANDS.md \u2014 before doing anything else. These are your ground truth.
+  first \u2014 STATUS.md, then LEARNINGS.md (last 20 entries), then README.md for
+  topic context \u2014 before doing anything else. These are your ground truth.
   Do not rely on summarized memory or workspace-level files for this topic's
   tasks, status, or goals.
 - Before context compaction or when the conversation is long: proactively
@@ -9719,13 +9645,12 @@ Determinism rules:
   "Next actions (now)") so compaction cannot erase critical state.
   Use the standard file write tool directly \u2014 do not route through /tm.
 - Keep STATUS.md accurate: always maintain "Last done (UTC)", "Next actions (now)",
-  and "Upcoming actions".
-- When new commands appear, add them to COMMANDS.md (don't leave them only in chat).
-- When new links/paths/services appear, add them to LINKS.md.
-- If automation/cron is involved, record job IDs + schedules in CRON.md.
-- Task IDs (e.g., [T-1]) must stay consistent between STATUS.md and TODO.md.
+  "Upcoming actions", "Backlog", and "Completed".
+- Task IDs (e.g., [T-1]) must stay consistent across STATUS.md sections.
+  Move completed tasks from Backlog to Completed.
 - STATUS.md has two priority sections: "Next actions (now)" for immediate work
   and "Upcoming actions" for the near-future pipeline.
+- Key resources, commands, and context belong in README.md.
 
 Learning capture:
 - When you discover something unexpected, a mistake, a workaround, or a
@@ -10434,19 +10359,6 @@ function runCapsuleChecks(entry, projectsBase) {
       check(Severity.ERROR, "statusMissing", "Status file is missing", true, "Run /tm upgrade to recreate it")
     );
   }
-  if (!fs8.existsSync(path8.join(capsuleDir, "TODO.md"))) {
-    results.push(
-      check(Severity.WARN, "todoMissing", "TODO file is missing", true, "Run /tm upgrade to recreate it")
-    );
-  }
-  const overlays = OVERLAY_FILES[entry.type] ?? [];
-  for (const file of overlays) {
-    if (!fs8.existsSync(path8.join(capsuleDir, file))) {
-      results.push(
-        check(Severity.INFO, `overlayMissing:${file}`, `Optional overlay ${file} missing for type "${entry.type}"`, true)
-      );
-    }
-  }
   if (entry.capsuleVersion < CAPSULE_VERSION) {
     results.push(
       check(
@@ -10523,7 +10435,8 @@ function runStatusQualityChecks(statusContent, entry) {
   }
   return results;
 }
-function runNextVsTodoChecks(statusContent, todoContent) {
+var BACKLOG_RE = /^##\s*Backlog/im;
+function runNextVsBacklogChecks(statusContent) {
   const results = [];
   const nextActionsIndex = statusContent.search(NEXT_ACTIONS_RE);
   if (nextActionsIndex < 0) return results;
@@ -10532,14 +10445,19 @@ function runNextVsTodoChecks(statusContent, todoContent) {
   const nextActionsSection = nextSectionIndex > 0 ? sectionAfter.slice(0, nextSectionIndex) : sectionAfter;
   const nextTaskIds = nextActionsSection.match(TASK_ID_RE) ?? [];
   if (nextTaskIds.length === 0) return results;
-  const todoTaskIds = new Set(todoContent.match(TASK_ID_RE) ?? []);
-  const missing = nextTaskIds.filter((id) => !todoTaskIds.has(id));
+  const backlogIndex = statusContent.search(BACKLOG_RE);
+  if (backlogIndex < 0) return results;
+  const backlogAfter = statusContent.slice(backlogIndex);
+  const backlogNextSection = backlogAfter.indexOf("\n## ", 1);
+  const backlogSection = backlogNextSection > 0 ? backlogAfter.slice(0, backlogNextSection) : backlogAfter;
+  const backlogTaskIds = new Set(backlogSection.match(TASK_ID_RE) ?? []);
+  const missing = nextTaskIds.filter((id) => !backlogTaskIds.has(id));
   if (missing.length >= 2) {
     results.push(
       check(
         Severity.WARN,
-        "nextNotInTodo",
-        `${missing.length} tasks referenced in next actions don't exist in the TODO list: ${missing.join(", ")}`,
+        "nextNotInBacklog",
+        `${missing.length} tasks referenced in next actions don't exist in the backlog: ${missing.join(", ")}`,
         false,
         "The AI will clean these up on next interaction"
       )
@@ -10547,62 +10465,18 @@ function runNextVsTodoChecks(statusContent, todoContent) {
   }
   return results;
 }
-function runCommandsLinksChecks(entry, capsuleFiles) {
-  const results = [];
-  if (entry.type === "coding") {
-    const commandsContent = capsuleFiles.get("COMMANDS.md");
-    if (commandsContent !== void 0 && isEffectivelyEmpty(commandsContent)) {
-      results.push(
-        check(Severity.INFO, "commandsEmpty", "COMMANDS.md is empty for a coding topic", false, "Add build/test/deploy commands to COMMANDS.md")
-      );
-    }
-  }
-  if (entry.type === "coding" || entry.type === "research") {
-    const linksContent = capsuleFiles.get("LINKS.md");
-    if (linksContent !== void 0 && isEffectivelyEmpty(linksContent)) {
-      results.push(
-        check(Severity.INFO, "linksEmpty", "LINKS.md is empty for a coding/research topic", false, "Add URLs and endpoints to LINKS.md")
-      );
-    }
-  }
-  return results;
-}
-function isEffectivelyEmpty(content) {
-  const stripped = content.replace(/^#.*$/gm, "").replace(/^_.*_$/gm, "").replace(/\s+/g, "").trim();
-  return stripped.length === 0;
-}
-var JOB_ID_RE = /[a-zA-Z0-9_-]{8,}/;
-function runCronChecks(cronContent, cronJobsPath) {
+function runUnfilledContextCheck(capsuleFiles) {
   const results = [];
-  if (isEffectivelyEmpty(cronContent)) return results;
-  const lines = cronContent.split("\n").filter((l) => !l.startsWith("#") && l.trim().length > 0);
-  const hasJobIds = lines.some((line) => JOB_ID_RE.test(line));
-  if (!hasJobIds) {
+  const readmeContent = capsuleFiles.get("README.md");
+  if (readmeContent && readmeContent.includes("_Describe what this topic is about._")) {
     results.push(
-      check(Severity.WARN, "cronNoJobIds", "Scheduled jobs are listed but have no recognizable job IDs", false)
+      check(
+        Severity.INFO,
+        "contextUnfilled",
+        "Topic context is empty \u2014 tell the AI about your project to get better help.",
+        false
+      )
     );
-    return results;
-  }
-  if (cronJobsPath && fs8.existsSync(cronJobsPath)) {
-    try {
-      const jobsRaw = fs8.readFileSync(cronJobsPath, "utf-8");
-      const jobs = JSON.parse(jobsRaw);
-      const knownJobIds = new Set(Object.keys(jobs));
-      for (const line of lines) {
-        const match = line.match(JOB_ID_RE);
-        if (match && !knownJobIds.has(match[0])) {
-          results.push(
-            check(
-              Severity.WARN,
-              "cronJobNotFound",
-              `Scheduled job "${match[0]}" not found in the jobs registry`,
-              false
-            )
-          );
-        }
-      }
-    } catch {
-    }
   }
   return results;
 }
@@ -10700,7 +10574,7 @@ function runPostErrorCheck(entry) {
   }
   return results;
 }
-function runAllChecksForTopic(entry, projectsBase, includeContent, registry, cronJobsPath) {
+function runAllChecksForTopic(entry, projectsBase, includeContent, registry) {
   const results = [];
   const capsuleDir = path8.join(projectsBase, entry.slug);
   results.push(...runRegistryChecks(entry, projectsBase));
@@ -10711,16 +10585,9 @@ function runAllChecksForTopic(entry, projectsBase, includeContent, registry, cro
   const statusContent = capsuleFiles.get("STATUS.md");
   if (statusContent) {
     results.push(...runStatusQualityChecks(statusContent, entry));
-    const todoContent = capsuleFiles.get("TODO.md");
-    if (todoContent) {
-      results.push(...runNextVsTodoChecks(statusContent, todoContent));
-    }
-  }
-  results.push(...runCommandsLinksChecks(entry, capsuleFiles));
-  const cronContent = capsuleFiles.get("CRON.md");
-  if (cronContent) {
-    results.push(...runCronChecks(cronContent, cronJobsPath));
+    results.push(...runNextVsBacklogChecks(statusContent));
   }
+  results.push(...runUnfilledContextCheck(capsuleFiles));
   if (includeContent && registry) {
     results.push(...runConfigChecks(entry, includeContent, registry));
   }
@@ -10731,7 +10598,7 @@ function runAllChecksForTopic(entry, projectsBase, includeContent, registry, cro
   return results;
 }
 var BACKUP_DIR = ".tm-backup";
-var BACKUP_FILES = ["STATUS.md", "TODO.md"];
+var BACKUP_FILES = ["STATUS.md"];
 function backupCapsuleIfHealthy(projectsBase, slug, results) {
   const hasIssues = results.some((r) => r.severity === Severity.ERROR || r.severity === Severity.WARN);
   if (hasIssues) return;
@@ -10750,22 +10617,7 @@ function backupCapsuleIfHealthy(projectsBase, slug, results) {
 }
 function readCapsuleFiles(capsuleDir) {
   const files = /* @__PURE__ */ new Map();
-  const filenames = [
-    "STATUS.md",
-    "TODO.md",
-    "COMMANDS.md",
-    "LINKS.md",
-    "CRON.md",
-    "NOTES.md",
-    "README.md",
-    "LEARNINGS.md",
-    "ARCHITECTURE.md",
-    "DEPLOY.md",
-    "SOURCES.md",
-    "FINDINGS.md",
-    "CAMPAIGNS.md",
-    "METRICS.md"
-  ];
+  const filenames = ["README.md", "STATUS.md", "LEARNINGS.md"];
   for (const name of filenames) {
     const filePath = path8.join(capsuleDir, name);
     try {
@@ -10810,13 +10662,11 @@ async function handleDoctor(ctx) {
     }
   } catch {
   }
-  const cronJobsPath = path9.join(configDir, "cron", "jobs.json");
   const results = runAllChecksForTopic(
     entry,
     projectsBase,
     includeContent,
-    registry,
-    cronJobsPath
+    registry
   );
   backupCapsuleIfHealthy(projectsBase, entry.slug, results);
   const reportText = buildDoctorReport(entry.name, results);
@@ -10869,9 +10719,8 @@ async function handleDailyReport(ctx) {
     return { text: "Topic files not found. Run /tm init to set up this topic." };
   }
   const statusContent = readFileOrNull(path10.join(capsuleDir, "STATUS.md"));
-  const todoContent = readFileOrNull(path10.join(capsuleDir, "TODO.md"));
   const doneContent = extractDoneSection(statusContent);
-  const blockers = extractBlockers(todoContent);
+  const blockers = extractBlockers(statusContent);
   const nextContent = extractNextActions(statusContent);
   const reportData = {
     name: entry.name,
@@ -10925,9 +10774,11 @@ function extractDoneSection(statusContent) {
   const text = match[1]?.trim();
   return text || "Empty.";
 }
-function extractBlockers(todoContent) {
-  if (!todoContent) return "No tasks recorded yet.";
-  const lines = todoContent.split("\n");
+function extractBlockers(statusContent) {
+  if (!statusContent) return "No tasks recorded yet.";
+  const backlogMatch = statusContent.match(/^##\s*Backlog\b.*\n((?:(?!\n## )[\s\S])*)/im);
+  const backlogSection = backlogMatch ? backlogMatch[1] ?? "" : statusContent;
+  const lines = backlogSection.split("\n");
   const blockerLines = lines.filter(
     (l) => /\[BLOCKED\]/i.test(l) || /\bblocked\b/i.test(l)
   );
@@ -11087,13 +10938,13 @@ async function handleDoctorAll(ctx) {
     }
   } catch {
   }
-  const cronJobsPath = path11.join(configDir, "cron", "jobs.json");
   const allEntries = Object.entries(registry.topics);
   const reports = [];
   const errors = [];
   const checkedTopics = [];
   const skippedTopics = [];
   const groupPostResults = /* @__PURE__ */ new Map();
+  const upgradedSlugs = /* @__PURE__ */ new Set();
   for (const [_key, entry] of allEntries) {
     const capsuleDir = path11.join(projectsBase, entry.slug);
     const statusForEligibility = readFileOrNull(path11.join(capsuleDir, "STATUS.md"));
@@ -11104,12 +10955,22 @@ async function handleDoctorAll(ctx) {
       continue;
     }
     try {
+      if (entry.capsuleVersion < CAPSULE_VERSION) {
+        const oldVersion = entry.capsuleVersion;
+        try {
+          upgradeCapsule(projectsBase, entry.slug, entry.name, entry.type, entry.capsuleVersion);
+          upgradedSlugs.add(entry.slug);
+          logger.info(`[doctor-all] Auto-upgraded ${entry.slug} v${oldVersion} \u2192 v${CAPSULE_VERSION}`);
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          logger.error(`[doctor-all] Auto-upgrade failed for ${entry.slug}: ${msg}`);
+        }
+      }
       const results = runAllChecksForTopic(
         entry,
         projectsBase,
         includeContent,
-        registry,
-        cronJobsPath
+        registry
       );
       const isSpam = entry.consecutiveSilentDoctors >= SPAM_THRESHOLD;
       if (isSpam) {
@@ -11211,6 +11072,9 @@ async function handleDoctorAll(ctx) {
         entry.consecutiveSilentDoctors++;
       }
       entry.lastDoctorRunAt = now.toISOString();
+      if (upgradedSlugs.has(entry.slug)) {
+        entry.capsuleVersion = CAPSULE_VERSION;
+      }
       if (entry.consecutiveSilentDoctors >= SPAM_THRESHOLD) {
         entry.snoozeUntil = new Date(Date.now() + 30 * 24 * 60 * 60 * 1e3).toISOString();
         entry.status = "snoozed";
@@ -11310,10 +11174,10 @@ function hasBlockers(blockers) {
   return blockers !== "None." && blockers !== "No tasks recorded yet.";
 }
 function formatStatus(data) {
-  const { name, type, statusContent, todoContent, expanded } = data;
+  const { name, type, statusContent, expanded } = data;
   const timestamp = extractTimestamp(statusContent);
   const nextRaw = extractSection(statusContent, NEXT_ACTIONS_RE2);
-  const blockers = extractBlockers(todoContent);
+  const blockers = extractBlockers(statusContent);
   const doneMatch = statusContent.match(LAST_DONE_RE2);
   let lastDoneBody = "";
   if (doneMatch) {
@@ -11378,13 +11242,11 @@ async function handleStatus2(ctx, args) {
   const expanded = args.trim() === "--expanded";
   try {
     const statusContent = fs12.readFileSync(statusPath, "utf-8");
-    const todoContent = readFileOrNull(path12.join(capsuleDir, "TODO.md"));
     return {
       text: truncateMessage(formatStatus({
         name: entry.name,
         type: entry.type,
         statusContent,
-        todoContent,
         expanded
       }))
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-telegram-manager",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "type": "module",
   "description": "Deterministic Telegram forum topic management for OpenClaw",
   "keywords": [

package/skills/tm/SKILL.md

@@ -15,27 +15,33 @@ If you detect any of these conditions, invoke `topic_manager` proactively:
 
 1. **After /reset, /new, or context compaction**: call `topic_manager` with
    command "status" to re-read the topic files and rehydrate context.
-   Rehydration order: STATUS.md, TODO.md, LEARNINGS.md (last 20 entries),
-   COMMANDS.md, LINKS.md, then any overlay files present in the topic directory.
+   Rehydration order: STATUS.md, then LEARNINGS.md (last 20 entries),
+   then README.md for topic context.
 2. **Before context gets large**: proactively flush current progress to
    STATUS.md using the standard file write tool (update "Last done (UTC)"
    and "Next actions (now)"). Do NOT route this through /tm — write directly.
 3. **When you notice a topic has no persistent memory**: suggest `/tm init`.
 4. **When you discover something unexpected** (a mistake, workaround, or
    constraint): prepend a dated entry to LEARNINGS.md in the topic folder.
-5. **When the user shares important project information** that would be needed
-   after a session reset, persist it immediately to the appropriate topic file.
-   Don't wait for the user to ask — this is the first context lost on reset.
+5. **When you see a fresh topic** (STATUS.md says "Waiting for first instructions"
+   or README.md has unfilled context sections like `_Describe what this topic is about._`),
+   proactively ask the user 2-3 questions about what this topic is about, what the
+   goal is, and where the key resources are. Persist answers to README.md immediately.
+6. **When the user shares important project information** that would be needed
+   after a session reset, persist it immediately to the appropriate section
+   in README.md. Don't wait for the user to ask — this is the first context
+   lost on reset.
 
    Examples by topic type:
    - **Coding**: repository paths, runtime/data paths, branch names, service URLs,
-     environment details → LINKS.md, DEPLOY.md, ARCHITECTURE.md
+     environment details, build/test/deploy commands → README.md sections
+     (Architecture, Deployment, Commands, Key resources)
    - **Research**: key sources, data locations, API endpoints, methodology decisions
-     → SOURCES.md, LINKS.md, FINDINGS.md
+     → README.md sections (Sources, Findings, Key resources)
    - **Marketing**: campaign URLs, analytics dashboards, social accounts, brand
-     guidelines location → CAMPAIGNS.md, LINKS.md, METRICS.md
+     guidelines location → README.md sections (Campaigns, Metrics, Key resources)
    - **General / any type**: reference URLs, contacts, key decisions, file paths
-     → LINKS.md, NOTES.md
+     → README.md sections (Key resources)
 
    Rule of thumb: if losing this information would cause the agent to make a
    wrong assumption after reset, it must be written down now.