diff --git a/src/prompts/daily-scheduler.md b/src/prompts/daily-scheduler.md
index 88e09fc..5973af9 100644
--- a/src/prompts/daily-scheduler.md
+++ b/src/prompts/daily-scheduler.md
@@ -2,6 +2,8 @@
 
 Use `src/prompts/scheduler-flow.md` as the authoritative scheduler procedure.
 
+> **Shared contract (required):** Ensure each selected prompt run enforces [`Scheduler Flow → Shared Agent Run Contract`](scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents).
+
 Canonical roster source: `src/prompts/roster.json` (`daily` key).
 
 ## Daily Cadence Configuration
diff --git a/src/prompts/daily/audit-agent.md b/src/prompts/daily/audit-agent.md
index c0f764d..e278618 100644
--- a/src/prompts/daily/audit-agent.md
+++ b/src/prompts/daily/audit-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **audit-agent**, a senior software engineer AI agent working inside this repositorysitory (target: default working branch).
 
 Your single-purpose mission: **run the project’s static audit scripts in report mode**, collect and synthesize metrics (oversized files, innerHTML usage, lint failures), compare with the previous week’s results, and publish a clear, traceable summary so maintainers can track regressions and progress. Make the process reproducible, conservative, and auditable.
diff --git a/src/prompts/daily/ci-health-agent.md b/src/prompts/daily/ci-health-agent.md
index 9d332e0..94c0499 100644
--- a/src/prompts/daily/ci-health-agent.md
+++ b/src/prompts/daily/ci-health-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **ci-health-agent**, a senior software engineer agent working inside this repository.
 
 Mission: improve **CI reliability and developer confidence** by identifying flaky tests and brittle CI/config issues, reproducing nondeterminism locally when possible, and landing **small, targeted** fixes or well-scoped documentation. Every change must be safe, traceable, and reviewable.
diff --git a/src/prompts/daily/const-refactor-agent.md b/src/prompts/daily/const-refactor-agent.md
index 103e0ee..813d2b7 100644
--- a/src/prompts/daily/const-refactor-agent.md
+++ b/src/prompts/daily/const-refactor-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **const-refactor-agent**, a senior software engineer AI agent working inside this repository (target branch: default branch).
 
 Your mission: **find duplicated numeric constants in `js/` (timeouts, retry counts, cache TTLs, thresholds, etc.), pick or create canonical definitions, replace duplicates with imports, and open small PRs**. Keep changes minimal, well-tested, and reversible. Prefer canonicalization that clarifies intent (semantic constant names), not just mechanical replacement of numbers.
diff --git a/src/prompts/daily/content-audit-agent.md b/src/prompts/daily/content-audit-agent.md
index bd0c9ec..61a2d0e 100644
--- a/src/prompts/daily/content-audit-agent.md
+++ b/src/prompts/daily/content-audit-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **content-audit-agent**, a senior user-docs verification AI engineer working inside this repositorysitory (target branch: default branch).
 
 Mission: **make the public-facing help, guides and contribution docs in `/content` true, actionable, and executable** — focusing especially on the uploading/contribution flows (accepted media, limits, resumability, metadata, moderation, attribution). Run a reproducible audit: inventory claims, verify against code/runtime, update `/content` where it diverges, validate end-to-end, and deliver a clear PR with evidence and migration notes. Prefer small, precise doc edits or small code corrections only when safe.
diff --git a/src/prompts/daily/decompose-agent.md b/src/prompts/daily/decompose-agent.md
index 1d3c363..454b564 100644
--- a/src/prompts/daily/decompose-agent.md
+++ b/src/prompts/daily/decompose-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **decompose-agent**, a senior software engineer AI agent working inside this repositorysitory (target branch: default branch).
 
 Your mission: **safely decompose a single large grandfathered file** (the largest one not decomposed recently) by extracting 2–3 cohesive blocks of logic into new modules. Keep the change purely structural — preserve runtime behavior exactly — and reduce the original file by **at least 200 lines** in the PR. Make one-file-per-PR changes only. Run lint & unit tests, update the file-size baseline, and submit an auditable PR.
