diff --git a/.github/workflows/build-catalog.yml b/.github/workflows/build-catalog.yml
index 51f1b872..c9b03cc3 100644
--- a/.github/workflows/build-catalog.yml
+++ b/.github/workflows/build-catalog.yml
@@ -27,6 +27,7 @@ on:
 
 permissions:
   contents: write
+  discussions: read
 
 jobs:
   validate:
@@ -62,14 +63,22 @@ jobs:
         working-directory: tools/catalog-build
       - run: npm run build
         working-directory: tools/catalog-build
+      - run: npm run build:stats
+        working-directory: tools/catalog-build
+        env:
+          CLARITY_API_TOKEN: ${{ secrets.CLARITY_API_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - name: Commit generated catalog
         run: |
-          if git diff --quiet -- catalog.json; then
-            echo "Catalog is already current."
+          git add catalog.json resource-stats.json traffic-data/clarity-views.json resource-discussions.json
+          if [ -f design-concepts/resource-stats.json ]; then
+            git add design-concepts/resource-stats.json
+          fi
+          if git diff --cached --quiet; then
+            echo "Catalog and resource stats are already current."
             exit 0
           fi
           git config user.name "github-actions[bot]"
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git add catalog.json
           git commit -m "chore: rebuild catalog [skip ci]"
           git push
diff --git a/.github/workflows/traffic-stats.yml b/.github/workflows/traffic-stats.yml
index e9e2d724..609a9454 100644
--- a/.github/workflows/traffic-stats.yml
+++ b/.github/workflows/traffic-stats.yml
@@ -8,6 +8,7 @@ on:
 
 permissions:
   contents: write
+  discussions: read
   pull-requests: write
 
 concurrency:
@@ -24,6 +25,17 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v5
 
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: tools/catalog-build/package-lock.json
+
+      - name: Install catalog build dependencies
+        run: npm ci
+        working-directory: tools/catalog-build
+
       - name: Collect and persist traffic data
         env:
           GH_TOKEN: ${{ secrets.TRAFFIC_TOKEN }}
@@ -176,13 +188,22 @@ jobs:
 
           echo "✅ Saved $DATA_DIR/$DATE.json"
 
+      - name: Build resource stats
+        env:
+          CLARITY_API_TOKEN: ${{ secrets.CLARITY_API_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: node tools/catalog-build/build-stats.js
+
       - name: Commit and open PR
         env:
           GH_TOKEN: ${{ secrets.TRAFFIC_TOKEN }}
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add traffic-data/
+          git add traffic-data/ resource-stats.json resource-discussions.json
+          if [ -f design-concepts/resource-stats.json ]; then
+            git add design-concepts/resource-stats.json
+          fi
           if git diff --cached --quiet; then
             echo "No changes to commit"
             exit 0
diff --git a/index.html b/index.html
index a97366b4..6914c72c 100644
--- a/index.html
+++ b/index.html
@@ -1449,6 +1449,11 @@ <h4 class="detail-content-heading">Prerequisites</h4>
             <ul class="detail-prerequisites" id="detailPrerequisites"></ul>
           </section>
         </div>
+        <div class="detail-giscus-section">
+          <h3>Community &amp; upvotes</h3>
+          <!-- giscus embed is mounted per-resource by mountGiscus() using the resource slug as data-term -->
+          <div id="giscusContainer"></div>
+        </div>
         <h3>Related resources</h3>
         <div class="related-grid" id="relatedGrid"></div>
       </div>
@@ -1466,7 +1471,7 @@ <h3>Related resources</h3>
             <div class="metadata-label">Format</div>
             <div class="metadata-val" id="metaFormat"></div>
           </div>
-          <div class="metadata-row">
+          <div class="metadata-row" id="metaViewsRow">
             <div class="metadata-label">Views</div>
             <div class="metadata-val" id="metaViews" style="font-family: var(--font-mono); font-variant-numeric: tabular-nums;"></div>
           </div>
@@ -1483,10 +1488,6 @@ <h3>Related resources</h3>
             <div class="metadata-val" id="metaVersion"></div>
           </div>
           <div class="detail-actions">
-            <button class="btn-secondary vote-btn" id="btnDetailVote" style="width: 100%; justify-content: center;">
-              <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M18 15l-6-6-6 6"/></svg>
-              Upvote <span class="vote-count" style="margin-left: 0.25rem;"></span>
-            </button>
             <button class="btn-primary" id="btnDetailView" type="button" style="display: none; width: 100%; justify-content: center;">
               View
               <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/><path d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/></svg>
@@ -1537,7 +1538,9 @@ <h3>Related resources</h3>
   <script>
     // --- DATASET ---
     const CATALOG_URL = 'catalog.json';
+    const STATS_URL = 'resource-stats.json';
     let RESOURCES = [];
+    let STATS = {};
 
     const TYPE_DEF = [
       { id: 'all', label: 'All', desc: 'Browse everything' },
@@ -1590,35 +1593,21 @@ <h3>Related resources</h3>
       return 'FT';
     };
 
-    const hashStr = (s) => {
-      let h = 0x811c9dc5;
-      for (let i = 0; i < s.length; i++) {
-        h ^= s.charCodeAt(i);
-        h = (h * 0x01000193) >>> 0;
-      }
-      return h;
-    };
-    const baseStats = (r) => {
-      const h = hashStr(r.slug);
-      const ageDays = Math.max(0, (Date.now() - new Date(r.updated)) / 86400000);
-      const recency = Math.max(0, 1 - ageDays / 540);
-      const views = 140 + (h % 4200) + Math.round(recency * 2600) + (r.featured ? 1600 : 0);
-      const rate = 0.02 + ((h >>> 3) % 9) / 100;
-      const upvotes = Math.max(3, Math.round(views * rate));
-      return { views, upvotes };
-    };
-    const getVotesState = () => {
-      try { return JSON.parse(localStorage.getItem('ft-votes') || '{}'); } catch(e) { return {}; }
-    };
-    const hasVoted = (slug) => !!getVotesState()[slug];
-    const toggleVote = (slug) => {
-      const votes = getVotesState();
-      if (votes[slug]) delete votes[slug]; else votes[slug] = true;
-      localStorage.setItem('ft-votes', JSON.stringify(votes));
-    };
     const getStats = (r) => {
-      const base = baseStats(r);
-      return { views: base.views, upvotes: base.upvotes + (hasVoted(r.slug) ? 1 : 0) };
+      const s = (STATS && STATS[r.slug]) || {};
+      const hasViews = Number.isFinite(s.views);
+      const hasDiscussion = !!(s.discussion && s.discussion.url);
+      const discussionUrl = s.discussion?.url || null;
+      const discussionNumber = s.discussion?.number ?? null;
+      const hasUpvotes = hasDiscussion;
+      return {
+        views: hasViews ? s.views : 0,
+        hasViews,
+        upvotes: Number.isFinite(s.upvotes) ? s.upvotes : 0,
+        hasUpvotes,
+        discussionUrl,
+        discussionNumber
+      };
     };
     const formatCount = (n) => {
       if (n >= 10000) return (n / 1000).toFixed(0) + 'k';
@@ -1668,6 +1657,16 @@ <h3>Related resources</h3>
         const catalog = await response.json();
         if (!catalog || !Array.isArray(catalog.resources)) throw new Error('Catalog response has an invalid shape');
 
+        try {
+          const statsRes = await fetch(STATS_URL, { cache: 'no-cache' });
+          if (statsRes.ok) {
+            const statsData = await statsRes.json();
+            STATS = statsData.resources || {};
+          }
+        } catch (e) {
+          console.warn('Failed to load stats:', e);
+        }
+
         RESOURCES = catalog.resources.map(resource => ({
           ...resource,
           name: resource.name || resource.title,
@@ -1717,9 +1716,13 @@ <h3>Related resources</h3>
       }
       updateDensityUI();
 
-      // 2. Read URL Params
+      // 2. Read URL Params and Hash
       const params = new URLSearchParams(window.location.search);
-      if (params.has('resource')) state.resource = params.get('resource');
+      if (window.location.hash) {
+        state.resource = window.location.hash.substring(1);
+      } else if (params.has('resource')) {
+        state.resource = params.get('resource');
+      }
       if (params.has('q')) state.q = params.get('q');
       if (params.has('type')) state.type = params.get('type');
       if (params.has('tag')) state.tag = params.get('tag');
@@ -1734,7 +1737,7 @@ <h3>Related resources</h3>
       // 3. Bind Events
       window.addEventListener('popstate', () => {
         const urlParams = new URLSearchParams(window.location.search);
-        state.resource = urlParams.get('resource') || null;
+        state.resource = window.location.hash ? window.location.hash.substring(1) : (urlParams.get('resource') || null);
         state.q = urlParams.get('q') || '';
         state.type = urlParams.get('type') || 'all';
         state.tag = urlParams.get('tag') || 'all';
@@ -1751,7 +1754,7 @@ <h3>Related resources</h3>
         if (link && !e.ctrlKey && !e.metaKey && !e.shiftKey) {
           e.preventDefault();
           const url = new URL(link.href, window.location.origin);
-          const slug = url.searchParams.get('resource');
+          const slug = url.hash ? url.hash.substring(1) : url.searchParams.get('resource');
           if (slug) {
             state.resource = slug;
             updateState(true);
@@ -1813,7 +1816,7 @@ <h3>Related resources</h3>
       // Update URL
       const url = new URL(window.location);
       if (state.resource) {
-        url.searchParams.set('resource', state.resource);
+        url.searchParams.delete('resource');
         url.searchParams.delete('q');
         url.searchParams.delete('type');
         url.searchParams.delete('tag');
@@ -1826,10 +1829,11 @@ <h3>Related resources</h3>
         if (state.sort !== 'popular') url.searchParams.set('sort', state.sort); else url.searchParams.delete('sort');
       }
       
+      const urlStr = url.pathname + url.search + (state.resource ? '#' + state.resource : '');
       if (pushHistory) {
-        window.history.pushState({ internal: true }, '', url);
+        window.history.pushState({ internal: true }, '', urlStr);
       } else {
-        window.history.replaceState(window.history.state || { internal: true }, '', url);
+        window.history.replaceState(window.history.state || { internal: true }, '', urlStr);
       }
 
       render();
@@ -1892,6 +1896,10 @@ <h3>Related resources</h3>
         }
       }
 
+      // Cleanup detail view state
+      const giscusContainer = document.getElementById('giscusContainer');
+      if (giscusContainer) giscusContainer.innerHTML = '';
+
       document.getElementById('catalogView').classList.remove('d-none');
       document.getElementById('detailView').classList.add('d-none');
 
@@ -2102,7 +2110,6 @@ <h3>Related resources</h3>
       const bg = getTypeBg(data.type);
       const color = getTypeColor(data.type);
       const stats = getStats(data);
-      const voted = hasVoted(data.slug);
       
       const star = data.featured ? `<span class="featured-star" aria-label="Featured">★</span>` : '';
       
@@ -2115,7 +2122,7 @@ <h3>Related resources</h3>
           </div>
           <div class="card-title-group">
             <h2 class="card-title">
-              <a href="?resource=${data.slug}" class="resource-link">${data.name}</a>
+              <a href="#${data.slug}" class="resource-link">${data.name}</a>
             </h2>
             <div class="card-sub">
               <div class="pill-dot" style="background-color: ${color}; width: 6px; height: 6px;"></div>
@@ -2124,30 +2131,28 @@ <h2 class="card-title">
           </div>
         </div>
         <div class="card-desc">${data.description}</div>
-        <div class="compact-views" aria-label="${stats.views} views">
+        ${stats.hasViews ? `<div class="compact-views" aria-label="${stats.views} views">
           <svg width="14" height="14" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/></svg>
           ${formatCount(stats.views)}
-        </div>
-        <div class="compact-votes">
-          <button class="vote-btn ${voted ? 'voted' : ''}" data-slug="${data.slug}" aria-pressed="${voted}" aria-label="${voted ? `Remove your upvote from ${data.name}` : `Upvote ${data.name}`}">
-            <svg width="14" height="14" viewBox="0 0 24 24" fill="${voted ? 'currentColor' : 'none'}" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M18 15l-6-6-6 6"/></svg>
-            <span class="vote-count">${formatCount(stats.upvotes)}</span>
-          </button>
-        </div>
+        </div>` : ''}
+        ${stats.hasUpvotes ? `<div class="compact-votes" aria-label="${stats.upvotes} upvotes">
+          <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M18 15l-6-6-6 6"/></svg>
+          <span class="vote-count">${formatCount(stats.upvotes)}</span>
+        </div>` : ''}
         <div class="card-footer">
           <div class="card-tags">
             ${data.tags.slice(0, 3).map(t => `<span class="card-tag">${t}</span>`).join('')}
             ${data.tags.length > 3 ? `<span class="card-tag">+${data.tags.length - 3}</span>` : ''}
           </div>
           <div class="card-stats">
-            <span class="stat-views" aria-label="${stats.views} views">
+            ${stats.hasViews ? `<span class="stat-views" aria-label="${stats.views} views">
               <svg width="14" height="14" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/></svg>
               ${formatCount(stats.views)}
-            </span>
-            <button class="vote-btn ${voted ? 'voted' : ''}" data-slug="${data.slug}" aria-pressed="${voted}" aria-label="${voted ? `Remove your upvote from ${data.name}` : `Upvote ${data.name}`}">
-              <svg width="14" height="14" viewBox="0 0 24 24" fill="${voted ? 'currentColor' : 'none'}" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M18 15l-6-6-6 6"/></svg>
+            </span>` : ''}
+            ${stats.hasUpvotes ? `<span class="stat-views" aria-label="${stats.upvotes} upvotes">
+              <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M18 15l-6-6-6 6"/></svg>
               <span class="vote-count">${formatCount(stats.upvotes)}</span>
-            </button>
+            </span>` : ''}
           </div>
           <div class="card-artifact-container">
             <div class="card-artifact" aria-label="Format: ${data.artifact}">
@@ -2158,31 +2163,6 @@ <h2 class="card-title">
           </div>
         </div>
       `;
-      const bindVote = (btn) => {
-        btn.addEventListener('click', (e) => {
-          e.preventDefault();
-          e.stopPropagation();
-          toggleVote(data.slug);
-          const nowVoted = hasVoted(data.slug);
-          if (nowVoted && typeof window.clarity !== 'undefined') {
-            window.clarity('set', 'upvoted_resource', data.slug);
-            window.clarity('event', 'resource_upvote');
-          }
-          const newStats = getStats(data);
-          // Update both buttons in this card
-          card.querySelectorAll('.vote-btn').forEach(b => {
-            b.classList.toggle('voted', nowVoted);
-            b.setAttribute('aria-pressed', nowVoted);
-            b.setAttribute('aria-label', nowVoted ? `Remove your upvote from ${data.name}` : `Upvote ${data.name}`);
-            b.querySelector('.vote-count').textContent = formatCount(newStats.upvotes);
-            b.querySelector('svg').setAttribute('fill', nowVoted ? 'currentColor' : 'none');
-            b.classList.remove('pop');
-            void b.offsetWidth; // trigger reflow
-            b.classList.add('pop');
-          });
-        });
-      };
-      card.querySelectorAll('.vote-btn').forEach(bindVote);
 
       return card;
     }
@@ -2220,6 +2200,9 @@ <h3>Browse all 54 scripts &rarr;</h3>
       document.documentElement.setAttribute('data-theme', next);
       localStorage.setItem('theme', next);
       updateThemeIcon();
+      
+      const giscusTheme = next === 'dark' ? 'dark_dimmed' : 'light';
+      document.querySelector('#giscusContainer iframe.giscus-frame')?.contentWindow?.postMessage({ giscus: { setConfig: { theme: giscusTheme } } }, 'https://giscus.app');
     }
 
     function updateThemeIcon() {
@@ -2342,6 +2325,30 @@ <h3>Browse all 54 scripts &rarr;</h3>
       parseTextBlock(source.slice(cursor));
     }
 
+    function mountGiscus(slug, theme) {
+      const container = document.getElementById('giscusContainer');
+      if (!container) return;
+      container.innerHTML = '';
+      const script = document.createElement('script');
+      script.src = "https://giscus.app/client.js";
+      script.setAttribute("data-repo", "microsoft/FastTrack");
+      script.setAttribute("data-repo-id", "MDEwOlJlcG9zaXRvcnkxMjM5MzE5NTk=");
+      script.setAttribute("data-category", "Resource Votes");
+      script.setAttribute("data-category-id", "DIC_kwDOB2MNN84DBq2E");
+      script.setAttribute("data-mapping", "specific");
+      script.setAttribute("data-term", slug);
+      script.setAttribute("data-strict", "1");
+      script.setAttribute("data-reactions-enabled", "1");
+      script.setAttribute("data-emit-metadata", "0");
+      script.setAttribute("data-input-position", "bottom");
+      script.setAttribute("data-theme", theme === "dark" ? "dark_dimmed" : "light");
+      script.setAttribute("data-lang", "en");
+      script.setAttribute("data-loading", "lazy");
+      script.setAttribute("crossorigin", "anonymous");
+      script.async = true;
+      container.appendChild(script);
+    }
+
     function renderDetailView(resource) {
       document.getElementById('catalogView').classList.add('d-none');
       document.getElementById('detailView').classList.remove('d-none');
@@ -2400,12 +2407,15 @@ <h3>Browse all 54 scripts &rarr;</h3>
       document.getElementById('metaFormat').textContent = fmt;
       
       const stats = getStats(resource);
-      document.getElementById('metaViews').innerHTML = `
-        <span class="stat-views" style="display:inline-flex; align-items:center; gap:0.25rem;">
-          <svg width="14" height="14" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/></svg>
-          ${formatCount(stats.views)}
-        </span>
-      `;
+      document.getElementById('metaViewsRow').classList.toggle('d-none', !stats.hasViews);
+      if (stats.hasViews) {
+        document.getElementById('metaViews').innerHTML = `
+          <span class="stat-views" style="display:inline-flex; align-items:center; gap:0.25rem;">
+            <svg width="14" height="14" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/></svg>
+            ${formatCount(stats.views)}
+          </span>
+        `;
+      }
       
       document.getElementById('metaUpdated').textContent = formatDate(resource.updated) || 'Not provided';
 
@@ -2416,7 +2426,7 @@ <h3>Browse all 54 scripts &rarr;</h3>
       document.getElementById('metaVersionRow').classList.toggle('d-none', !resource.version);
       
       document.getElementById('btnDetailOpen').href = resource.url;
-      
+
       const embedUrl = resource.artifact === 'interactive' && resource.source
         ? resource.source.replace(/README\.md$/i, 'index.html')
         : null;
@@ -2429,36 +2439,8 @@ <h3>Browse all 54 scripts &rarr;</h3>
         viewBtn.onclick = null;
       }
       
-      // Detail Vote Button
-      const detailVoteBtn = document.getElementById('btnDetailVote');
-      const voted = hasVoted(resource.slug);
-      detailVoteBtn.classList.toggle('voted', voted);
-      detailVoteBtn.setAttribute('aria-pressed', voted);
-      detailVoteBtn.setAttribute('aria-label', voted ? `Remove your upvote from ${resource.name}` : `Upvote ${resource.name}`);
-      detailVoteBtn.querySelector('.vote-count').textContent = formatCount(stats.upvotes);
-      detailVoteBtn.querySelector('svg').setAttribute('fill', voted ? 'currentColor' : 'none');
-      
-      // Replace the button entirely to clear old event listeners
-      const newBtn = detailVoteBtn.cloneNode(true);
-      detailVoteBtn.parentNode.replaceChild(newBtn, detailVoteBtn);
-      newBtn.addEventListener('click', (e) => {
-        e.preventDefault();
-        toggleVote(resource.slug);
-        const nowVoted = hasVoted(resource.slug);
-        if (nowVoted && typeof window.clarity !== 'undefined') {
-          window.clarity('set', 'upvoted_resource', resource.slug);
-          window.clarity('event', 'resource_upvote');
-        }
-        const newStats = getStats(resource);
-        newBtn.classList.toggle('voted', nowVoted);
-        newBtn.setAttribute('aria-pressed', nowVoted);
-        newBtn.setAttribute('aria-label', nowVoted ? `Remove your upvote from ${resource.name}` : `Upvote ${resource.name}`);
-        newBtn.querySelector('.vote-count').textContent = formatCount(newStats.upvotes);
-        newBtn.querySelector('svg').setAttribute('fill', nowVoted ? 'currentColor' : 'none');
-        newBtn.classList.remove('pop');
-        void newBtn.offsetWidth;
-        newBtn.classList.add('pop');
-      });
+      // Mount giscus discussion
+      mountGiscus(resource.slug, document.documentElement.getAttribute('data-theme'));
       
       // Related resources (up to 4 matching type, excluding self)
       const related = RESOURCES.filter(r => r.type === resource.type && r.slug !== resource.slug).slice(0, 4);
@@ -2471,6 +2453,7 @@ <h3>Browse all 54 scripts &rarr;</h3>
       
       // Clarity tracking
       if (typeof window.clarity !== 'undefined') {
+        window.clarity('set', 'page', location.pathname + location.hash);
         window.clarity('set', 'resource', resource.slug);
         window.clarity('event', 'resource_view');
       }
diff --git a/resource-discussions.json b/resource-discussions.json
new file mode 100644
index 00000000..54705f0b
--- /dev/null
+++ b/resource-discussions.json
@@ -0,0 +1,5 @@
+{
+  "repo": "microsoft/FastTrack",
+  "note": "Maps gallery resource slug -> GitHub Discussion number in the Resource Votes category.",
+  "map": {}
+}
diff --git a/resource-stats.json b/resource-stats.json
new file mode 100644
index 00000000..77a6e3e3
--- /dev/null
+++ b/resource-stats.json
@@ -0,0 +1,37 @@
+{
+  "generatedAt": "2026-07-21T18:20:40.181Z",
+  "sources": {
+    "views": "clarity",
+    "upvotes": "github-discussions"
+  },
+  "resources": {
+    "agents-cost-calculator": {
+      "views": 90,
+      "viewsUniques": 60
+    },
+    "ai-council": {
+      "views": 78,
+      "viewsUniques": 61
+    },
+    "autoreply-agent": {
+      "views": 69,
+      "viewsUniques": 46
+    },
+    "copilot-agents-guide": {
+      "views": 32,
+      "viewsUniques": 6
+    },
+    "powerclaw-agent": {
+      "views": 1632,
+      "viewsUniques": 961
+    },
+    "purview-audit-copilot-report": {
+      "views": 656,
+      "viewsUniques": 382
+    },
+    "viva-insights-copilot-dashboard": {
+      "views": 119,
+      "viewsUniques": 70
+    }
+  }
+}
diff --git a/tools/catalog-build/build-stats.js b/tools/catalog-build/build-stats.js
new file mode 100644
index 00000000..e498a5b1
--- /dev/null
+++ b/tools/catalog-build/build-stats.js
@@ -0,0 +1,414 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const toolDirectory = dirname(fileURLToPath(import.meta.url));
+const repositoryRoot = join(toolDirectory, '..', '..');
+const checkOnly = process.argv.includes('--check');
+const trafficDirectory = join(repositoryRoot, 'traffic-data');
+const clarityStatePath = join(trafficDirectory, 'clarity-views.json');
+const catalogPath = join(repositoryRoot, 'catalog.json');
+const discussionsPath = join(repositoryRoot, 'resource-discussions.json');
+const githubToken = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+const clarityToken = process.env.CLARITY_API_TOKEN;
+const dayMilliseconds = 24 * 60 * 60 * 1000;
+const runDate = new Date().toISOString().slice(0, 10);
+
+function readJson(path) {
+  return JSON.parse(readFileSync(path, 'utf8'));
+}
+
+function readOptionalJson(path, fallback) {
+  if (!existsSync(path)) return fallback;
+  try {
+    return readJson(path);
+  } catch (error) {
+    console.warn(`Warning: could not read ${path}: ${error.message}`);
+    return fallback;
+  }
+}
+
+function numberFrom(value) {
+  const number = typeof value === 'string' && value.trim() !== '' ? Number(value) : value;
+  return Number.isFinite(number) && number >= 0 ? number : undefined;
+}
+
+function logicalRepoPath(pathname) {
+  // Strip the `/owner/repo/(tree|blob)/<ref>/` prefix so `/tree/` folder views and
+  // `/blob/` file views normalize to the same repo-relative path. Repo-root and
+  // bare `/tree/<ref>` paths (which map to nothing) collapse to an empty string.
+  if (typeof pathname !== 'string') return '';
+  const stripped = pathname.replace(/^\/[^/]+\/[^/]+\/(?:tree|blob)\/[^/]+\//, '');
+  return stripped === pathname ? '' : stripped.replace(/\/+$/, '');
+}
+
+function collectFallbackViews(resourceFolders) {
+  if (!existsSync(trafficDirectory)) return new Map();
+
+  const snapshots = readdirSync(trafficDirectory)
+    .filter(file => /^\d{4}-\d{2}-\d{2}\.json$/.test(file))
+    .sort()
+    .map(file => ({
+      date: new Date(`${file.slice(0, 10)}T00:00:00Z`),
+      file
+    }))
+    .filter(snapshot => !Number.isNaN(snapshot.date.valueOf()));
+
+  const totals = new Map();
+  let lastAccepted;
+
+  for (const snapshot of snapshots) {
+    if (lastAccepted && snapshot.date - lastAccepted < 14 * dayMilliseconds) continue;
+
+    let data;
+    try {
+      data = readJson(join(trafficDirectory, snapshot.file));
+    } catch (error) {
+      console.warn(`Warning: skipping ${snapshot.file}: ${error.message}`);
+      continue;
+    }
+
+    lastAccepted = snapshot.date;
+    for (const entry of Array.isArray(data.paths) ? data.paths : []) {
+      if (typeof entry.path !== 'string' ||
+          !Number.isFinite(entry.count) ||
+          !Number.isFinite(entry.uniques)) continue;
+
+      // Roll a resource's own folder view and any traffic to files/subfolders beneath it
+      // into that resource. resourceFolders is sorted longest-first, so each path is
+      // credited to its most specific resource and never to an ancestor folder.
+      const logical = logicalRepoPath(entry.path);
+      if (!logical) continue;
+      const match = resourceFolders.find(
+        folder => logical === folder.path || logical.startsWith(`${folder.path}/`)
+      );
+      if (!match) continue;
+
+      const total = totals.get(match.slug) ?? { views: 0, viewsUniques: 0 };
+      total.views += entry.count;
+      total.viewsUniques += entry.uniques;
+      totals.set(match.slug, total);
+    }
+  }
+
+  return totals;
+}
+
+function slugFromClarityUrl(value, knownSlugs) {
+  if (typeof value !== 'string') return undefined;
+  try {
+    const slug = decodeURIComponent(new URL(value).hash.slice(1));
+    return knownSlugs.has(slug) ? slug : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+function dateFromClarityRow(row) {
+  const value = row.date ?? row.Date ?? row.day ?? row.Day;
+  if (typeof value !== 'string') return undefined;
+  const match = value.match(/^\d{4}-\d{2}-\d{2}/);
+  return match?.[0];
+}
+
+function metricsFromClarityRow(row) {
+  const explicitViews = numberFrom(
+    row.pageViews ?? row.pageviews ?? row.PageViews ?? row.views ??
+    row.totalScreenCount ?? row.visitsCount
+  );
+  const sessions = numberFrom(row.totalSessionCount ?? row.sessions ?? row.sessionCount);
+  const pagesPerSession = numberFrom(
+    row.pagesPerSession ?? row.PagesPerSession ?? row.PagesPerSessionPercentage
+  );
+  const views = explicitViews ?? (
+    sessions !== undefined && pagesPerSession !== undefined
+      ? sessions * pagesPerSession
+      : sessions
+  );
+  const uniques = numberFrom(
+    row.distinctUserCount ?? row.distantUserCount ?? row.uniqueUserCount ??
+    row.uniqueUsers ?? row.users
+  );
+  return {
+    ...(views !== undefined ? { views: Math.round(views) } : {}),
+    ...(uniques !== undefined ? { uniques: Math.round(uniques) } : {})
+  };
+}
+
+function parseClarityTraffic(data, knownSlugs) {
+  const traffic = Array.isArray(data)
+    ? data.find(metric => metric?.metricName === 'Traffic')
+    : undefined;
+  const totals = new Map();
+  const dated = new Map();
+
+  for (const row of Array.isArray(traffic?.information) ? traffic.information : []) {
+    const slug = slugFromClarityUrl(row.URL ?? row.Url ?? row.url, knownSlugs);
+    if (!slug) continue;
+    const metrics = metricsFromClarityRow(row);
+    if (metrics.views === undefined) continue;
+
+    const date = dateFromClarityRow(row);
+    const target = date
+      ? (dated.get(date) ?? new Map())
+      : totals;
+    const current = target.get(slug) ?? { views: 0 };
+    current.views += metrics.views;
+    if (metrics.uniques !== undefined) current.uniques = (current.uniques ?? 0) + metrics.uniques;
+    target.set(slug, current);
+    if (date) dated.set(date, target);
+  }
+
+  return { totals, dated };
+}
+
+async function fetchClarity(days, knownSlugs) {
+  const url = new URL('https://www.clarity.ms/export-data/api/v1/project-live-insights');
+  url.searchParams.set('numOfDays', String(days));
+  url.searchParams.set('dimension1', 'URL');
+  const response = await fetch(url, {
+    headers: {
+      Authorization: `Bearer ${clarityToken}`,
+      Accept: 'application/json'
+    }
+  });
+  if (!response.ok) throw new Error(`Clarity returned ${response.status}`);
+  return parseClarityTraffic(await response.json(), knownSlugs);
+}
+
+function subtractClarityTotals(larger, smaller) {
+  const result = new Map();
+  for (const [slug, metrics] of larger) {
+    const previous = smaller.get(slug);
+    const views = metrics.views - (previous?.views ?? 0);
+    if (views < 0) {
+      console.warn(`Warning: Clarity returned a negative window difference for ${slug}; skipping it.`);
+      continue;
+    }
+    const entry = { views: Math.round(views) };
+    if (metrics.uniques !== undefined && previous?.uniques !== undefined) {
+      const uniques = metrics.uniques - previous.uniques;
+      if (uniques >= 0) entry.uniques = Math.round(uniques);
+    }
+    result.set(slug, entry);
+  }
+  return result;
+}
+
+function mapToObject(map) {
+  return Object.fromEntries([...map].sort(([left], [right]) => left.localeCompare(right)));
+}
+
+async function updateClarityState(state, knownSlugs) {
+  if (!clarityToken) {
+    console.log('CLARITY_API_TOKEN is not set; preserving accumulated Clarity views.');
+    return false;
+  }
+
+  try {
+    const threeDays = await fetchClarity(3, knownSlugs);
+    if (threeDays.dated.size > 0) {
+      for (const [date, bucket] of threeDays.dated) state.days[date] = mapToObject(bucket);
+    } else {
+      // The API normally returns rolling aggregates rather than dates. Cumulative 1/2/3-day
+      // windows are differenced so each run persists overlap-safe daily buckets.
+      const [twoDays, oneDay] = await Promise.all([
+        fetchClarity(2, knownSlugs),
+        fetchClarity(1, knownSlugs)
+      ]);
+      const dates = [0, 1, 2].map(offset =>
+        new Date(Date.parse(`${runDate}T00:00:00Z`) - offset * dayMilliseconds)
+          .toISOString().slice(0, 10)
+      );
+      state.days[dates[0]] = mapToObject(oneDay.totals);
+      state.days[dates[1]] = mapToObject(subtractClarityTotals(twoDays.totals, oneDay.totals));
+      state.days[dates[2]] = mapToObject(subtractClarityTotals(threeDays.totals, twoDays.totals));
+    }
+    state.lastRun = runDate;
+    return true;
+  } catch (error) {
+    console.warn(`Warning: could not collect Clarity views: ${error.message}`);
+    return false;
+  }
+}
+
+function collectClarityViews(state, knownSlugs) {
+  const totals = new Map();
+  for (const bucket of Object.values(state.days)) {
+    if (!bucket || typeof bucket !== 'object') continue;
+    for (const [slug, metrics] of Object.entries(bucket)) {
+      if (!knownSlugs.has(slug) || !metrics || typeof metrics !== 'object') continue;
+      const views = numberFrom(metrics.views);
+      if (views === undefined) continue;
+      const total = totals.get(slug) ?? { views: 0 };
+      total.views += Math.round(views);
+      const uniques = numberFrom(metrics.uniques);
+      if (uniques !== undefined) total.viewsUniques = (total.viewsUniques ?? 0) + Math.round(uniques);
+      totals.set(slug, total);
+    }
+  }
+  return totals;
+}
+
+async function githubGraphql(query, variables) {
+  const response = await fetch('https://api.github.com/graphql', {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${githubToken}`,
+      Accept: 'application/vnd.github+json',
+      'Content-Type': 'application/json',
+      'User-Agent': 'fasttrack-stats'
+    },
+    body: JSON.stringify({ query, variables })
+  });
+  if (!response.ok) throw new Error(`GitHub returned ${response.status}`);
+  const payload = await response.json();
+  if (payload.errors?.length) throw new Error(payload.errors.map(error => error.message).join('; '));
+  return payload.data;
+}
+
+async function collectDiscussions() {
+  const discussions = [];
+  if (!githubToken) {
+    console.log('GITHUB_TOKEN or GH_TOKEN is not set; skipping discussion upvotes.');
+    return discussions;
+  }
+
+  const query = `query($owner:String!,$name:String!,$after:String) {
+    repository(owner:$owner,name:$name) {
+      discussions(first:100,after:$after) {
+        pageInfo { hasNextPage endCursor }
+        nodes {
+          number
+          url
+          title
+          category { name }
+          reactionGroups { content reactors { totalCount } }
+        }
+      }
+    }
+  }`;
+  let after = null;
+  try {
+    do {
+      const data = await githubGraphql(query, { owner: 'microsoft', name: 'FastTrack', after });
+      const connection = data?.repository?.discussions;
+      if (!connection) throw new Error('GitHub did not return the discussions connection');
+      discussions.push(...connection.nodes.filter(
+        discussion => discussion?.category?.name === 'Resource Votes'
+      ));
+      after = connection.pageInfo.hasNextPage ? connection.pageInfo.endCursor : null;
+    } while (after);
+  } catch (error) {
+    console.warn(`Warning: could not collect GitHub Discussions: ${error.message}`);
+    return [];
+  }
+  return discussions;
+}
+
+function mapDiscussions(discussions, knownSlugs, explicitMap) {
+  const byNumber = new Map(discussions.map(discussion => [discussion.number, discussion]));
+  const result = new Map();
+
+  for (const slug of knownSlugs) {
+    const hasExplicitMapping = Object.hasOwn(explicitMap, slug);
+    const mappedNumber = explicitMap[slug];
+    let discussion;
+    if (hasExplicitMapping) {
+      discussion = Number.isInteger(mappedNumber) ? byNumber.get(mappedNumber) : undefined;
+      if (!discussion) {
+        console.warn(`Warning: mapped discussion #${mappedNumber} for ${slug} was not found.`);
+        continue;
+      }
+    } else {
+      discussion = discussions.find(item => item.title === slug) ??
+        discussions.find(item => item.title.includes(slug));
+    }
+    if (!discussion) continue;
+    const thumbsUp = discussion.reactionGroups?.find(group => group.content === 'THUMBS_UP');
+    const count = thumbsUp?.reactors?.totalCount;
+    if (!Number.isInteger(count) || count < 0) {
+      console.warn(`Warning: discussion #${discussion.number} has no THUMBS_UP count.`);
+      continue;
+    }
+    result.set(slug, {
+      upvotes: count,
+      discussion: { number: discussion.number, url: discussion.url }
+    });
+  }
+  return result;
+}
+
+const catalog = readJson(catalogPath);
+const knownSlugs = new Set(catalog.resources.map(resource => resource.slug));
+const resourceFolders = catalog.resources
+  .map(resource => {
+    try {
+      return { slug: resource.slug, path: logicalRepoPath(new URL(resource.url).pathname) };
+    } catch {
+      console.warn(`Warning: could not parse URL for ${resource.slug}.`);
+      return { slug: resource.slug, path: '' };
+    }
+  })
+  .filter(folder => folder.path)
+  .sort((left, right) => right.path.length - left.path.length);
+const discussionConfig = readOptionalJson(discussionsPath, {
+  repo: 'microsoft/FastTrack',
+  note: 'Maps gallery resource slug -> GitHub Discussion number in the Resource Votes category.',
+  map: {}
+});
+const clarityState = readOptionalJson(clarityStatePath, { lastRun: '', days: {} });
+if (!clarityState.days || typeof clarityState.days !== 'object') clarityState.days = {};
+
+const clarityChanged = await updateClarityState(clarityState, knownSlugs);
+const clarityViews = collectClarityViews(clarityState, knownSlugs);
+const fallbackViews = collectFallbackViews(resourceFolders);
+const discussions = await collectDiscussions();
+const upvoteTotals = mapDiscussions(discussions, knownSlugs, discussionConfig.map ?? {});
+const resources = {};
+let viewCount = 0;
+let upvoteCount = 0;
+
+for (const resource of catalog.resources) {
+  const stats = {};
+  const clarity = clarityViews.get(resource.slug);
+  const fallback = fallbackViews.get(resource.slug);
+
+  // Clarity is authoritative once it has a nonzero cumulative total; legacy GitHub
+  // path traffic only prevents existing resources from losing views during migration.
+  const views = clarity?.views > 0 ? clarity : fallback;
+  if (views) {
+    Object.assign(stats, views);
+    viewCount += 1;
+  }
+
+  const upvotes = upvoteTotals.get(resource.slug);
+  if (upvotes) {
+    Object.assign(stats, upvotes);
+    upvoteCount += 1;
+  }
+
+  if (Object.keys(stats).length > 0) resources[resource.slug] = stats;
+}
+
+const output = `${JSON.stringify({
+  generatedAt: new Date().toISOString(),
+  sources: {
+    views: 'clarity',
+    upvotes: 'github-discussions'
+  },
+  resources
+}, null, 2)}\n`;
+
+if (!checkOnly) {
+  mkdirSync(trafficDirectory, { recursive: true });
+  writeFileSync(join(repositoryRoot, 'resource-stats.json'), output);
+  if (!existsSync(discussionsPath)) {
+    writeFileSync(discussionsPath, `${JSON.stringify(discussionConfig, null, 2)}\n`);
+  }
+  if (clarityChanged || !existsSync(clarityStatePath)) {
+    writeFileSync(clarityStatePath, `${JSON.stringify(clarityState, null, 2)}\n`);
+  }
+}
+
+console.log(`${checkOnly ? 'Checked' : 'Wrote'} real stats for ${viewCount} resource${viewCount === 1 ? '' : 's'} with views and ${upvoteCount} resource${upvoteCount === 1 ? '' : 's'} with upvotes.`);
diff --git a/tools/catalog-build/create-vote-discussions.js b/tools/catalog-build/create-vote-discussions.js
new file mode 100644
index 00000000..1c337afc
--- /dev/null
+++ b/tools/catalog-build/create-vote-discussions.js
@@ -0,0 +1,120 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const toolDirectory = dirname(fileURLToPath(import.meta.url));
+const repositoryRoot = join(toolDirectory, '..', '..');
+const catalogPath = join(repositoryRoot, 'catalog.json');
+const discussionsPath = join(repositoryRoot, 'resource-discussions.json');
+const confirmed = process.argv.includes('--yes');
+const token = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+
+function readJson(path) {
+  return JSON.parse(readFileSync(path, 'utf8'));
+}
+
+function writeDiscussions(config) {
+  writeFileSync(discussionsPath, `${JSON.stringify(config, null, 2)}\n`);
+}
+
+async function graphql(query, variables) {
+  const response = await fetch('https://api.github.com/graphql', {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${token}`,
+      Accept: 'application/vnd.github+json',
+      'Content-Type': 'application/json',
+      'User-Agent': 'fasttrack-stats'
+    },
+    body: JSON.stringify({ query, variables })
+  });
+  if (!response.ok) throw new Error(`GitHub returned ${response.status}: ${await response.text()}`);
+  const payload = await response.json();
+  if (payload.errors?.length) throw new Error(payload.errors.map(error => error.message).join('; '));
+  return payload.data;
+}
+
+async function resolveRepositoryAndCategory(repo) {
+  const [owner, name] = repo.split('/');
+  const query = `query($owner:String!,$name:String!) {
+    repository(owner:$owner,name:$name) {
+      id
+      discussionCategories(first:100) { nodes { id name } }
+    }
+  }`;
+  const repository = (await graphql(query, { owner, name }))?.repository;
+  if (!repository) throw new Error(`Repository ${repo} was not found.`);
+  const category = repository.discussionCategories.nodes.find(
+    item => item.name === 'Resource Votes'
+  );
+  if (!category) throw new Error('Discussion category "Resource Votes" was not found.');
+  return { repositoryId: repository.id, categoryId: category.id };
+}
+
+async function createDiscussion(repositoryId, categoryId, resource) {
+  const mutation = `mutation($input:CreateDiscussionInput!) {
+    createDiscussion(input:$input) {
+      discussion { number url }
+    }
+  }`;
+  const body = [
+    'React with 👍 to upvote this resource in the FastTrack gallery.',
+    '',
+    `Resource: ${resource.url}`,
+    `Slug: \`${resource.slug}\``
+  ].join('\n');
+  return (await graphql(mutation, {
+    input: {
+      repositoryId,
+      categoryId,
+      title: resource.slug,
+      body
+    }
+  })).createDiscussion.discussion;
+}
+
+const catalog = readJson(catalogPath);
+const discussionConfig = existsSync(discussionsPath)
+  ? readJson(discussionsPath)
+  : {
+      repo: 'microsoft/FastTrack',
+      note: 'Maps gallery resource slug -> GitHub Discussion number in the Resource Votes category.',
+      map: {}
+    };
+discussionConfig.map ??= {};
+const pending = catalog.resources.filter(
+  resource => !Object.hasOwn(discussionConfig.map, resource.slug)
+);
+
+console.log('Note: this legacy filename now creates GitHub Discussions, not issues.');
+if (pending.length === 0) {
+  console.log('All catalog resources already have entries in resource-discussions.json.');
+} else if (!confirmed) {
+  console.log(`Dry run: would create ${pending.length} discussion${pending.length === 1 ? '' : 's'} in ${discussionConfig.repo}:`);
+  for (const resource of pending) console.log(`- ${resource.slug}`);
+  console.log('Re-run with --yes to create them.');
+  if (!token) console.log('Set GITHUB_TOKEN or GH_TOKEN before re-running with --yes.');
+} else if (!token) {
+  console.error('Set GITHUB_TOKEN or GH_TOKEN before creating discussions.');
+  process.exitCode = 1;
+} else {
+  try {
+    const ids = await resolveRepositoryAndCategory(discussionConfig.repo);
+    let created = 0;
+    for (const resource of pending) {
+      try {
+        const discussion = await createDiscussion(ids.repositoryId, ids.categoryId, resource);
+        discussionConfig.map[resource.slug] = discussion.number;
+        writeDiscussions(discussionConfig);
+        created += 1;
+        console.log(`Created #${discussion.number}: ${resource.slug} (${discussion.url})`);
+      } catch (error) {
+        console.warn(`Warning: could not create discussion for ${resource.slug}: ${error.message}`);
+      }
+    }
+    console.log(`Created ${created} of ${pending.length} vote discussions.`);
+  } catch (error) {
+    console.error(`Could not prepare discussion creation: ${error.message}`);
+    process.exitCode = 1;
+  }
+}
diff --git a/tools/catalog-build/package.json b/tools/catalog-build/package.json
index e507c2be..e321932a 100644
--- a/tools/catalog-build/package.json
+++ b/tools/catalog-build/package.json
@@ -5,7 +5,10 @@
   "type": "module",
   "scripts": {
     "build": "node index.js",
-    "check": "node index.js --check"
+    "check": "node index.js --check",
+    "build:stats": "node build-stats.js",
+    "check:stats": "node build-stats.js --check",
+    "create:vote-discussions": "node create-vote-discussions.js"
   },
   "devDependencies": {
     "gray-matter": "^4.0.3",
diff --git a/traffic-data/clarity-views.json b/traffic-data/clarity-views.json
new file mode 100644
index 00000000..d483a7a1
--- /dev/null
+++ b/traffic-data/clarity-views.json
@@ -0,0 +1,4 @@
+{
+  "lastRun": "",
+  "days": {}
+}