docs: close 11 accuracy defects between idstack.org and the repo

.github/workflows/static.yml

@@ -33,11 +33,22 @@ jobs:
         uses: actions/checkout@v4
       - name: Setup Pages
         uses: actions/configure-pages@v5
+      - name: Stage publishable files
+        # docs/ holds two things that must exist in the repo but not on the
+        # site: internal design docs (the brainstorming skill writes specs to
+        # docs/superpowers/ by default, so relocating them is not enough --
+        # its next run recreates the directory) and og-template.html (the OG
+        # card's regenerable source, which smoke-test.sh asserts exists at
+        # that exact path, so it cannot be moved). Stage a copy and drop both.
+        run: |
+          rm -rf _site
+          cp -R docs _site
+          rm -rf _site/superpowers
+          rm -f _site/og-template.html
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          # Upload entire repository
-          path: 'docs'
+          path: '_site'
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v5

.gitignore

@@ -7,3 +7,5 @@
 *~
 idstack/
 .gstack/
+_site/
+.superpowers/

docs/index.html

@@ -41,10 +41,9 @@
     "description": "Open-source instructional design skills backed by peer-reviewed research across 11 domains. Every recommendation cites its evidence tier. Runs in Claude Code.",
     "url": "https://idstack.org",
     "applicationCategory": "EducationalApplication",
-    "operatingSystem": "macOS, Linux, Windows",
+    "operatingSystem": "macOS, Linux, Windows (WSL or Git Bash)",
     "softwareVersion": "3.4.0.1",
     "datePublished": "2026-04-20",
-    "dateModified": "2026-08-06",
     "offers": {
       "@type": "Offer",
       "price": "0",
@@ -1010,7 +1009,7 @@ <h3 class="evidence-card-title">Accessibility &amp; Universal Design for Learnin
       <header class="section-header">
         <p class="eyebrow">Pipeline</p>
         <h2 id="pipeline-title">Eleven skills. Pipeline optional.</h2>
-        <p class="lede">Eight of them run end-to-end as the standard sequence; two utilities (course-import and learn) sit outside it. Use one command for the full pipeline, or invoke any skill on its own — none of them require an existing manifest.</p>
+        <p class="lede">Eight run end-to-end as the standard sequence, <code>/idstack:pipeline</code> orchestrates them, and two utilities (course-import and learn) sit outside the chain. Invoke any skill on its own — none of them require an existing manifest.</p>
       </header>
 
       <div class="pipeline-canvas">
@@ -1124,7 +1123,7 @@ <h3>
     <section class="section" id="install" aria-labelledby="install-title">
       <header class="section-header">
         <p class="eyebrow">Install</p>
-        <h2 id="install-title">Install in about five minutes.</h2>
+        <h2 id="install-title">Install in 30 seconds.</h2>
       </header>
 
       <div class="install-block" role="group" aria-label="Install command">
@@ -1135,6 +1134,10 @@ <h2 id="install-title">Install in about five minutes.</h2>
 
       <p class="install-prose"><code>./setup</code> registers idstack with Claude Code and installs all 11 skills. Re-run it after a <code>git pull</code> to update.</p>
 
+      <p class="install-prose">Requires a bash shell — Terminal on macOS or Linux, WSL or Git Bash on Windows. <code>./setup</code> is a bash script, so PowerShell and <code>cmd</code> can't run it. python3 is recommended but not required; without it, quality-score trends and search filtering are unavailable.</p>
+
+      <p class="install-prose">If something looks wrong afterwards, <code>bin/idstack-doctor</code> diagnoses the plugin registration, and <code>bin/idstack-status</code> reports course health from inside a project directory.</p>
+
       <p class="install-prose">New to Claude Code? <a href="https://claude.ai/download" rel="noopener">Download it first</a> (free), then paste the command above. When Claude Code starts, run <code>/idstack:pipeline</code>.</p>
     </section>
 
@@ -1150,7 +1153,7 @@ <h2 id="whatsnew-title">v3.4.0.0 — idstack is a Claude Code plugin.</h2>
         <h3>One host, supported properly.</h3>
         <p>idstack shipped an OpenAI Codex CLI build from v2.5.0.0 through v3.3.0.4. It is removed. Every skill, the evidence base, the project manifest, and the HTML reports are unchanged — idstack now targets Claude Code and nothing else, which is the only place it was ever tested end to end.</p> <!-- IDSTACK_CLI_LEAK_ALLOW: dated release note, not a capability claim -->
         <p>To update: <code>cd</code> into your idstack clone, then <code>git pull &amp;&amp; ./setup</code>. If you had the Codex build installed, <code>./setup</code> can no longer clean it up — the <a href="https://github.com/savvides/idstack/blob/main/CHANGELOG.md" rel="noopener">release notes</a> carry the two paths to remove.</p> <!-- IDSTACK_CLI_LEAK_ALLOW: dated release note, not a capability claim -->
-        <p>Patched in v3.4.0.1 (August 7): three evidence cards on this page overstated their domain's evidence tier. They are derived from <code>evidence/references.md</code> now, and the test suite fails if they ever disagree again.</p>
+        <p>Patched in v3.4.0.1 (August 7): three evidence cards on this page overstated their domain's evidence tier. They are derived from <code>evidence/references.md</code> now, and the test suite fails if they ever disagree again. The same patch added the outbound Canvas API upload in <code>/idstack:course-export</code> and the <code>git fetch</code> in <code>bin/idstack-update-check</code> to <a href="https://github.com/savvides/idstack/blob/main/PRIVACY.md" rel="noopener">the privacy policy</a>, and named WSL or Git Bash in the Windows install instructions.</p>
       </article>
 
       <article class="release-card">
@@ -1177,6 +1180,7 @@ <h3>Welcome-back messages work on stock macOS now.</h3>
       <div class="footer-links">
         <a href="https://github.com/savvides/idstack" rel="noopener">GitHub</a>
         <a href="https://github.com/savvides/idstack/blob/main/LICENSE" rel="noopener">MIT License</a>
+        <a href="https://github.com/savvides/idstack/blob/main/PRIVACY.md" rel="noopener">Privacy</a>
         <a href="https://github.com/savvides/idstack/blob/main/CONTRIBUTING.md" rel="noopener">Contribute</a>
         <a href="https://github.com/savvides/idstack/blob/main/ROADMAP.md" rel="noopener">Roadmap</a>
         <a href="https://forms.gle/6LDgDD1M6WWyYvME8" rel="noopener">Feedback</a>

docs/sitemap.xml

@@ -2,7 +2,6 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://idstack.org/</loc>
-    <lastmod>2026-05-13</lastmod>
     <changefreq>weekly</changefreq>
     <priority>1.0</priority>
   </url>