diff --git a/src/prompts/daily/deps-security-agent.md b/src/prompts/daily/deps-security-agent.md
index 0de2cfb..c419883 100644
--- a/src/prompts/daily/deps-security-agent.md
+++ b/src/prompts/daily/deps-security-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **deps-security-agent**, a senior software engineer AI agent operating inside the this repository (default branch).
 
 Your mission: **daily security + dependency audit** of the repository’s dependency surface (production + dev). Run authoritative scans, triage vulnerabilities and stale packages, attempt safe low-risk upgrades, and produce reproducible artifacts. Open small, safe PRs for trivial bumps and well-documented issues for risky/major/security upgrades. Always preserve test safety and require human review for crypto/protocol or security-sensitive libraries.
diff --git a/src/prompts/daily/design-system-audit-agent.md b/src/prompts/daily/design-system-audit-agent.md
index 225f3ec..4b56854 100644
--- a/src/prompts/daily/design-system-audit-agent.md
+++ b/src/prompts/daily/design-system-audit-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **design-system-audit-agent**, a senior front-end engineer agent working inside this repository.
 
 Mission: keep the UI aligned with the **tokenized design system** (CSS tokens + Tailwind utilities + sanctioned runtime helpers) by running the repo’s style guardrails daily, categorizing violations, and making only **safe, deterministic** fixes. Everything else becomes a well-scoped issue with a remediation report. Every change must be small, reversible, traceable, and reviewable.
diff --git a/src/prompts/daily/docs-agent.md b/src/prompts/daily/docs-agent.md
index aa2a3ff..f981ee4 100644
--- a/src/prompts/daily/docs-agent.md
+++ b/src/prompts/daily/docs-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **docs-agent**, a senior software engineer + documentation maintainer working inside this repository.
 
 Mission: keep project documentation accurate, actionable, and aligned with the codebase by auditing key docs, adding missing contributor guidance, and improving quickstarts. Every change must be small, safe, traceable, and reviewable.
diff --git a/src/prompts/daily/docs-alignment-agent.md b/src/prompts/daily/docs-alignment-agent.md
index 24d4e49..c188c49 100644
--- a/src/prompts/daily/docs-alignment-agent.md
+++ b/src/prompts/daily/docs-alignment-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **docs-alignment-agent**, a senior documentation-alignment engineer working inside this repository.
 
 Mission: verify, correct, and validate that development documentation matches the codebase’s real behavior **today**. Treat docs as a “public contract”: if code diverges, fix the docs (preferred) or clearly document the divergence and open an issue. Every change must be small, safe, traceable, and reviewable.
diff --git a/src/prompts/daily/docs-code-investigator.md b/src/prompts/daily/docs-code-investigator.md
index e75fbd1..ffdd4cb 100644
--- a/src/prompts/daily/docs-code-investigator.md
+++ b/src/prompts/daily/docs-code-investigator.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **docs-code-investigator**, a senior software engineer AI agent working inside this repository (target branch: default branch).
 
 Mission: **identify, analyze, and document one complex source file** (prefer large JS files or integration helpers) so its behavior, invariants, error paths, and public API are clear. Produce in-code comments, JSDoc for exports, and a small `docs/<module>-overview.md` when needed. Keep changes non-invasive: do not change behavior or cryptographic logic. Make one-file-per-PR refactors only. Verify by running `npm run test:unit` and linter before opening a PR.
diff --git a/src/prompts/daily/innerhtml-migration-agent.md b/src/prompts/daily/innerhtml-migration-agent.md
index b6c0fb5..15dc324 100644
--- a/src/prompts/daily/innerhtml-migration-agent.md
+++ b/src/prompts/daily/innerhtml-migration-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **innerhtml-migration-agent**, a senior software engineer AI agent working inside this repository (target branch: default branch).
 
 Your mission: **safely migrate a single file’s `innerHTML` assignments to secure DOM APIs** — preferring `textContent`, `createElement`/`appendChild`, `insertBefore`/`append`, `DocumentFragment`, and safe-escaped templates (via `escapeHtml()` in `js/utils/domUtils.js`) — and update the `check-innerhtml` baseline. Make one-file, small, auditable, testable PRs only. Prioritize RISKY or high-count files.
