diff --git a/site/content/tutorials/getting-started.md b/site/content/tutorials/getting-started.md
index 303031dce..10a25b7dc 100644
--- a/site/content/tutorials/getting-started.md
+++ b/site/content/tutorials/getting-started.md
@@ -36,6 +36,11 @@ npx impeccable install
 
 ## Step 1. Install
 
+<div class="docs-note">
+  <span class="docs-note-icon" aria-hidden="true"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M23.922 16.992c-.861 1.495-5.859 5.023-11.922 5.023-6.063 0-11.061-3.528-11.922-5.023A.641.641 0 0 1 0 16.736v-2.869a.841.841 0 0 1 .053-.22c.372-.935 1.347-2.292 2.605-2.656.167-.429.414-1.055.644-1.517a10.195 10.195 0 0 1-.052-1.086c0-1.331.282-2.499 1.132-3.368.397-.406.89-.717 1.474-.952 1.399-1.136 3.392-2.093 6.122-2.093 2.731 0 4.767.957 6.166 2.093.584.235 1.077.546 1.474.952.85.869 1.132 2.037 1.132 3.368 0 .368-.014.733-.052 1.086.23.462.477 1.088.644 1.517 1.258.364 2.233 1.721 2.605 2.656a.832.832 0 0 1 .053.22v2.869a.641.641 0 0 1-.078.256ZM12.172 11h-.344a4.323 4.323 0 0 1-.355.508C10.703 12.455 9.555 13 7.965 13c-1.725 0-2.989-.359-3.782-1.259a2.005 2.005 0 0 1-.085-.104L4 11.741v6.585c1.435.779 4.514 2.179 8 2.179 3.486 0 6.565-1.4 8-2.179v-6.585l-.098-.104s-.033.045-.085.104c-.793.9-2.057 1.259-3.782 1.259-1.59 0-2.738-.545-3.508-1.492a4.323 4.323 0 0 1-.355-.508h-.016.016Zm.641-2.935c.136 1.057.403 1.913.878 2.497.442.544 1.134.938 2.344.938 1.573 0 2.292-.337 2.657-.751.384-.435.558-1.15.558-2.361 0-1.14-.243-1.847-.705-2.319-.477-.488-1.319-.862-2.824-1.025-1.487-.161-2.192.138-2.533.529-.269.307-.437.808-.438 1.578v.021c0 .265.021.562.063.893Zm-1.626 0c.042-.331.063-.628.063-.894v-.02c-.001-.77-.169-1.271-.438-1.578-.341-.391-1.046-.69-2.533-.529-1.505.163-2.347.537-2.824 1.025-.462.472-.705 1.179-.705 2.319 0 1.211.175 1.926.558 2.361.365.414 1.084.751 2.657.751 1.21 0 1.902-.394 2.344-.938.475-.584.742-1.44.878-2.497Z"/><path d="M14.5 14.25a1 1 0 0 1 1 1v2a1 1 0 0 1-2 0v-2a1 1 0 0 1 1-1Zm-5 0a1 1 0 0 1 1 1v2a1 1 0 0 1-2 0v-2a1 1 0 0 1 1-1Z"/></svg></span>
+  <span class="docs-note-text"><strong>On the GitHub Copilot app?</strong> Impeccable is built in. Skip the install below and enable it under <strong>Settings &rarr; Experimental</strong>.</span>
+</div>
+
 From the root of your project, run:
 
 ```
@@ -44,8 +49,6 @@ npx impeccable install
 
 This auto-detects your AI coding tool and writes the right skill files for it (for example, `.claude/skills/` or `.cursor/skills/`). It works with Cursor, Claude Code, GitHub Copilot, Gemini CLI, Codex CLI, and every other major harness. Reload your tool and type `/`. You should see `/impeccable` in the autocomplete. Type it and the argument hint will show the available commands.
 
-**On the GitHub Copilot app?** Impeccable is built in. Skip the install above and enable it under **Settings → Experimental**, then jump to step 2.
-
 Prefer a different setup? Claude Code users can install the plugin with `/plugin marketplace add pbakaus/impeccable`, and the general-purpose `npx skills add pbakaus/impeccable` still works (though it installs one shared build for all harnesses rather than the one compiled for yours).
 
 When a new version ships later, run `npx impeccable update` from the same project root. `npx impeccable check` tells you first whether you are behind, and plugin users update from the `/plugin` menu instead.
diff --git a/site/styles/docs-kinpaku.css b/site/styles/docs-kinpaku.css
index 2e1e628fa..19779ec79 100644
--- a/site/styles/docs-kinpaku.css
+++ b/site/styles/docs-kinpaku.css
@@ -1124,11 +1124,51 @@ html.light .docs-kinpaku {
 .docs-kinpaku .prose > * + pre,
 .docs-kinpaku .prose > blockquote + *,
 .docs-kinpaku .prose > * + blockquote,
+.docs-kinpaku .prose > .docs-note + *,
+.docs-kinpaku .prose > * + .docs-note,
 .docs-kinpaku .prose > hr + *,
 .docs-kinpaku .prose > * + hr {
   margin-top: 1.4em;
 }
 
+/* Note / callout block for prose docs (e.g. the GitHub Copilot built-in
+   aside under Step 1). Full hairline frame + faint gold-tinted ground so it
+   reads as an aside without a one-sided accent stripe (the side-tab tell the
+   detector flags). The gold icon carries the accent. */
+.docs-kinpaku .prose .docs-note {
+  display: flex;
+  align-items: flex-start;
+  gap: 12px;
+  padding: 14px 16px;
+  background: color-mix(in oklch, var(--ks-kinpaku) 6%, var(--ks-lacquer-raised));
+  border: 1px solid var(--ks-rule);
+  border-radius: 4px;
+  font-size: 0.95rem;
+  line-height: 1.55;
+  color: var(--ks-text);
+}
+.docs-kinpaku .prose .docs-note-icon {
+  flex: none;
+  width: 20px;
+  height: 20px;
+  margin-top: 1px;
+  color: var(--ks-kinpaku);
+}
+.docs-kinpaku .prose .docs-note-icon svg {
+  display: block;
+  width: 100%;
+  height: 100%;
+  fill: currentColor;
+}
+.docs-kinpaku .prose .docs-note-text {
+  flex: 1 1 auto;
+  min-width: 0;
+}
+.docs-kinpaku .prose .docs-note-text strong {
+  color: var(--ks-champagne);
+  font-weight: 600;
+}
+
 .docs-kinpaku .prose h1,
 .docs-kinpaku .prose h2,
 .docs-kinpaku .prose h3,