From 8835bcb49bb70c999d68f6941f7837cc4137e8b1 Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 19:17:35 -0700
Subject: [PATCH 1/4] style(seo): restyle guide pages and guides index to the
 v2 landing (TASK-594)

CSS only, scoped to the #seo-page blocks whose header links Agent
collaboration (guide pages and the guides index). Compare and use-case
pages keep their existing rules. Markup is unchanged.

Adds a byte-level test: every generated page's markup, with <style>
removed, must hash to the value taken from main's generator and template.

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: Polish <WyJwb2xpc2giLCJkZWZhdWx0Il0@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/index.html                           |  74 +++++++++++++
 .../fixtures/seo-markup-main.sha256.json      | 101 ++++++++++++++++++
 frontend/scripts/generate-seo-pages.test.mjs  |  29 +++++
 3 files changed, 204 insertions(+)
 create mode 100644 frontend/scripts/fixtures/seo-markup-main.sha256.json

diff --git a/frontend/index.html b/frontend/index.html
index 211f39b542..33b1f94283 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -88,6 +88,80 @@
       #seo-page .seo-note { color: #7b8494; font-size: .875rem; }
       #seo-page .seo-footer { padding: 40px 0; color: #7b8494; border-top: 1px solid #e5e7eb; }
       @media (max-width: 640px) { #seo-page .seo-header { align-items: flex-start; flex-direction: column; padding: 20px 0; } #seo-page section { padding: 44px 0; } #seo-page .seo-hero { padding-top: 56px; padding-bottom: 56px; } }
+      /* TASK-594 (D156): guide pages and the guides index take the landing's type,
+         colour and measure. Scoped to the pages whose header links Agent
+         collaboration, so compare and use-case pages keep the rules above. Tokens
+         are declared here because .v2-root does not reach the prerender. Values
+         mirror v2.css and landing/v2-landing.css. */
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) {
+        --v2-font: "IBM Plex Sans", "SF Pro Text", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+        --v2-font-display: "Bricolage Grotesque Variable", "Bricolage Grotesque", "Helvetica Neue", Arial, sans-serif;
+        --v2-font-mono: "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+        --v2-ink: #101828;
+        --v2-text-secondary: #475467;
+        --v2-text-tertiary: #667085;
+        --v2-border: #d0d5dd;
+        --v2-border-soft: #e4e7ec;
+        --v2-surface-tint: #f2f4f7;
+        --v2-accent: #1d3fd1;
+        --v2-accent-strong: #1633a8;
+        --v2-accent-deep: #0f2378;
+        --v2-accent-soft: #e9edfb;
+        --v2-radius: 4px;
+        background: #ffffff;
+        color: var(--v2-ink);
+        font: 16px/26px var(--v2-font);
+      }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-header,
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) main,
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-footer {
+        width: 100%;
+        margin: 0;
+        padding-right: max(24px, calc((100% - 1312px) / 2));
+        padding-left: max(24px, calc((100% - 1312px) / 2));
+      }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-header { min-height: 72px; gap: 24px; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-header nav { gap: 28px; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-header nav a { color: var(--v2-text-secondary); font-size: 15px; font-weight: 500; text-decoration: none; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-header nav a:hover { color: var(--v2-ink); }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-brand { color: var(--v2-ink); font-family: var(--v2-font-display); font-size: 24px; font-weight: 800; letter-spacing: -.03em; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) section { padding: 56px 0; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-hero { padding-top: 96px; padding-bottom: 72px; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) h1,
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) h2,
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) h3 { color: var(--v2-ink); font-family: var(--v2-font-display); letter-spacing: -.03em; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) h1 { max-width: 920px; margin: 0 0 24px; font-size: clamp(44px, 7vw, 84px); line-height: 1; font-weight: 850; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) h2 { max-width: 760px; margin: 0 0 20px; font-size: 44px; line-height: 48px; font-weight: 800; text-wrap: balance; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) h3 { margin: 0 0 12px; font-size: 24px; line-height: 30px; font-weight: 800; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) p,
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) li { color: var(--v2-text-secondary); font-size: 16px; line-height: 26px; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) p { max-width: 720px; margin: 0 0 16px; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-lede { max-width: 720px; font-size: 20px; line-height: 32px; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-byline { font-size: 13px; line-height: 20px; color: var(--v2-text-tertiary); }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-kicker { margin-bottom: 12px; color: var(--v2-accent); font-family: var(--v2-font-mono); font-size: 12px; font-weight: 500; line-height: 20px; letter-spacing: .06em; text-transform: uppercase; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-actions { gap: 12px; margin-top: 32px; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-primary { display: inline-flex; align-items: center; height: 44px; padding: 0 22px; border-radius: var(--v2-radius); background: var(--v2-accent); color: #ffffff; font-size: 15px; font-weight: 600; text-decoration: none; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-primary:hover { background: var(--v2-accent-strong); color: #ffffff; }
+      /* Full-bleed band on the same 1312 measure as the header and footer. */
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-band { width: 100cqw; max-width: none; margin-left: calc((100cqw - min(1312px, calc(100cqw - 48px))) / -2); padding-right: max(24px, calc((100cqw - 1312px) / 2)); padding-left: max(24px, calc((100cqw - 1312px) / 2)); color: var(--v2-accent-deep); background: var(--v2-accent-soft); }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-band h2,
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-band p { color: var(--v2-accent-deep); }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-grid { gap: 12px; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-card { padding: 24px; border: 1px solid var(--v2-border); border-radius: var(--v2-radius); background: #ffffff; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-code { margin: 20px 0; padding: 16px; border: 0; border-radius: var(--v2-radius); color: #ffffff; background: var(--v2-ink); }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-table-wrap { border: 1px solid var(--v2-border-soft); border-radius: var(--v2-radius); }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-table th,
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-table td { border-color: var(--v2-border-soft); }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-table th { background: var(--v2-surface-tint); }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-footer { padding-top: 48px; padding-bottom: 40px; border-top: 1px solid var(--v2-border-soft); color: var(--v2-text-tertiary); font-size: 13px; line-height: 20px; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-note { color: var(--v2-text-tertiary); font-size: 13px; line-height: 20px; }
+      @media (max-width: 640px) {
+        #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-header { padding-top: 20px; padding-bottom: 20px; }
+        #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) section { padding: 44px 0; }
+        #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-hero { padding-top: 56px; padding-bottom: 48px; }
+        #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) h2 { font-size: 32px; line-height: 38px; }
+        #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-lede { font-size: 18px; line-height: 28px; }
+      }
     </style>
     <!-- SEO_NAVIGATION_RUNTIME_START -->
     <script>
diff --git a/frontend/scripts/fixtures/seo-markup-main.sha256.json b/frontend/scripts/fixtures/seo-markup-main.sha256.json
new file mode 100644
index 0000000000..11431d9f35
--- /dev/null
+++ b/frontend/scripts/fixtures/seo-markup-main.sha256.json
@@ -0,0 +1,101 @@
+{
+  "index.html": "2459ff5409d46e04904a2d38230507e492667e353cc7b583e42a5a76ad040d40",
+  "compare/index.html": "1437cd163b2e06458ef812804a1cc08681e85e5142f276add6bd16cf5a441605",
+  "use-cases/team-chat/index.html": "2beaead9eba522625fa933209b24d02b3cc9f86959529310e7fdbd1ca1684eb9",
+  "use-cases/agent-collab/index.html": "0529724f5c388a902cb4b0a877e21fe5abcb3e8fce3a46a79a9f6444ca44e2c7",
+  "use-cases/research-desk/index.html": "c66de2cec2eca775b18ac0863c664452962d320234ed3f9f6dcbfeee9057464a",
+  "use-cases/daily-digest/index.html": "99faa3459649f7502f32d04264a108f94b87a1b1d84d73ac5ad59144627db996",
+  "use-cases/community/index.html": "f274d5b1a4417aaabc682fe996a15b79f7c036c893c9642e685fa37a1b155409",
+  "use-cases/pod-browser/index.html": "29a037809d148e79578f3b7fc58ffb84fb2af03f535fd7b30f42b15d83e0ba22",
+  "use-cases/app-marketplace/index.html": "31116530e51343fd50827a78e17842afb27f16a84244515a0834898fca0820e6",
+  "guides/index.html": "bc7431e80bc295bfd4f7fb30f41c7d63da660e09b5fae4a6ef9ab425bf70b2a8",
+  "guides/multi-agent-collaboration-platform/index.html": "866637869d211f1433fe70ee4402c5ff9e9d110e647ad9d36d5a573024b4d748",
+  "guides/ai-agent-workspace/index.html": "18f897688abb046088b090eba66fec9471a70acefa370f9d844f2e0cb48797de",
+  "guides/ai-agent-task-management/index.html": "22bee26e5810a7ee01e4fdd3b675d1433774d9a00df09f004a4aeb1ce71a0da0",
+  "guides/connect-claude-codex-shared-workspace/index.html": "dfb0943a159231e4f59c31ec649f68cce582adb5fd755ad53f0fbf09d8aa8a3c",
+  "guides/ai-agent-memory/index.html": "50548f7330ea741b8198469b558c89100fe021d303199327dcb90d0b10bfe521",
+  "guides/human-in-the-loop-ai-agents/index.html": "2b7634b0113e1e10f27d9d6d96e019c06f6b093a9e06463a4b49850ed72ed467",
+  "guides/ai-agent-handoffs/index.html": "0ad4ebcf6bc884c30a6bd3b8d11eb93234dce4dcb3d769d09237ffc8b631e38a",
+  "guides/how-to-build-an-ai-agent-team/index.html": "7f049c2b48897000fd610aa2c41e98c4f7ce969d070b1819a65f22d414d5df66",
+  "guides/agent-to-agent-messaging/index.html": "52d65bf20e3270ef7df54adb3d1e842de516902bbf892f301f65988458db9284",
+  "guides/self-hosted-ai-agent-platform/index.html": "e7e53d0a53302675889f78225bfaed5ac4f68807450273587993ac5404282f46",
+  "guides/ai-agent-permissions-and-tokens/index.html": "e7dbd3d116dfd356c0136cadebd6b2b09ab7a251a1e477872b07f2b6b583a79d",
+  "guides/connect-cursor-shared-workspace/index.html": "ae8f4572427136c6ae0ed41168bd99f0d9362a53bf0589c55d701ab777f6455d",
+  "guides/ai-agent-observability/index.html": "be1983f161d2b3b4010f5cc7c2f636a7929d02166b2e7a399339bb3c745bd9e7",
+  "guides/ai-agent-events/index.html": "99d3fea7e05203fcf418d0454edfd3efed6fa38e1ad11380b0202c99af73d446",
+  "guides/multi-agent-vs-single-agent/index.html": "933de9aa5e342a5e7ea51765e6f08d285e3fa4811d83d71ba30d9fee0a3988c4",
+  "guides/ai-agent-collaboration-patterns/index.html": "1a820ee4751f66687bbb4697392222a0d72051e03bf2bd55cddf870905f418b5",
+  "guides/onboarding-an-ai-agent-to-your-team/index.html": "d2dade7e6d6ed34dbf297e9671f93fecce66a3998f2ab0d332e5d489741be036",
+  "guides/ai-agent-discord-integration/index.html": "da0eec25437932b5d1d51e3d3d2f6bbffdfeec51c862ebad541e62c1aa4edf6b",
+  "guides/what-is-an-ai-agent-runtime/index.html": "43b3198212d569e5fa1d619a0f7a9bead9e9d63428761417b748081525cd2cad",
+  "guides/ai-agent-heartbeats-and-scheduled-work/index.html": "a24a2674e831f6bc3dab2b49b2ce6a263d0e7c3827ed1f256545d5fbee499cc5",
+  "guides/ai-agent-marketplace-roles/index.html": "96fee6b4e7807a6c58d52834e493c6030058af9ee2b711fd5034fea10c38acbd",
+  "guides/connect-a-custom-agent-http-api/index.html": "e64eead23dd74f4096319c7e90202ce694b272e68dfeb529a8e91b9c9b5cd091",
+  "guides/what-is-an-agent-pod/index.html": "29690e317a3cd1921ab0e3d89b370d03a6a59d82a5e56101b8f9f707346800ae",
+  "guides/connect-openclaw-agent/index.html": "2b586cffea690f4c93cda825f90235414684ddc58e44d11ea6c67548febe624a",
+  "guides/ai-agent-security-best-practices/index.html": "65871b797750a425a53d9627933fdad6994b7fb82714c98bfce0b9574472a7c6",
+  "guides/ai-agent-cli/index.html": "61d5393b7a78882681d32f26afa3c9977d39736b7a374c9fddd7c7cd891e6aea",
+  "guides/ai-agent-orchestration/index.html": "161b117e48e5ccf3823d5667ba589f5e277cdde4cfa542fd97cf6233dd7953ca",
+  "guides/ai-agent-skills/index.html": "b3b3a9454b8d851f1210057bf7b9e82c7fe36b7ff80dd28ba19a7899263e8aed",
+  "guides/autonomous-ai-agents/index.html": "23502098b59980e4cb782edc203f0efbf7b8bea7858b7964036515278d7bec04",
+  "guides/ai-agent-sandboxing/index.html": "f78826881fb0793312be4098722454d529a027d4a220b64bbd34017884293f05",
+  "guides/ai-agent-tools/index.html": "1df4ab762f57a5160f9768a91cc2186d080a0142cff612df4440ecdfe051f741",
+  "guides/prompt-injection-defense-for-ai-agents/index.html": "467bdf99f08beb5f41eab2f432db5dcc7eca5ba918b7234f718ccfa0eef8c574",
+  "guides/mcp-for-ai-agent-teams/index.html": "bf17c8d4053d910a59b3efdd6da1fda4c1fa651e0b6283766b666743f57a091b",
+  "guides/what-is-agentic-ai/index.html": "6d919567121d6377b611f405751ff5adfab4f021ba3a20bb14d1de9629da66be",
+  "guides/what-is-an-ai-agent/index.html": "7acb1b69f3aadb782d4d86145e4a9bd321b883cf38b2f9d7de045047a634c51a",
+  "guides/context-engineering-for-ai-agents/index.html": "7d4810e245f9f9348a31815e130c273ee3eb2836c1fdee363bcb0ba36991f188",
+  "guides/how-to-evaluate-ai-agents/index.html": "5060c2e319c2294b3d87e66c470a68e6074532d80c2d6e07a36a389d9fc9e368",
+  "guides/ai-agent-vs-chatbot/index.html": "0e2d708f4561dee8c49d97d7c4441c86ad691a44a221239f09d65e5aa119a848",
+  "guides/ai-agent-use-cases/index.html": "72efdc8d1ac657debda30dfc1828dbb75559f5d6bffdc89730fc1dfc5a8510d7",
+  "guides/human-ai-collaboration/index.html": "ac6ee3607bf37b76026756950e84c025f3d3be64b06fcc3c578a8a10d222e490",
+  "guides/agentic-workflows/index.html": "1786a7d50e945d85bec9329d1cd3fb6dc2a11d0446329e4ae1e02908279aa608",
+  "guides/ai-agents-for-project-management/index.html": "225d683d03d538d48b9cf2c99ad3c8489e1cb7ecc8dac18683803ef1aee6c0f0",
+  "guides/how-to-write-ai-agent-instructions/index.html": "fbd9b1daa8be9b51e3bc842990d6a7105b6e6740d4feb1d74b257b01c0398834",
+  "guides/ai-agents-for-research/index.html": "cbff168a721934f564bebe5a920b021e38cadfa2ec3a73cfa22508f0403f4e5f",
+  "guides/ai-agents-for-customer-support/index.html": "d3d981dd143eabac6f7eb971281230bf20ba606ae1345cb68840a992a35e29ba",
+  "guides/what-is-a-multi-agent-system/index.html": "a6b29e392c855b3998d9c315a2506b5cb5ce32384fe2b478cc29f98a70dad260",
+  "guides/ai-agent-glossary/index.html": "b3aa41a74f3450c90fe7fd600f5715cf81d5ed10fb399ad5be3838701e1fb5c4",
+  "guides/ai-agent-governance/index.html": "bf2116939b09963bb2165bd170bc4fe6ae8aa53c7f001bcea51d128cbd43f11d",
+  "guides/ai-agents-for-software-development/index.html": "6127d24beeafe30a84170110c38cb11d974e98b827fc18cdfd40f2c1c9a39360",
+  "guides/ai-agent-roles/index.html": "d27fa2aad09b4ad587f6740c22aa0d0e3b707569e0f2c2ac713f0fa350a570eb",
+  "guides/ai-agent-escalation/index.html": "6d536bb28b36efea4a395174ed9d7b6f79ede7eb7af40889849804808db8fbf7",
+  "guides/ai-agent-acceptance-criteria/index.html": "839ccbe2ca2240ad1ccb92d783d4f1b846fe961f077bc06fc47b756313bba8e8",
+  "guides/ai-agent-decision-packet/index.html": "2fbc885826852a599f3a4467b81eb222e0a92157fb30b5d96e72ec9f19b97074",
+  "guides/ai-agent-audit-trail/index.html": "7aa1cc9d15c8e5047567419f3c686bc2bd687754fb2bf92179cafd219974137a",
+  "guides/ai-agent-no-op/index.html": "cdc9352ebab26c676deee68d8517c04e2ada2530072ab334161b6a9681f32576",
+  "guides/ai-agent-source-of-record/index.html": "8ec11fe4231d463d0eae045ec60df9b6028ba097d7e9f5701da66a1288a155d6",
+  "guides/ai-agent-scope-creep/index.html": "a9239ae57bcbaed0548db881ba82caddf7624f951be95b1273278ba7b793fa7b",
+  "guides/ai-agent-review-packet/index.html": "24e77ee2c74520f708c00e670ae6cb19d2ba397bc2927f07585fa43e6d2742ad",
+  "guides/ai-agent-blockers/index.html": "0be581d511aca815134a00b4c88e54155db53da3c33d0d48c224687f0720ab86",
+  "guides/ai-agent-status-updates/index.html": "5e0a7c4c8ea64e8b7312582e83f0ca8a03f402e2271e70831018f80a2ad40481",
+  "guides/ai-agent-work-contract/index.html": "d01cee4c2013eba876e0c0bdab46b3d66a1725094adae0e2fb1c95bc26cdd444",
+  "guides/ai-agent-follow-on-work/index.html": "14622f5ee20ec83dd473309de23473f7de0d0930b6f73bbe8b6347bb0f682e2e",
+  "guides/ai-agent-verification-path/index.html": "2c0b6e66259818189517c4d656743aaaf47836f173bfdc5ff80041945eb90daa",
+  "guides/ai-agent-resume-conditions/index.html": "ba7e3907bb084bd1adcb3f2e0a9df1f9a8f07af107393fbfa452abd2071f28a7",
+  "guides/ai-agent-review-decisions/index.html": "edf334950826851cdab8bed7fd377048f2e38048da8c9f8717e43417e21dde9a",
+  "guides/ai-agent-non-goals/index.html": "8cb21396713944b1fef37779b7dacfe5bb6b99e09fcd60a7e4a88036da55068e",
+  "guides/ai-agent-evidence-labels/index.html": "a8dd0f2942c2b46a3b3d03b5141040685b6e27e02862f686febd7dc140bfd5b7",
+  "guides/ai-agent-dependency-management/index.html": "7d181f681733ae3f0db5908f496a9316b97edeffe4d112b980b09424e11c9a4c",
+  "guides/ai-agent-task-intake/index.html": "682dbd0e400a9965f0572512416b7bb9d3eee1e5416ee370d5bf88fed6c49e67",
+  "guides/ai-agent-decision-owner/index.html": "589e0afb6612ba28c041e4dc3a95ca2dbedab106b7dfcd65cf3597e4ad23e0b0",
+  "guides/ai-agent-artifact-versions/index.html": "9824bd1092854e7c6c223f962800ac254138621857b638fd5f4afa95423da526",
+  "guides/ai-agent-task-closure/index.html": "e470b0aec6f06a3ce30eb2bb8991afad53f2ac53b164e04f1f95d341d10921c9",
+  "guides/ai-agent-context-packet/index.html": "625867ebcc6571e2309f553941f18d2de94fbd238df5340db7fd5de19286d7a2",
+  "guides/ai-agent-focused-threads/index.html": "6955d12953b086fba56c8e5b79034105427da243bce7e76eb1d480dd02c49c64",
+  "guides/ai-agent-approval-boundaries/index.html": "f1113f10119f91124239eab2fc4955e304fed2703e07a13f40b2c045b6e2cd6f",
+  "guides/ai-agent-retained-context/index.html": "d2c63d35d5a6e9ddcb2423e1b51897bc2f77bd2239196499657f21980081ebda",
+  "guides/ai-agent-revision-loop/index.html": "04a72e77622cf28649b56dd702229dbe57b5252fcc3452268ce4a43f99c345eb",
+  "guides/ai-agent-task-splitting/index.html": "e9eeb7dd8235c4d944e0a4089fbfbcf1d0c9fa89bdc15d9c836c47422cf4c463",
+  "guides/ai-agent-interim-results/index.html": "51774f7bf81d649131d31dc5db527cf69979ede6ab3ee5e9d03b8abcfd018a82",
+  "guides/ai-agent-audience-boundaries/index.html": "7f1debe065fedd77329d85a776b8436a4f79e29297655b7c37f00cf030fe827b",
+  "guides/ai-agent-stop-conditions/index.html": "99e56311236b5cc55f1f5867187cc0702a12cefe4ed9b9e2216db395e937815c",
+  "guides/ai-agent-change-requests/index.html": "2caca931c44805be1cdda7d0582277cad8f27435cccd09626e0f48cff24ec3dd",
+  "guides/ai-agent-data-boundaries/index.html": "e527987f994df0a00b2de6006f56bc60e5db83f93e5ea9d68fe53070536dcba4",
+  "guides/ai-agent-disagreement-resolution/index.html": "0e099dd238cbb7971213ccf052485d1b104f21c463fd4b650bac7fca20548fab",
+  "guides/ai-agent-task-prioritization/index.html": "a55669066b617226f2fc876417c19ada6784c5255ffadb3f7fd2b6973914666f",
+  "guides/ai-agent-collaboration-platforms/index.html": "4ef093047c31cd1c4c9c6e45c59b4839c1e4ee6888c0d07aac411c7f121f9e6f",
+  "guides/control-what-coding-agents-can-access/index.html": "4aa6b4b18d14f03668443293bd409f253fa1691ae98ac6485bbc08496e099567",
+  "guides/github-agent-hq-alternative/index.html": "c158403a923c60623ce64f9398a7860ba28f0cbbd70b812021949e119623400f",
+  "guides/run-claude-code-and-codex-together/index.html": "ab5e6bee37f2adc49a8b48d641cc6ec657e5bfd2f9cb05af083707f773c9a41d"
+}
diff --git a/frontend/scripts/generate-seo-pages.test.mjs b/frontend/scripts/generate-seo-pages.test.mjs
index a041540fe0..0eef7b219b 100644
--- a/frontend/scripts/generate-seo-pages.test.mjs
+++ b/frontend/scripts/generate-seo-pages.test.mjs
@@ -1,5 +1,6 @@
 import assert from 'node:assert/strict';
 import test from 'node:test';
+import { createHash } from 'node:crypto';
 import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
@@ -2146,3 +2147,31 @@ test('the compare page is unlisted: noindex, out of the sitemap, and linked from
   assert.doesNotMatch(sitemap, /\/compare\//);
   assert.match(sitemap, /<loc>https:\/\/commonly\.me\/use-cases\/team-chat\/<\/loc>/);
 });
+
+// TASK-594 (D156): the guide restyle is CSS-only. Every generated page's markup
+// (words, URLs, titles, meta, canonical, JSON-LD) must match the hashes taken from
+// main's generator and template, with each <style> block removed.
+test('generated markup matches main byte for byte; only CSS moved (TASK-594)', async () => {
+  const fixture = JSON.parse(await readFile(resolve(frontendDir, 'scripts/fixtures/seo-markup-main.sha256.json'), 'utf8'));
+  const source = await readFile(resolve(frontendDir, 'index.html'), 'utf8');
+  // Vite output is not available here; stand in the entry script the generator expects.
+  const template = source.replace('</head>', '<link rel="modulepreload" href="/assets/chunk-shim.js"><script type="module" crossorigin src="/assets/index-shim.js"></script></head>');
+  const outputDir = await mkdtemp(join(tmpdir(), 'seo-markup-'));
+  try {
+    await writeFile(resolve(outputDir, 'index.html'), template);
+    const pages = await generateSeoPages({ outputDir });
+    assert.equal(pages.length, Object.keys(fixture).length);
+    for (const page of pages) {
+      const html = await readFile(resolve(outputDir, page.outputPath), 'utf8');
+      const markup = html.replace(/<style>[\s\S]*?<\/style>/g, '');
+      const digest = createHash('sha256').update(markup).digest('hex');
+      assert.equal(digest, fixture[page.outputPath], `${page.outputPath} markup drifted from main`);
+      if (page.outputPath === 'guides/index.html' || page.outputPath.startsWith('guides/')) {
+        // The restyle scopes on this header link, so every guide page must carry it.
+        assert.match(html, /<nav aria-label="Primary navigation">.*<a href="\/use-cases\/agent-collab\/">/);
+      }
+    }
+  } finally {
+    await rm(outputDir, { recursive: true, force: true });
+  }
+});

From aa6a5a4695cb52c1b7e2910690949488fcd94fc6 Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Tue, 27 Oct 2026 19:43:13 -0700
Subject: [PATCH 2/4] style(seo): keep guides index card titles at card size
 (TASK-594)

The index card titles are h2, so the section-scale 44/48 h2 rule reached
them and overflowed the cards at 1440. Card h2s now take 24/30 weight 800
with an ink, non-underlined link. CSS only; markup unchanged.

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: Polish <WyJwb2xpc2giLCJkZWZhdWx0Il0@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/default
---
 frontend/index.html | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/frontend/index.html b/frontend/index.html
index 33b1f94283..514e376eba 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -147,6 +147,9 @@
       #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-band h2,
       #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-band p { color: var(--v2-accent-deep); }
       #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-grid { gap: 12px; }
+      /* Card titles on the guides index are h2; keep them at card size, not section size. */
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-card h2 { margin: 0 0 12px; font-size: 24px; line-height: 30px; font-weight: 800; }
+      #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-card h2 a { color: var(--v2-ink); text-decoration: none; }
       #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-card { padding: 24px; border: 1px solid var(--v2-border); border-radius: var(--v2-radius); background: #ffffff; }
       #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-code { margin: 20px 0; padding: 16px; border: 0; border-radius: var(--v2-radius); color: #ffffff; background: var(--v2-ink); }
       #seo-page:has(header nav a[href="/use-cases/agent-collab/"]) .seo-table-wrap { border: 1px solid var(--v2-border-soft); border-radius: var(--v2-radius); }

From 2f5a178d4e852ede9581a2c346740886e27f1eed Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Sat, 31 Oct 2026 03:33:41 -0700
Subject: [PATCH 3/4] test(seo): keep the guide-header check, drop main's
 markup-hash fixture (TASK-594)

The fixture pinned every page's markup to main's hashes, so any new guide
or copy edit would fail it. The CSS-only proof ran once on this PR: after
merging current main, all 99 generated pages hash identically to main's
with <style> removed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01N4VWLCoyuvz5pcLfFSWo2R
---
 .../fixtures/seo-markup-main.sha256.json      | 101 ------------------
 frontend/scripts/generate-seo-pages.test.mjs  |  27 ++---
 2 files changed, 10 insertions(+), 118 deletions(-)
 delete mode 100644 frontend/scripts/fixtures/seo-markup-main.sha256.json

diff --git a/frontend/scripts/fixtures/seo-markup-main.sha256.json b/frontend/scripts/fixtures/seo-markup-main.sha256.json
deleted file mode 100644
index 11431d9f35..0000000000
--- a/frontend/scripts/fixtures/seo-markup-main.sha256.json
+++ /dev/null
@@ -1,101 +0,0 @@
-{
-  "index.html": "2459ff5409d46e04904a2d38230507e492667e353cc7b583e42a5a76ad040d40",
-  "compare/index.html": "1437cd163b2e06458ef812804a1cc08681e85e5142f276add6bd16cf5a441605",
-  "use-cases/team-chat/index.html": "2beaead9eba522625fa933209b24d02b3cc9f86959529310e7fdbd1ca1684eb9",
-  "use-cases/agent-collab/index.html": "0529724f5c388a902cb4b0a877e21fe5abcb3e8fce3a46a79a9f6444ca44e2c7",
-  "use-cases/research-desk/index.html": "c66de2cec2eca775b18ac0863c664452962d320234ed3f9f6dcbfeee9057464a",
-  "use-cases/daily-digest/index.html": "99faa3459649f7502f32d04264a108f94b87a1b1d84d73ac5ad59144627db996",
-  "use-cases/community/index.html": "f274d5b1a4417aaabc682fe996a15b79f7c036c893c9642e685fa37a1b155409",
-  "use-cases/pod-browser/index.html": "29a037809d148e79578f3b7fc58ffb84fb2af03f535fd7b30f42b15d83e0ba22",
-  "use-cases/app-marketplace/index.html": "31116530e51343fd50827a78e17842afb27f16a84244515a0834898fca0820e6",
-  "guides/index.html": "bc7431e80bc295bfd4f7fb30f41c7d63da660e09b5fae4a6ef9ab425bf70b2a8",
-  "guides/multi-agent-collaboration-platform/index.html": "866637869d211f1433fe70ee4402c5ff9e9d110e647ad9d36d5a573024b4d748",
-  "guides/ai-agent-workspace/index.html": "18f897688abb046088b090eba66fec9471a70acefa370f9d844f2e0cb48797de",
-  "guides/ai-agent-task-management/index.html": "22bee26e5810a7ee01e4fdd3b675d1433774d9a00df09f004a4aeb1ce71a0da0",
-  "guides/connect-claude-codex-shared-workspace/index.html": "dfb0943a159231e4f59c31ec649f68cce582adb5fd755ad53f0fbf09d8aa8a3c",
-  "guides/ai-agent-memory/index.html": "50548f7330ea741b8198469b558c89100fe021d303199327dcb90d0b10bfe521",
-  "guides/human-in-the-loop-ai-agents/index.html": "2b7634b0113e1e10f27d9d6d96e019c06f6b093a9e06463a4b49850ed72ed467",
-  "guides/ai-agent-handoffs/index.html": "0ad4ebcf6bc884c30a6bd3b8d11eb93234dce4dcb3d769d09237ffc8b631e38a",
-  "guides/how-to-build-an-ai-agent-team/index.html": "7f049c2b48897000fd610aa2c41e98c4f7ce969d070b1819a65f22d414d5df66",
-  "guides/agent-to-agent-messaging/index.html": "52d65bf20e3270ef7df54adb3d1e842de516902bbf892f301f65988458db9284",
-  "guides/self-hosted-ai-agent-platform/index.html": "e7e53d0a53302675889f78225bfaed5ac4f68807450273587993ac5404282f46",
-  "guides/ai-agent-permissions-and-tokens/index.html": "e7dbd3d116dfd356c0136cadebd6b2b09ab7a251a1e477872b07f2b6b583a79d",
-  "guides/connect-cursor-shared-workspace/index.html": "ae8f4572427136c6ae0ed41168bd99f0d9362a53bf0589c55d701ab777f6455d",
-  "guides/ai-agent-observability/index.html": "be1983f161d2b3b4010f5cc7c2f636a7929d02166b2e7a399339bb3c745bd9e7",
-  "guides/ai-agent-events/index.html": "99d3fea7e05203fcf418d0454edfd3efed6fa38e1ad11380b0202c99af73d446",
-  "guides/multi-agent-vs-single-agent/index.html": "933de9aa5e342a5e7ea51765e6f08d285e3fa4811d83d71ba30d9fee0a3988c4",
-  "guides/ai-agent-collaboration-patterns/index.html": "1a820ee4751f66687bbb4697392222a0d72051e03bf2bd55cddf870905f418b5",
-  "guides/onboarding-an-ai-agent-to-your-team/index.html": "d2dade7e6d6ed34dbf297e9671f93fecce66a3998f2ab0d332e5d489741be036",
-  "guides/ai-agent-discord-integration/index.html": "da0eec25437932b5d1d51e3d3d2f6bbffdfeec51c862ebad541e62c1aa4edf6b",
-  "guides/what-is-an-ai-agent-runtime/index.html": "43b3198212d569e5fa1d619a0f7a9bead9e9d63428761417b748081525cd2cad",
-  "guides/ai-agent-heartbeats-and-scheduled-work/index.html": "a24a2674e831f6bc3dab2b49b2ce6a263d0e7c3827ed1f256545d5fbee499cc5",
-  "guides/ai-agent-marketplace-roles/index.html": "96fee6b4e7807a6c58d52834e493c6030058af9ee2b711fd5034fea10c38acbd",
-  "guides/connect-a-custom-agent-http-api/index.html": "e64eead23dd74f4096319c7e90202ce694b272e68dfeb529a8e91b9c9b5cd091",
-  "guides/what-is-an-agent-pod/index.html": "29690e317a3cd1921ab0e3d89b370d03a6a59d82a5e56101b8f9f707346800ae",
-  "guides/connect-openclaw-agent/index.html": "2b586cffea690f4c93cda825f90235414684ddc58e44d11ea6c67548febe624a",
-  "guides/ai-agent-security-best-practices/index.html": "65871b797750a425a53d9627933fdad6994b7fb82714c98bfce0b9574472a7c6",
-  "guides/ai-agent-cli/index.html": "61d5393b7a78882681d32f26afa3c9977d39736b7a374c9fddd7c7cd891e6aea",
-  "guides/ai-agent-orchestration/index.html": "161b117e48e5ccf3823d5667ba589f5e277cdde4cfa542fd97cf6233dd7953ca",
-  "guides/ai-agent-skills/index.html": "b3b3a9454b8d851f1210057bf7b9e82c7fe36b7ff80dd28ba19a7899263e8aed",
-  "guides/autonomous-ai-agents/index.html": "23502098b59980e4cb782edc203f0efbf7b8bea7858b7964036515278d7bec04",
-  "guides/ai-agent-sandboxing/index.html": "f78826881fb0793312be4098722454d529a027d4a220b64bbd34017884293f05",
-  "guides/ai-agent-tools/index.html": "1df4ab762f57a5160f9768a91cc2186d080a0142cff612df4440ecdfe051f741",
-  "guides/prompt-injection-defense-for-ai-agents/index.html": "467bdf99f08beb5f41eab2f432db5dcc7eca5ba918b7234f718ccfa0eef8c574",
-  "guides/mcp-for-ai-agent-teams/index.html": "bf17c8d4053d910a59b3efdd6da1fda4c1fa651e0b6283766b666743f57a091b",
-  "guides/what-is-agentic-ai/index.html": "6d919567121d6377b611f405751ff5adfab4f021ba3a20bb14d1de9629da66be",
-  "guides/what-is-an-ai-agent/index.html": "7acb1b69f3aadb782d4d86145e4a9bd321b883cf38b2f9d7de045047a634c51a",
-  "guides/context-engineering-for-ai-agents/index.html": "7d4810e245f9f9348a31815e130c273ee3eb2836c1fdee363bcb0ba36991f188",
-  "guides/how-to-evaluate-ai-agents/index.html": "5060c2e319c2294b3d87e66c470a68e6074532d80c2d6e07a36a389d9fc9e368",
-  "guides/ai-agent-vs-chatbot/index.html": "0e2d708f4561dee8c49d97d7c4441c86ad691a44a221239f09d65e5aa119a848",
-  "guides/ai-agent-use-cases/index.html": "72efdc8d1ac657debda30dfc1828dbb75559f5d6bffdc89730fc1dfc5a8510d7",
-  "guides/human-ai-collaboration/index.html": "ac6ee3607bf37b76026756950e84c025f3d3be64b06fcc3c578a8a10d222e490",
-  "guides/agentic-workflows/index.html": "1786a7d50e945d85bec9329d1cd3fb6dc2a11d0446329e4ae1e02908279aa608",
-  "guides/ai-agents-for-project-management/index.html": "225d683d03d538d48b9cf2c99ad3c8489e1cb7ecc8dac18683803ef1aee6c0f0",
-  "guides/how-to-write-ai-agent-instructions/index.html": "fbd9b1daa8be9b51e3bc842990d6a7105b6e6740d4feb1d74b257b01c0398834",
-  "guides/ai-agents-for-research/index.html": "cbff168a721934f564bebe5a920b021e38cadfa2ec3a73cfa22508f0403f4e5f",
-  "guides/ai-agents-for-customer-support/index.html": "d3d981dd143eabac6f7eb971281230bf20ba606ae1345cb68840a992a35e29ba",
-  "guides/what-is-a-multi-agent-system/index.html": "a6b29e392c855b3998d9c315a2506b5cb5ce32384fe2b478cc29f98a70dad260",
-  "guides/ai-agent-glossary/index.html": "b3aa41a74f3450c90fe7fd600f5715cf81d5ed10fb399ad5be3838701e1fb5c4",
-  "guides/ai-agent-governance/index.html": "bf2116939b09963bb2165bd170bc4fe6ae8aa53c7f001bcea51d128cbd43f11d",
-  "guides/ai-agents-for-software-development/index.html": "6127d24beeafe30a84170110c38cb11d974e98b827fc18cdfd40f2c1c9a39360",
-  "guides/ai-agent-roles/index.html": "d27fa2aad09b4ad587f6740c22aa0d0e3b707569e0f2c2ac713f0fa350a570eb",
-  "guides/ai-agent-escalation/index.html": "6d536bb28b36efea4a395174ed9d7b6f79ede7eb7af40889849804808db8fbf7",
-  "guides/ai-agent-acceptance-criteria/index.html": "839ccbe2ca2240ad1ccb92d783d4f1b846fe961f077bc06fc47b756313bba8e8",
-  "guides/ai-agent-decision-packet/index.html": "2fbc885826852a599f3a4467b81eb222e0a92157fb30b5d96e72ec9f19b97074",
-  "guides/ai-agent-audit-trail/index.html": "7aa1cc9d15c8e5047567419f3c686bc2bd687754fb2bf92179cafd219974137a",
-  "guides/ai-agent-no-op/index.html": "cdc9352ebab26c676deee68d8517c04e2ada2530072ab334161b6a9681f32576",
-  "guides/ai-agent-source-of-record/index.html": "8ec11fe4231d463d0eae045ec60df9b6028ba097d7e9f5701da66a1288a155d6",
-  "guides/ai-agent-scope-creep/index.html": "a9239ae57bcbaed0548db881ba82caddf7624f951be95b1273278ba7b793fa7b",
-  "guides/ai-agent-review-packet/index.html": "24e77ee2c74520f708c00e670ae6cb19d2ba397bc2927f07585fa43e6d2742ad",
-  "guides/ai-agent-blockers/index.html": "0be581d511aca815134a00b4c88e54155db53da3c33d0d48c224687f0720ab86",
-  "guides/ai-agent-status-updates/index.html": "5e0a7c4c8ea64e8b7312582e83f0ca8a03f402e2271e70831018f80a2ad40481",
-  "guides/ai-agent-work-contract/index.html": "d01cee4c2013eba876e0c0bdab46b3d66a1725094adae0e2fb1c95bc26cdd444",
-  "guides/ai-agent-follow-on-work/index.html": "14622f5ee20ec83dd473309de23473f7de0d0930b6f73bbe8b6347bb0f682e2e",
-  "guides/ai-agent-verification-path/index.html": "2c0b6e66259818189517c4d656743aaaf47836f173bfdc5ff80041945eb90daa",
-  "guides/ai-agent-resume-conditions/index.html": "ba7e3907bb084bd1adcb3f2e0a9df1f9a8f07af107393fbfa452abd2071f28a7",
-  "guides/ai-agent-review-decisions/index.html": "edf334950826851cdab8bed7fd377048f2e38048da8c9f8717e43417e21dde9a",
-  "guides/ai-agent-non-goals/index.html": "8cb21396713944b1fef37779b7dacfe5bb6b99e09fcd60a7e4a88036da55068e",
-  "guides/ai-agent-evidence-labels/index.html": "a8dd0f2942c2b46a3b3d03b5141040685b6e27e02862f686febd7dc140bfd5b7",
-  "guides/ai-agent-dependency-management/index.html": "7d181f681733ae3f0db5908f496a9316b97edeffe4d112b980b09424e11c9a4c",
-  "guides/ai-agent-task-intake/index.html": "682dbd0e400a9965f0572512416b7bb9d3eee1e5416ee370d5bf88fed6c49e67",
-  "guides/ai-agent-decision-owner/index.html": "589e0afb6612ba28c041e4dc3a95ca2dbedab106b7dfcd65cf3597e4ad23e0b0",
-  "guides/ai-agent-artifact-versions/index.html": "9824bd1092854e7c6c223f962800ac254138621857b638fd5f4afa95423da526",
-  "guides/ai-agent-task-closure/index.html": "e470b0aec6f06a3ce30eb2bb8991afad53f2ac53b164e04f1f95d341d10921c9",
-  "guides/ai-agent-context-packet/index.html": "625867ebcc6571e2309f553941f18d2de94fbd238df5340db7fd5de19286d7a2",
-  "guides/ai-agent-focused-threads/index.html": "6955d12953b086fba56c8e5b79034105427da243bce7e76eb1d480dd02c49c64",
-  "guides/ai-agent-approval-boundaries/index.html": "f1113f10119f91124239eab2fc4955e304fed2703e07a13f40b2c045b6e2cd6f",
-  "guides/ai-agent-retained-context/index.html": "d2c63d35d5a6e9ddcb2423e1b51897bc2f77bd2239196499657f21980081ebda",
-  "guides/ai-agent-revision-loop/index.html": "04a72e77622cf28649b56dd702229dbe57b5252fcc3452268ce4a43f99c345eb",
-  "guides/ai-agent-task-splitting/index.html": "e9eeb7dd8235c4d944e0a4089fbfbcf1d0c9fa89bdc15d9c836c47422cf4c463",
-  "guides/ai-agent-interim-results/index.html": "51774f7bf81d649131d31dc5db527cf69979ede6ab3ee5e9d03b8abcfd018a82",
-  "guides/ai-agent-audience-boundaries/index.html": "7f1debe065fedd77329d85a776b8436a4f79e29297655b7c37f00cf030fe827b",
-  "guides/ai-agent-stop-conditions/index.html": "99e56311236b5cc55f1f5867187cc0702a12cefe4ed9b9e2216db395e937815c",
-  "guides/ai-agent-change-requests/index.html": "2caca931c44805be1cdda7d0582277cad8f27435cccd09626e0f48cff24ec3dd",
-  "guides/ai-agent-data-boundaries/index.html": "e527987f994df0a00b2de6006f56bc60e5db83f93e5ea9d68fe53070536dcba4",
-  "guides/ai-agent-disagreement-resolution/index.html": "0e099dd238cbb7971213ccf052485d1b104f21c463fd4b650bac7fca20548fab",
-  "guides/ai-agent-task-prioritization/index.html": "a55669066b617226f2fc876417c19ada6784c5255ffadb3f7fd2b6973914666f",
-  "guides/ai-agent-collaboration-platforms/index.html": "4ef093047c31cd1c4c9c6e45c59b4839c1e4ee6888c0d07aac411c7f121f9e6f",
-  "guides/control-what-coding-agents-can-access/index.html": "4aa6b4b18d14f03668443293bd409f253fa1691ae98ac6485bbc08496e099567",
-  "guides/github-agent-hq-alternative/index.html": "c158403a923c60623ce64f9398a7860ba28f0cbbd70b812021949e119623400f",
-  "guides/run-claude-code-and-codex-together/index.html": "ab5e6bee37f2adc49a8b48d641cc6ec657e5bfd2f9cb05af083707f773c9a41d"
-}
diff --git a/frontend/scripts/generate-seo-pages.test.mjs b/frontend/scripts/generate-seo-pages.test.mjs
index bdd3960f44..efde1531fb 100644
--- a/frontend/scripts/generate-seo-pages.test.mjs
+++ b/frontend/scripts/generate-seo-pages.test.mjs
@@ -1,6 +1,5 @@
 import assert from 'node:assert/strict';
 import test from 'node:test';
-import { createHash } from 'node:crypto';
 import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
@@ -2148,28 +2147,22 @@ test('the compare page is unlisted: noindex, out of the sitemap, and linked from
   assert.match(sitemap, /<loc>https:\/\/commonly\.me\/use-cases\/team-chat\/<\/loc>/);
 });
 
-// TASK-594 (D156): the guide restyle is CSS-only. Every generated page's markup
-// (words, URLs, titles, meta, canonical, JSON-LD) must match the hashes taken from
-// main's generator and template, with each <style> block removed.
-test('generated markup matches main byte for byte; only CSS moved (TASK-594)', async () => {
-  const fixture = JSON.parse(await readFile(resolve(frontendDir, 'scripts/fixtures/seo-markup-main.sha256.json'), 'utf8'));
+// TASK-594 (D156): the guide restyle scopes its CSS on the header's use-cases link,
+// so every guide page and the guides index must carry it. (The restyle's CSS-only
+// proof, every page's markup hashed against main with <style> removed, ran once
+// on the PR; a fixture of main's hashes would break on every new page.)
+test('every guide page carries the header link the restyle scopes on (TASK-594)', async () => {
   const source = await readFile(resolve(frontendDir, 'index.html'), 'utf8');
-  // Vite output is not available here; stand in the entry script the generator expects.
   const template = source.replace('</head>', '<link rel="modulepreload" href="/assets/chunk-shim.js"><script type="module" crossorigin src="/assets/index-shim.js"></script></head>');
-  const outputDir = await mkdtemp(join(tmpdir(), 'seo-markup-'));
+  const outputDir = await mkdtemp(join(tmpdir(), 'seo-guides-'));
   try {
     await writeFile(resolve(outputDir, 'index.html'), template);
     const pages = await generateSeoPages({ outputDir });
-    assert.equal(pages.length, Object.keys(fixture).length);
-    for (const page of pages) {
+    const guides = pages.filter((page) => page.outputPath.startsWith('guides/'));
+    assert.ok(guides.length > 0);
+    for (const page of guides) {
       const html = await readFile(resolve(outputDir, page.outputPath), 'utf8');
-      const markup = html.replace(/<style>[\s\S]*?<\/style>/g, '');
-      const digest = createHash('sha256').update(markup).digest('hex');
-      assert.equal(digest, fixture[page.outputPath], `${page.outputPath} markup drifted from main`);
-      if (page.outputPath === 'guides/index.html' || page.outputPath.startsWith('guides/')) {
-        // The restyle scopes on this header link, so every guide page must carry it.
-        assert.match(html, /<nav aria-label="Primary navigation">.*<a href="\/use-cases\/agent-collab\/">/);
-      }
+      assert.match(html, /<nav aria-label="Primary navigation">.*<a href="\/use-cases\/agent-collab\/">/, page.outputPath);
     }
   } finally {
     await rm(outputDir, { recursive: true, force: true });

From 3bdfdd475f6dec63aaec1cb153fbd49090e528ba Mon Sep 17 00:00:00 2001
From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com>
Date: Sat, 31 Oct 2026 03:42:33 -0700
Subject: [PATCH 4/4] test(seo): check the restyle is in index.html and reaches
 only guide pages

Also drops the task and ledger ids from the CSS comment, since index.html
is served on every route.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01N4VWLCoyuvz5pcLfFSWo2R
---
 frontend/index.html                          |  2 +-
 frontend/scripts/generate-seo-pages.test.mjs | 14 ++++++++++----
 2 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/frontend/index.html b/frontend/index.html
index 705f24e4a9..b905c4cabe 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -100,7 +100,7 @@
       #seo-page .seo-note { color: #7b8494; font-size: .875rem; }
       #seo-page .seo-footer { padding: 40px 0; color: #7b8494; border-top: 1px solid #e5e7eb; }
       @media (max-width: 640px) { #seo-page .seo-header { align-items: flex-start; flex-direction: column; padding: 20px 0; } #seo-page section { padding: 44px 0; } #seo-page .seo-hero { padding-top: 56px; padding-bottom: 56px; } }
-      /* TASK-594 (D156): guide pages and the guides index take the landing's type,
+      /* Guide pages and the guides index take the landing's type,
          colour and measure. Scoped to the pages whose header links Agent
          collaboration, so compare and use-case pages keep the rules above. Tokens
          are declared here because .v2-root does not reach the prerender. Values
diff --git a/frontend/scripts/generate-seo-pages.test.mjs b/frontend/scripts/generate-seo-pages.test.mjs
index efde1531fb..32baf2ce78 100644
--- a/frontend/scripts/generate-seo-pages.test.mjs
+++ b/frontend/scripts/generate-seo-pages.test.mjs
@@ -2147,8 +2147,8 @@ test('the compare page is unlisted: noindex, out of the sitemap, and linked from
   assert.match(sitemap, /<loc>https:\/\/commonly\.me\/use-cases\/team-chat\/<\/loc>/);
 });
 
-// TASK-594 (D156): the guide restyle scopes its CSS on the header's use-cases link,
-// so every guide page and the guides index must carry it. (The restyle's CSS-only
+// The guide restyle scopes its CSS on the header's use-cases link, so every guide
+// page and the guides index must carry it, and no other page may. (The restyle's CSS-only
 // proof, every page's markup hashed against main with <style> removed, ran once
 // on the PR; a fixture of main's hashes would break on every new page.)
 test('every guide page carries the header link the restyle scopes on (TASK-594)', async () => {
@@ -2158,11 +2158,17 @@ test('every guide page carries the header link the restyle scopes on (TASK-594)'
   try {
     await writeFile(resolve(outputDir, 'index.html'), template);
     const pages = await generateSeoPages({ outputDir });
+    // index.html carries the restyle, scoped on that header link.
+    assert.match(source, /#seo-page:has\(header nav a\[href="\/use-cases\/agent-collab\/"\]\)/);
+    const nav = /<nav aria-label="Primary navigation">.*<a href="\/use-cases\/agent-collab\/">/;
     const guides = pages.filter((page) => page.outputPath.startsWith('guides/'));
     assert.ok(guides.length > 0);
     for (const page of guides) {
-      const html = await readFile(resolve(outputDir, page.outputPath), 'utf8');
-      assert.match(html, /<nav aria-label="Primary navigation">.*<a href="\/use-cases\/agent-collab\/">/, page.outputPath);
+      assert.match(await readFile(resolve(outputDir, page.outputPath), 'utf8'), nav, page.outputPath);
+    }
+    // Every other page keeps its own look, so it must not carry the link the restyle scopes on.
+    for (const page of pages.filter((p) => !p.outputPath.startsWith('guides/') && p.outputPath.endsWith('.html'))) {
+      assert.doesNotMatch(await readFile(resolve(outputDir, page.outputPath), 'utf8'), nav, page.outputPath);
     }
   } finally {
     await rm(outputDir, { recursive: true, force: true });