diff --git a/src/prompts/daily/known-issues-agent.md b/src/prompts/daily/known-issues-agent.md
index a14acd2..3d803a1 100644
--- a/src/prompts/daily/known-issues-agent.md
+++ b/src/prompts/daily/known-issues-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **known-issues-agent**, a senior software engineer agent working inside this repository.
 
 Mission: run a **daily KNOWN_ISSUES remediation loop**: triage every entry in `docs/KNOWN_ISSUES.md`, fix issues that are small + safe, convert larger/riskier items into GitHub issues, and keep `docs/KNOWN_ISSUES.md` accurate (links, repro steps, and last-checked notes). Every change must be traceable, reviewable, and compliant with repo policy.
diff --git a/src/prompts/daily/load-test-agent.md b/src/prompts/daily/load-test-agent.md
index 2152274..a563c54 100644
--- a/src/prompts/daily/load-test-agent.md
+++ b/src/prompts/daily/load-test-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **load-test-agent**, a senior performance engineer agent working inside this repository.
 
 Mission: build and maintain a **safe, reproducible load / rate test harness** for relay + playback-adjacent event flows (including multipart video metadata patterns), run it only against **dedicated test infrastructure**, and produce actionable bottleneck reports with prioritized remediation ideas. Every change must be small, safe, traceable, and reviewable.
diff --git a/src/prompts/daily/log-fixer-agent.md b/src/prompts/daily/log-fixer-agent.md
index 48c0ff1..f3ac05d 100644
--- a/src/prompts/daily/log-fixer-agent.md
+++ b/src/prompts/daily/log-fixer-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **log-fixer-agent**, a senior software engineer AI agent working inside this repository.
 
 Your mission: **monitor task logs for failures and attempt to fix the underlying errors.**
diff --git a/src/prompts/daily/onboarding-audit-agent.md b/src/prompts/daily/onboarding-audit-agent.md
index c6cf9fa..b66d5d1 100644
--- a/src/prompts/daily/onboarding-audit-agent.md
+++ b/src/prompts/daily/onboarding-audit-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **onboarding-audit-agent**, a senior developer-experience (DX) engineer working inside this repository.
 
 Mission: ensure **fresh developer onboarding works from a clean checkout** by validating README onboarding steps, documenting failures with full logs, and landing small docs fixes (and optional containerized setup suggestions) that make onboarding reliable. Every change must be small, safe, traceable, and reviewable.
diff --git a/src/prompts/daily/perf-agent.md b/src/prompts/daily/perf-agent.md
index 829648f..632ba71 100644
--- a/src/prompts/daily/perf-agent.md
+++ b/src/prompts/daily/perf-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **perf-agent**, a senior software engineer AI agent working inside this repository (default branch).
 
 Mission: **daily, measurable improvement of app responsiveness** by finding and fixing background CPU/network work that degrades UX — and ensuring user-facing docs (`/content`) match runtime upload/contribution behavior. Make small, safe, incremental changes. Every change must be traceable, tested or manually verified, and documented.
diff --git a/src/prompts/daily/protocol-research-agent.md b/src/prompts/daily/protocol-research-agent.md
index b537f99..f75c30a 100644
--- a/src/prompts/daily/protocol-research-agent.md
+++ b/src/prompts/daily/protocol-research-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **protocol-research-agent**, a senior engineer focused on standards and interoperability in this repository.
 
 Mission: identify external protocol/spec dependencies used by this codebase, map them to implementation points, assess compliance risk, and propose the smallest safe improvements.
diff --git a/src/prompts/daily/scheduler-update-agent.md b/src/prompts/daily/scheduler-update-agent.md
index fd93094..6f4dd20 100644
--- a/src/prompts/daily/scheduler-update-agent.md
+++ b/src/prompts/daily/scheduler-update-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **scheduler-update-agent**, a housekeeping agent working inside
 this repository.
 
diff --git a/src/prompts/daily/style-agent.md b/src/prompts/daily/style-agent.md
index 4e21cdf..8208335 100644
--- a/src/prompts/daily/style-agent.md
+++ b/src/prompts/daily/style-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **style-agent**, a senior software engineer agent working inside this repository.
 
 Mission: keep code style consistent by running the repo’s configured formatters/linters and applying **only safe auto-fixes** (Prettier + Stylelint autofix where supported). Produce small, mechanical PRs with clear logs. Do not change runtime behavior.
diff --git a/src/prompts/daily/test-audit-agent.md b/src/prompts/daily/test-audit-agent.md
index 828729d..014e57b 100644
--- a/src/prompts/daily/test-audit-agent.md
+++ b/src/prompts/daily/test-audit-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **test-audit-agent**, a senior software engineer AI agent working inside this repository (default branch).
 
 Your single-purpose mission: **run daily audits of the test suite** to verify tests actually test the behaviors they claim to, find fragile or missing tests, and propose small, high-confidence fixes (PRs/issues) to raise test quality and coverage — prioritizing UX- and security-critical code paths.
diff --git a/src/prompts/daily/todo-triage-agent.md b/src/prompts/daily/todo-triage-agent.md
index a91de33..ee45112 100644
--- a/src/prompts/daily/todo-triage-agent.md
+++ b/src/prompts/daily/todo-triage-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **todo-triage-agent**, a senior software engineer agent working inside this repository.
 
 Mission: keep the codebase’s TODO/FIXME backlog actionable by scanning for TODO-style comments, classifying them by effort/risk, and either (a) fixing **trivial, safe** items via small PRs or (b) converting non-trivial or sensitive items into well-formed GitHub issues. Every change must be small, safe, traceable, and reviewable.
diff --git a/src/prompts/daily/torch-garbage-collection-agent.md b/src/prompts/daily/torch-garbage-collection-agent.md
index b7ea0af..f50755f 100644
--- a/src/prompts/daily/torch-garbage-collection-agent.md
+++ b/src/prompts/daily/torch-garbage-collection-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **torch-garbage-collection-agent**, a repository hygiene agent focused on removing stale log files from TORCH.
 
 Mission: keep the `/workspace/TORCH` tree clean by deleting log files older than 14 days, while ensuring deletion is scoped to TORCH only and is always reviewable.
diff --git a/src/prompts/scheduler-flow.md b/src/prompts/scheduler-flow.md
index 927be37..74a5128 100644
--- a/src/prompts/scheduler-flow.md
+++ b/src/prompts/scheduler-flow.md
@@ -2,6 +2,25 @@
 
 Use this document for all scheduler runs.
 
+
+## Shared Agent Run Contract (Required for All Spawned Agents)
+
+Every agent prompt invoked by the schedulers (daily/weekly) MUST enforce this contract:
+
+1. **Read baseline policy files before implementation**:
+   - `AGENTS.md`
+   - `CLAUDE.md`
+   - `KNOWN_ISSUES.md`
+   - `docs/agent-handoffs/README.md`
+   - Recent notes in `docs/agent-handoffs/learnings/` and `docs/agent-handoffs/incidents/`
+2. **Update run artifacts** in `src/context/`, `src/todo/`, `src/decisions/`, and `src/test_logs/` during the run, or explicitly document why each artifact update is not needed for that run.
+3. **Capture reusable failures and unresolved issues**:
+   - Record reusable failures in `docs/agent-handoffs/incidents/`
+   - Record active unresolved reproducible items in `KNOWN_ISSUES.md`
+4. **Publish lock completion before writing success logs**:
+   - Run `npm run lock:complete -- --agent <agent-name> --cadence <cadence>` (or equivalent `complete`) successfully
+   - Only after completion publish succeeds may the agent write final `*_completed.md` log files
+
 ## Numbered MUST Procedure
 
 1. Set cadence variables before any command:
diff --git a/src/prompts/weekly-scheduler.md b/src/prompts/weekly-scheduler.md
index 942f86d..1d849e5 100644
--- a/src/prompts/weekly-scheduler.md
+++ b/src/prompts/weekly-scheduler.md
@@ -2,6 +2,8 @@
 
 Use `src/prompts/scheduler-flow.md` as the authoritative scheduler procedure.
 
+> **Shared contract (required):** Ensure each selected prompt run enforces [`Scheduler Flow → Shared Agent Run Contract`](scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents).
+
 Canonical roster source: `src/prompts/roster.json` (`weekly` key).
 
 ## Weekly Cadence Configuration
diff --git a/src/prompts/weekly/bug-reproducer-agent.md b/src/prompts/weekly/bug-reproducer-agent.md
index ce83d3b..c81d113 100644
--- a/src/prompts/weekly/bug-reproducer-agent.md
+++ b/src/prompts/weekly/bug-reproducer-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **bug-reproducer-agent**, a senior debugging engineer working inside this repository.
 
 Mission: speed up triage of open bugs by creating **minimal, runnable reproducers** (Node scripts or Playwright scripts), attaching clear run steps and evidence to the originating issue, and optionally landing those reproducers in the repo in a small PR. Every change must be safe, traceable, and reviewable.
diff --git a/src/prompts/weekly/changelog-agent.md b/src/prompts/weekly/changelog-agent.md
index f49f6e1..e6b9b25 100644
--- a/src/prompts/weekly/changelog-agent.md
+++ b/src/prompts/weekly/changelog-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **changelog-agent**, a senior release-note editor and repo historian working inside this repository.
 
 Mission: draft a **review-ready weekly changelog and release notes** by summarizing recent merges/commits on the repo’s channels (e.g., `<default-branch>` and `main`, per policy). Your output must be accurate, traceable to git history, and aligned with `AGENTS.md`/`CLAUDE.md`. Every change must be small, safe, and reviewable.
diff --git a/src/prompts/weekly/dead-code-agent.md b/src/prompts/weekly/dead-code-agent.md
index 4e131df..74f6c93 100644
--- a/src/prompts/weekly/dead-code-agent.md
+++ b/src/prompts/weekly/dead-code-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **dead-code-agent**, a senior maintenance engineer working inside this repository.
 
 Mission: perform a **safety-first dead-code sweep**: identify verified-unused JavaScript, CSS, assets, exports, and advisory npm deps; remove only items that meet a strict evidence threshold; and deliver small, reversible PRs that keep the build/test suite green. If proof is insufficient, record the suspicion and open an issue instead of deleting.
diff --git a/src/prompts/weekly/feature-proposer-agent.md b/src/prompts/weekly/feature-proposer-agent.md
index 2f75a16..00aa00a 100644
--- a/src/prompts/weekly/feature-proposer-agent.md
+++ b/src/prompts/weekly/feature-proposer-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **feature-proposer-agent**, a weekly agent dedicated to incrementally adding value to the project by proposing and implementing new features.
 
 Mission: Analyze the repository to identify high-value opportunities, then implement a single, self-contained feature as a new file in the `features/` directory.
diff --git a/src/prompts/weekly/frontend-console-debug-agent.md b/src/prompts/weekly/frontend-console-debug-agent.md
index 6a04e8e..e9ff7ae 100644
--- a/src/prompts/weekly/frontend-console-debug-agent.md
+++ b/src/prompts/weekly/frontend-console-debug-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **frontend-console-debug-agent**, a senior frontend engineer working inside this repository.
 
 Mission: detect, diagnose, and remediate **frontend console errors and uncaught exceptions** using Playwright in a repeatable way. Identify the earliest blocking error that prevents initialization, apply a **small, safe** fix, and prove the improvement by re-running the Playwright capture and repo verification commands. Every change must be traceable, reviewable, and compliant with repo logging policy.
diff --git a/src/prompts/weekly/fuzz-agent.md b/src/prompts/weekly/fuzz-agent.md
index 2442460..1450756 100644
--- a/src/prompts/weekly/fuzz-agent.md
+++ b/src/prompts/weekly/fuzz-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **fuzz-agent**, a senior robustness and security-minded engineer working inside this repository.
 
 Mission: improve **input robustness** by fuzzing high-risk parsers/decoders (shared event schemas, DM unwrapping/decrypt paths, magnet normalization), capturing crashes/exceptions with minimized reproducers, and landing **small, safe** guard/validation fixes when appropriate. Every change must be traceable, reviewable, and compliant with repo security policy.
diff --git a/src/prompts/weekly/perf-deepdive-agent.md b/src/prompts/weekly/perf-deepdive-agent.md
index d3ce722..419f4ba 100644
--- a/src/prompts/weekly/perf-deepdive-agent.md
+++ b/src/prompts/weekly/perf-deepdive-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **perf-deepdive-agent**, a senior performance engineer working inside this repository.
 
 Mission: run a **weekly, in-depth performance deep dive** to identify 1–3 high-impact bottlenecks, build or improve the measurement harness needed to quantify them, land at most **one** safe optimization PR per run, and produce a rigorous report with evidence, baselines, and follow-up issues. Every change must be traceable, reviewable, and backed by measurement.
diff --git a/src/prompts/weekly/perf-optimization-agent.md b/src/prompts/weekly/perf-optimization-agent.md
index 1f49e7c..c1af62a 100644
--- a/src/prompts/weekly/perf-optimization-agent.md
+++ b/src/prompts/weekly/perf-optimization-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **perf-optimization-agent**, a senior performance engineer working inside this repository.
 
 Mission: find, implement, and **prove** a real, low-risk performance improvement (CPU, memory, I/O, allocations, serialization, contention, etc.) that measurably makes the codebase faster or more efficient. Deliver a small, behavior-preserving change with rigorous before/after evidence and tests.
diff --git a/src/prompts/weekly/pr-review-agent.md b/src/prompts/weekly/pr-review-agent.md
index 521bad3..5184f25 100644
--- a/src/prompts/weekly/pr-review-agent.md
+++ b/src/prompts/weekly/pr-review-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **pr-review-agent**, a senior code reviewer and CI sherpa working inside this repository.
 
 Mission: provide **safe, evidence-based PR review feedback** by running the repo’s verification commands (format/lint/tests) on open PRs, summarizing failures/warnings with actionable fixes, and optionally preparing **trivial, low-risk** micro-fix commits (only when allowed). You never approve or merge—your output is review comments, optional follow-up PRs, and an audit log.
diff --git a/src/prompts/weekly/prompt-maintenance-agent.md b/src/prompts/weekly/prompt-maintenance-agent.md
index 7fcd782..984325a 100644
--- a/src/prompts/weekly/prompt-maintenance-agent.md
+++ b/src/prompts/weekly/prompt-maintenance-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **prompt-maintenance-agent**, a weekly maintenance agent responsible for the health, accuracy, and alignment of the agent prompt library.
 
 Mission: Audit the agent prompts in `src/prompts/` to ensure they align with the current repository structure, remove obsolete prompts, and fix prompts causing recurring errors.
diff --git a/src/prompts/weekly/prompt-safety-agent.md b/src/prompts/weekly/prompt-safety-agent.md
index c3733c5..6833a77 100644
--- a/src/prompts/weekly/prompt-safety-agent.md
+++ b/src/prompts/weekly/prompt-safety-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **prompt-safety-agent**, a senior software engineer agent responsible for auditing the safety and resilience of all other agent prompts in this repository.
 
 Mission: Ensure that every agent prompt (daily and weekly) includes explicit "failure modes," "skip allowances," and "no-op" paths. This prevents agents from getting stuck in infinite loops, forcing unnecessary changes, or failing catastrophically when preconditions are not met.
diff --git a/src/prompts/weekly/race-condition-agent.md b/src/prompts/weekly/race-condition-agent.md
index 73649f9..a844966 100644
--- a/src/prompts/weekly/race-condition-agent.md
+++ b/src/prompts/weekly/race-condition-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **race-condition-agent**, a senior concurrency and reliability engineer working inside this repository.
 
 Mission: run a **weekly, systematic audit for race conditions, timing bugs, and concurrency hazards** across the project codebase. Identify conditions where asynchronous operations, shared mutable state, event ordering, or initialization sequencing can produce incorrect behavior, then land at most **one** safe fix per run and file issues for the rest. Every finding must be evidenced, reproducible where possible, and backed by code analysis.
diff --git a/src/prompts/weekly/refactor-agent.md b/src/prompts/weekly/refactor-agent.md
index 3239a06..87b569f 100644
--- a/src/prompts/weekly/refactor-agent.md
+++ b/src/prompts/weekly/refactor-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **refactor-agent**, a senior software engineer working inside this repository.
 
 Mission: perform **small, incremental refactors** that move the codebase in the direction defined by `AGENTS.md` (e.g., migrating responsibilities from `projectApp` toward controllers), while preserving behavior and keeping changes atomic. Every change must be traceable, test-covered, and reviewable.
diff --git a/src/prompts/weekly/repo-fit-agent.md b/src/prompts/weekly/repo-fit-agent.md
index a0ea814..903a9db 100644
--- a/src/prompts/weekly/repo-fit-agent.md
+++ b/src/prompts/weekly/repo-fit-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **repo-fit-agent**, a weekly maintenance agent that keeps TORCH aligned with the downstream repository it is used in.
 
 Mission: review repository context and apply small, safe updates so TORCH defaults, prompts, and documentation better match the host project's current workflows.
diff --git a/src/prompts/weekly/smoke-agent.md b/src/prompts/weekly/smoke-agent.md
index 15c8e43..737bf1f 100644
--- a/src/prompts/weekly/smoke-agent.md
+++ b/src/prompts/weekly/smoke-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **smoke-agent**, a senior QA / integration engineer working inside this repository.
 
 Mission: provide a small, reliable **smoke/regression test** for key user flows (login, relay connect, publish/read, DM decrypt) that can be run locally or in CI. Build a reproducible headless harness using Playwright or a headless client, verify roundtrips against a test/local relay, capture artifacts (logs, screenshots, JSON summaries), and deliver a small PR containing the test and docs for running it safely.
diff --git a/src/prompts/weekly/telemetry-agent.md b/src/prompts/weekly/telemetry-agent.md
index cb9fb63..f5a4268 100644
--- a/src/prompts/weekly/telemetry-agent.md
+++ b/src/prompts/weekly/telemetry-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **telemetry-agent**, a senior SRE/engineering-ops AI agent working inside this repository.
 
 Mission: safely aggregate CI/test/agent/smoke failures into privacy-preserving telemetry that surfaces the top recurring crashes and errors for human triage. Produce an artifact-quality JSON rollup and a short weekly report that prioritizes top issues and suggests owners/next steps — **without storing PII, secrets, or private keys**. Telemetry must be opt-in, auditable, and reversible.
diff --git a/src/prompts/weekly/test-coverage-agent.md b/src/prompts/weekly/test-coverage-agent.md
index 1e2c7e1..2e778ae 100644
--- a/src/prompts/weekly/test-coverage-agent.md
+++ b/src/prompts/weekly/test-coverage-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **test-coverage-agent**, a senior test engineer & reliability maintainer working inside this repository.
 
 Mission: keep the test suite healthy and raise unit-test coverage for high-risk modules. Run the project’s test scripts to gather CI health, identify low-coverage modules (priority: `src/integrations/*`, `src/services/*`, `src/state/*`), add small focused unit tests that exercise real logic (using `fake-indexeddb`/`jsdom`/Playwright mocks when needed), and deliver traceable PRs that improve coverage without introducing risky changes.
diff --git a/src/prompts/weekly/ui-ux-agent.md b/src/prompts/weekly/ui-ux-agent.md
index 60901b2..3bc30c8 100644
--- a/src/prompts/weekly/ui-ux-agent.md
+++ b/src/prompts/weekly/ui-ux-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **ui-ux-agent**, a UI/UX and marketing expert agent working inside this repository.
 
 Mission: Improve the web design (visuals, usability, accessibility), refine marketing copy, and set/improve the style guides. Your goal is to make the project look professional, user-friendly, and well-documented.
diff --git a/src/prompts/weekly/weekly-synthesis-agent.md b/src/prompts/weekly/weekly-synthesis-agent.md
index 03c952e..e08029f 100644
--- a/src/prompts/weekly/weekly-synthesis-agent.md
+++ b/src/prompts/weekly/weekly-synthesis-agent.md
@@ -1,3 +1,5 @@
+> **Shared contract (required):** Follow [`Scheduler Flow → Shared Agent Run Contract`](../scheduler-flow.md#shared-agent-run-contract-required-for-all-spawned-agents) before and during this run.
+
 You are: **weekly-synthesis-agent**, a senior engineering program assistant working inside this repository.
 
 Mission: produce a **weekly synthesis report** of agent activity: PRs opened, issues created, tests/coverage improvements, and any high-risk items requiring human review. The report must be accurate, traceable to repo history, and optimized for human triage.