You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@magpie.apache.org by po...@apache.org on 2026/06/27 21:32:44 UTC

(magpie-site) 01/01: Refresh content from apache/magpie + publish to magpie.apache.org

This is an automated email from the ASF dual-hosted git repository.

potiuk pushed a commit to branch refresh/magpie-content-asf-publish
in repository https://gitbox.apache.org/repos/asf/magpie-site.git

commit c91d2390fff8a2ea6de5391e7d767e8538280ada
Author: Jarek Potiuk <ja...@potiuk.com>
AuthorDate: Sat Jun 27 17:29:49 2026 -0400

    Refresh content from apache/magpie + publish to magpie.apache.org
    
    Content refresh (latest apache/magpie main):
    - Rename apache/airflow-steward -> apache/magpie everywhere (links,
      sync source, CI, .gitignore)
    - Correct mode statuses on the Features page to match docs/modes.md:
      Triage stable, Mentoring experimental, Drafting stable (security),
      Pairing experimental, Auto-merge off
    - Add a "7 Skill Families" section (setup, security, pr-management,
      issue, release-management, mentoring, utilities)
    - Rebuild the security section around the real privacy/security posture
      (sandbox, privacy-aware routing, PII redaction, audit log, pinned deps,
      human-in-the-loop)
    - Status badge -> "Apache Top-Level Project"; refreshed hero copy
    - Equal-height cards (auto-rows-fr) for the families and security grids;
      uniform hero pipeline boxes
    - Docs: hide the internal board-resolution draft, lead with a Quick Start
    
    Deployment:
    - Publish to magpie.apache.org via ASF infra: CI force-pushes the build
      to a `publish` branch; add .asf.yaml (publish.whoami=publish,
      hostname=magpie.apache.org)
    - Serve at the apex root: base '/', site https://magpie.apache.org
      (env-overridable via SITE_BASE / SITE_URL)
    
    Generated-by: Claude Opus 4.8 (1M context)
---
 .asf.yaml                                        |  25 +++
 .github/workflows/build.yml                      |  41 ++--
 .gitignore                                       |   2 +-
 README.md                                        |  32 +--
 astro.config.mjs                                 |   9 +-
 scripts/sync-docs.sh                             |   4 +-
 src/components/landing/ImmersiveGradientHero.tsx | 260 ++++++++++++++++-------
 src/components/landing/SiteFooter.tsx            |  12 +-
 src/components/landing/SiteHeader.tsx            |   6 +-
 src/layouts/DocsLayout.astro                     |  16 +-
 src/pages/docs/[...slug].astro                   |  12 +-
 src/pages/docs/index.astro                       |  38 +++-
 12 files changed, 313 insertions(+), 144 deletions(-)

diff --git a/.asf.yaml b/.asf.yaml
new file mode 100644
index 0000000..1935021
--- /dev/null
+++ b/.asf.yaml
@@ -0,0 +1,25 @@
+# Apache Software Foundation repository configuration.
+# https://cwiki.apache.org/confluence/display/INFRA/Git+-+.asf.yaml+features
+#
+# The `github:` block below is applied from the default branch (main).
+# The `publish:` block is what serves the website: ASF infra publishes the
+# branch named in `whoami` to the given hostname. CI builds the site and
+# force-pushes the generated output (this file included) to the `publish`
+# branch, where `whoami: publish` matches and the site goes live at
+# https://magpie.apache.org/. On `main`, `whoami` does not match the branch
+# name, so nothing is published from here.
+
+github:
+  description: "Website for Apache Magpie — agent-assisted repository maintainership and development."
+  homepage: https://magpie.apache.org/
+  labels:
+    - apache
+    - magpie
+    - website
+    - astro
+  features:
+    issues: true
+
+publish:
+  whoami: publish
+  hostname: magpie.apache.org
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index fd64e9c..97ab8db 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -9,17 +9,17 @@ on:
 
 permissions:
   contents: read
-  pages: write
-  id-token: write
 
 concurrency:
-  group: pages
+  group: build-${{ github.ref }}
   cancel-in-progress: false
 
 jobs:
   build:
     runs-on: ubuntu-latest
     timeout-minutes: 10
+    permissions:
+      contents: write # needed to push the built site to the `publish` branch
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -33,9 +33,9 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
-      - name: Sync docs from apache/airflow-steward
+      - name: Sync docs from apache/magpie
         env:
-          MAGPIE_DOCS_REPO: https://github.com/apache/airflow-steward.git
+          MAGPIE_DOCS_REPO: https://github.com/apache/magpie.git
           MAGPIE_DOCS_BRANCH: main
         run: npm run sync-docs
 
@@ -46,20 +46,19 @@ jobs:
       - name: Build
         run: npm run build
 
-      - name: Upload Pages artifact
+      - name: Publish site to "publish" branch
         if: github.ref == 'refs/heads/main'
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: dist
-
-  deploy:
-    if: github.ref == 'refs/heads/main'
-    needs: build
-    runs-on: ubuntu-latest
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # Carry the ASF publish config into the generated branch so infra
+          # serves it at https://magpie.apache.org/ (whoami: publish).
+          cp .asf.yaml dist/.asf.yaml
+          cd dist
+          git init -q
+          git checkout -q -b publish
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add -A
+          git commit -q -m "Publish site (${GITHUB_SHA::7})"
+          git push -f "https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git" publish
diff --git a/.gitignore b/.gitignore
index be2da54..3469968 100644
--- a/.gitignore
+++ b/.gitignore
@@ -36,6 +36,6 @@ pnpm-debug.log*
 CLAUDE.md
 **/settings.local.json
 **/scheduled_tasks.lock
-.apache-steward/
+.apache-magpie/
 docs/superpowers/
 .subframe/
diff --git a/README.md b/README.md
index 0ca7270..c3f80c9 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
 # Apache Magpie — Website
 
-Landing page and documentation hub for [Apache Magpie](https://github.com/apache/airflow-steward), an AI-powered assistant that helps open-source maintainers manage contributions more efficiently.
+Landing page and documentation hub for [Apache Magpie](https://github.com/apache/magpie), an AI assistant that helps open-source maintainers handle the repetitive parts of running a project — triage, mentoring, drafting fixes, and security-report handling — so they can focus on the work that needs a human.
 
-> Status: **incubating** under the Apache Software Foundation. Project source lives at [apache/airflow-steward](https://github.com/apache/airflow-steward); this repo holds the public website.
+> Status: **Apache Top-Level Project**. Project source lives at [apache/magpie](https://github.com/apache/magpie); this repo holds the public website.
 
 ## Stack
 
@@ -12,7 +12,7 @@ Landing page and documentation hub for [Apache Magpie](https://github.com/apache
 | UI | React 19 + [Tailwind CSS 4](https://tailwindcss.com) |
 | Animations | [Magic UI](https://magicui.design) (Particles, BorderBeam, BlurFade, TextAnimate, ShimmerButton) via `motion` |
 | Icons | [lucide-react](https://lucide.dev) + inline SVG for brand marks |
-| Docs | Astro content collections, markdown synced from [apache/airflow-steward/docs](https://github.com/apache/airflow-steward/tree/main/docs) |
+| Docs | Astro content collections, markdown synced from [apache/magpie/docs](https://github.com/apache/magpie/tree/main/docs) |
 
 Zero runtime dependency on closed-source design tooling. All components are owned in-tree.
 
@@ -20,7 +20,7 @@ Zero runtime dependency on closed-source design tooling. All components are owne
 
 ```bash
 npm install
-npm run sync-docs    # one-time fetch of markdown from apache/airflow-steward
+npm run sync-docs    # one-time fetch of markdown from apache/magpie
 npm run dev          # http://localhost:4321
 ```
 
@@ -31,7 +31,7 @@ The `prebuild` hook runs `sync-docs` automatically, so `npm run build` always pu
 | Command | Purpose |
 |---|---|
 | `npm run dev` | Dev server with HMR |
-| `npm run sync-docs` | Clone `apache/airflow-steward` (sparse, `docs/` + `images/`) into `src/content/docs/` and `public/docs-assets/` |
+| `npm run sync-docs` | Clone `apache/magpie` (sparse, `docs/` + `images/`) into `src/content/docs/` and `public/docs-assets/` |
 | `npm run build` | Static build to `dist/` (runs sync-docs first) |
 | `npm run preview` | Serve the built site locally |
 | `npm run astro` | Astro CLI passthrough |
@@ -40,7 +40,7 @@ The `prebuild` hook runs `sync-docs` automatically, so `npm run build` always pu
 
 | Var | Default | Purpose |
 |---|---|---|
-| `MAGPIE_DOCS_REPO` | `https://github.com/apache/airflow-steward.git` | Source repo for markdown |
+| `MAGPIE_DOCS_REPO` | `https://github.com/apache/magpie.git` | Source repo for markdown |
 | `MAGPIE_DOCS_BRANCH` | `main` | Branch to sync from |
 
 ## Project structure
@@ -76,10 +76,10 @@ website/
 
 ## Docs pipeline
 
-The website is decoupled from the docs source. The markdown lives in [apache/airflow-steward/docs](https://github.com/apache/airflow-steward/tree/main/docs); this repo fetches it at build time and renders it through Astro content collections.
+The website is decoupled from the docs source. The markdown lives in [apache/magpie/docs](https://github.com/apache/magpie/tree/main/docs); this repo fetches it at build time and renders it through Astro content collections.
 
 ```
-apache/airflow-steward/docs/*.md
+apache/magpie/docs/*.md
         │
         ▼  scripts/sync-docs.sh (sparse clone)
 src/content/docs/*.md
@@ -98,15 +98,23 @@ GitHub Actions workflow `.github/workflows/build.yml` runs on every push and PR
 2. Sync docs from the source repo
 3. `astro check` (warn-only)
 4. `astro build`
-5. Deploy to GitHub Pages (on `main`)
+5. On `main`: copy `.asf.yaml` into `dist/` and force-push the build to the `publish` branch
 
 ## Deployment
 
-The site deploys to GitHub Pages on every push to `main`. Production URL:
+The site is published by **ASF infrastructure**, not GitHub Pages. On every push to `main`, CI builds the static site and force-pushes `dist/` (an orphan, single-commit history) to the **`publish`** branch. The root [`.asf.yaml`](./.asf.yaml) — carried into that branch — tells ASF infra to serve it:
 
-**[andreahlert.github.io/magpie-site](https://andreahlert.github.io/magpie-site/)**
+```yaml
+publish:
+  whoami: publish
+  hostname: magpie.apache.org
+```
+
+Production URL: **[magpie.apache.org](https://magpie.apache.org/)** (served at the apex root).
+
+The site is built with `base: '/'` so all links and assets resolve against the apex domain. Set `SITE_BASE` / `SITE_URL` to preview under a subpath (e.g. GitHub Pages).
 
-When this repo moves to `apache/magpie-site`, the deploy target will switch to the ASF `asf-site` branch served by Apache infra at `magpie.apache.org`.
+> One-time infra setup (outside this repo): the `magpie.apache.org` hostname and its TLS must be registered with ASF Infra, and the `publish` branch created on first CI run.
 
 ## License
 
diff --git a/astro.config.mjs b/astro.config.mjs
index 67f9645..7f6b6a5 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -3,10 +3,15 @@ import { defineConfig } from 'astro/config';
 import react from '@astrojs/react';
 import tailwindcss from '@tailwindcss/vite';
 
+// Production is served directly at the apex https://magpie.apache.org/ (root path).
+// Override SITE_URL / SITE_BASE if you ever need to preview under a subpath.
+const site = process.env.SITE_URL ?? 'https://magpie.apache.org';
+const base = process.env.SITE_BASE ?? '/';
+
 // https://astro.build/config
 export default defineConfig({
-  site: 'https://andreahlert.github.io',
-  base: '/magpie-site',
+  site,
+  base,
   integrations: [react()],
   vite: {
     plugins: [tailwindcss()],
diff --git a/scripts/sync-docs.sh b/scripts/sync-docs.sh
index 220ab28..b484bb0 100755
--- a/scripts/sync-docs.sh
+++ b/scripts/sync-docs.sh
@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
-# Sync docs from apache/airflow-steward into src/content/docs/
+# Sync docs from apache/magpie into src/content/docs/
 # Runs as prebuild step and locally via `npm run sync-docs`.
 set -euo pipefail
 
-REPO="${MAGPIE_DOCS_REPO:-https://github.com/apache/airflow-steward.git}"
+REPO="${MAGPIE_DOCS_REPO:-https://github.com/apache/magpie.git}"
 BRANCH="${MAGPIE_DOCS_BRANCH:-main}"
 DEST="$(dirname "$0")/../src/content/docs"
 
diff --git a/src/components/landing/ImmersiveGradientHero.tsx b/src/components/landing/ImmersiveGradientHero.tsx
index e23110b..d427aa2 100644
--- a/src/components/landing/ImmersiveGradientHero.tsx
+++ b/src/components/landing/ImmersiveGradientHero.tsx
@@ -29,9 +29,7 @@ import {
   Lock as FeatherLock,
   Menu as FeatherMenu,
   PenTool as FeatherPenTool,
-  RefreshCw as FeatherRefreshCw,
   Shield as FeatherShield,
-  Users as FeatherUsers,
 } from "lucide-react";
 
 const FeatherGithub = (props: React.SVGProps<SVGSVGElement>) => (
@@ -52,6 +50,58 @@ const FeatherSlack = (props: React.SVGProps<SVGSVGElement>) => (
   </svg>
 );
 
+const SKILL_FAMILIES = [
+  {
+    name: "setup",
+    icon: FeatherLayers,
+    modes: "Infrastructure",
+    count: "6 skills",
+    desc: "Isolated agent setup, framework adoption & maintenance, shared-config sync. The prerequisite every adopter starts from.",
+  },
+  {
+    name: "security",
+    icon: FeatherShield,
+    modes: "Triage · Drafting",
+    count: "9 skills",
+    desc: "The 16-step security-issue lifecycle — from security@ import through CVE allocation and publication, with state sync. Maintainer-only.",
+  },
+  {
+    name: "pr-management",
+    icon: FeatherGitPullRequest,
+    modes: "Triage",
+    count: "3 skills",
+    desc: "Maintainer-facing PR-queue management — triage, queue stats, and deep code review.",
+  },
+  {
+    name: "issue",
+    icon: FeatherFilter,
+    modes: "Triage · Drafting",
+    count: "5 skills",
+    desc: "Issue lifecycle — triage, bug reproduction, fix drafting, and backlog re-assessment against the current branch.",
+  },
+  {
+    name: "release-management",
+    icon: FeatherGitMerge,
+    modes: "Triage · Drafting",
+    count: "10 skills · proposed",
+    desc: "The 14-step ASF release lifecycle — planning, RC cut & sign, [VOTE], tally, promote, [ANNOUNCE], archive, audit. The agent never holds the signing key or publishes.",
+  },
+  {
+    name: "mentoring",
+    icon: FeatherBookOpen,
+    modes: "Mentoring",
+    count: "1 skill · experimental",
+    desc: "Contributor mentoring — spec and tone guide in place; first skill (pr-management-mentor) shipping.",
+  },
+  {
+    name: "utilities",
+    icon: FeatherPenTool,
+    modes: "Meta",
+    count: "2 skills",
+    desc: "Framework meta-skills — author or update skills (write-skill) and print a live index of every skill (list-skills).",
+  },
+];
+
 function ImmersiveGradientHero() {
   return (
     <div className="flex h-full w-full flex-col items-center bg-default-background">
@@ -79,11 +129,11 @@ function ImmersiveGradientHero() {
           <div className="flex items-center gap-7 mobile:hidden">
             <a className="text-body font-body text-brand-600 hover:text-brand-700" href="#features">Features</a>
             <a className="text-body font-body text-brand-600 hover:text-brand-700" href={withBase("/docs")}>Docs</a>
-            <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://lists.apache.org/list.html?dev-magpie@airflow.apache.org">Community</a>
-            <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://github.com/apache/airflow-steward">GitHub</a>
+            <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://lists.apache.org/list.html?dev@magpie.apache.org">Community</a>
+            <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://github.com/apache/magpie">GitHub</a>
           </div>
           <div className="flex items-center gap-2">
-            <a href="https://github.com/apache/airflow-steward" target="_blank" rel="noreferrer" className="mobile:hidden">
+            <a href="https://github.com/apache/magpie" target="_blank" rel="noreferrer" className="mobile:hidden">
               <Button
                 className="border border-white/20 bg-white/10 text-white hover:bg-white/20"
                 variant="neutral-secondary"
@@ -107,7 +157,7 @@ function ImmersiveGradientHero() {
             <div className="flex items-center gap-2 rounded-full px-4 py-1.5 border border-brand-400/40 bg-brand-700/60">
               <FeatherFeather className="text-caption font-caption text-brand-200" />
               <span className="text-caption font-caption text-brand-200">
-                Apache Software Foundation Incubating
+                Apache Top-Level Project
               </span>
             </div>
             <div className="flex flex-col items-start gap-5">
@@ -122,10 +172,12 @@ function ImmersiveGradientHero() {
               </TextAnimate>
               <BlurFade delay={0.4} inView>
                 <span className="font-['Inter'] text-[17px] font-[400] leading-[27px] text-brand-200 -tracking-[0.01em]">
-                  Apache Magpie is an AI-powered assistant that helps open-source
-                  maintainers manage contributions more efficiently. From triage
-                  to auto-merge, Magpie learns your project and scales your review
-                  capacity.
+                  Apache Magpie handles the repetitive parts of running an
+                  open-source project — triaging issues and PRs, mentoring
+                  contributors, drafting fixes, managing security reports — so
+                  maintainers can spend their time on design, relationships, and
+                  the work that needs a human. The agent proposes; the human
+                  decides.
                 </span>
               </BlurFade>
             </div>
@@ -175,7 +227,7 @@ function ImmersiveGradientHero() {
           <div className="flex grow shrink-0 basis-0 flex-col items-center justify-center self-stretch rounded-2xl border border-solid border-[#b3d1ff] bg-[#f0f5ff] px-8 py-8 min-w-[380px]">
             <div className="flex w-full flex-col items-center py-4">
               <div className="flex w-full flex-col items-center">
-                <div className="flex w-full items-center gap-3 rounded-xl border border-solid border-[#80b3ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
+                <div className="flex min-h-[76px] w-full items-center gap-3 rounded-xl border border-solid border-[#80b3ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
                   <div className="flex h-10 w-10 flex-none items-center justify-center rounded-full bg-[#e6f0ff]">
                     <FeatherGitPullRequest className="text-heading-3 font-heading-3 text-[#004aad]" />
                   </div>
@@ -196,7 +248,7 @@ function ImmersiveGradientHero() {
                 </div>
               </div>
               <div className="flex w-full flex-col items-center">
-                <div className="flex w-full items-center gap-3 rounded-xl border border-solid border-[#80b3ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
+                <div className="flex min-h-[76px] w-full items-center gap-3 rounded-xl border border-solid border-[#80b3ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
                   <div className="flex h-10 w-10 flex-none items-center justify-center rounded-full bg-[#e6f0ff]">
                     <FeatherFilter className="text-heading-3 font-heading-3 text-[#004aad]" />
                   </div>
@@ -209,7 +261,7 @@ function ImmersiveGradientHero() {
                     </span>
                   </div>
                   <Badge variant="success" icon={<FeatherCheck />}>
-                    Active
+                    Stable
                   </Badge>
                 </div>
                 <div className="flex flex-col items-center py-1">
@@ -217,7 +269,7 @@ function ImmersiveGradientHero() {
                 </div>
               </div>
               <div className="flex w-full flex-col items-center">
-                <div className="flex w-full items-center gap-3 rounded-xl border border-solid border-[#80b3ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
+                <div className="flex min-h-[76px] w-full items-center gap-3 rounded-xl border border-solid border-[#80b3ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
                   <div className="flex h-10 w-10 flex-none items-center justify-center rounded-full bg-[#e6f0ff]">
                     <FeatherBookOpen className="text-heading-3 font-heading-3 text-[#004aad]" />
                   </div>
@@ -229,8 +281,8 @@ function ImmersiveGradientHero() {
                       Guide contributors with feedback
                     </span>
                   </div>
-                  <Badge variant="success" icon={<FeatherCheck />}>
-                    Active
+                  <Badge variant="warning" icon={<FeatherClock />}>
+                    Experimental
                   </Badge>
                 </div>
                 <div className="flex flex-col items-center py-1">
@@ -238,7 +290,7 @@ function ImmersiveGradientHero() {
                 </div>
               </div>
               <div className="flex w-full flex-col items-center">
-                <div className="flex w-full items-center gap-3 rounded-xl border border-solid border-[#b3d1ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
+                <div className="flex min-h-[76px] w-full items-center gap-3 rounded-xl border border-solid border-[#b3d1ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
                   <div className="flex h-10 w-10 flex-none items-center justify-center rounded-full bg-[#e6f0ff]">
                     <FeatherPenTool className="text-heading-3 font-heading-3 text-[#004aad]" />
                   </div>
@@ -250,8 +302,8 @@ function ImmersiveGradientHero() {
                       Generate review comments &amp; notes
                     </span>
                   </div>
-                  <Badge variant="warning" icon={<FeatherClock />}>
-                    Beta
+                  <Badge variant="success" icon={<FeatherCheck />}>
+                    Stable
                   </Badge>
                 </div>
                 <div className="flex flex-col items-center py-1">
@@ -259,21 +311,21 @@ function ImmersiveGradientHero() {
                 </div>
               </div>
               <div className="flex w-full flex-col items-center">
-                <div className="relative flex w-full items-center gap-3 rounded-xl border-2 border-solid border-[#004aad] px-5 py-4 shadow-lg bg-gradient-to-br from-[#e6f0ff] to-[#b3d1ff] max-w-[360px] overflow-hidden">
+                <div className="relative flex min-h-[76px] w-full items-center gap-3 rounded-xl border border-solid border-[#004aad] px-5 py-3 shadow-md bg-gradient-to-br from-[#e6f0ff] to-[#b3d1ff] max-w-[360px] overflow-hidden">
                   <BorderBeam size={120} duration={6} colorFrom="#004aad" colorTo="#80b3ff" />
-                  <div className="flex h-12 w-12 flex-none items-center justify-center rounded-full bg-[#004aad] shadow-sm">
-                    <FeatherGitMerge className="text-heading-2 font-heading-2 text-white" />
+                  <div className="flex h-10 w-10 flex-none items-center justify-center rounded-full bg-[#004aad] shadow-sm">
+                    <FeatherGitMerge className="text-heading-3 font-heading-3 text-white" />
                   </div>
                   <div className="flex grow shrink-0 basis-0 flex-col items-start">
                     <span className="text-body-bold font-body-bold text-[#002654]">
                       Auto-merge
                     </span>
                     <span className="text-caption font-caption text-[#004aad]">
-                      Merge when all checks pass
+                      Off by design until earlier modes prove out
                     </span>
                   </div>
                   <Badge variant="neutral" icon={<FeatherLock />}>
-                    Planned
+                    Off
                   </Badge>
                 </div>
               </div>
@@ -312,7 +364,7 @@ function ImmersiveGradientHero() {
                     Triage Mode
                   </span>
                   <Badge variant="success" icon={<FeatherCheck />}>
-                    Active
+                    Stable
                   </Badge>
                 </div>
                 <span className="text-body font-body text-subtext-color">
@@ -337,16 +389,16 @@ function ImmersiveGradientHero() {
                     Mentoring Mode
                   </span>
                   <Badge variant="warning" icon={<FeatherClock />}>
-                    Beta
+                    Experimental
                   </Badge>
                 </div>
                 <span className="text-body font-body text-subtext-color">
-                  Guide first-time contributors with contextual suggestions and
-                  code style feedback.
+                  Joins issue and PR threads in a teaching register — clarifying
+                  questions, pointers to conventions, examples from prior PRs.
                 </span>
                 <div className="flex flex-wrap items-start gap-2 pt-1">
-                  <Badge variant="neutral">Style guides</Badge>
-                  <Badge variant="neutral">Doc links</Badge>
+                  <Badge variant="neutral">Conventions</Badge>
+                  <Badge variant="neutral">Prior PRs</Badge>
                 </div>
               </div>
             </div>
@@ -364,16 +416,16 @@ function ImmersiveGradientHero() {
                     Drafting Mode
                   </span>
                   <Badge variant="success" icon={<FeatherCheck />}>
-                    Active
+                    Stable (security)
                   </Badge>
                 </div>
                 <span className="text-body font-body text-subtext-color">
-                  Generate review comments, changelogs, and release notes from
-                  PR context and commit history.
+                  Draft a fix for a well-scoped problem and open a PR — every PR
+                  reviewed and merged by a human committer, never the agent.
                 </span>
                 <div className="flex flex-wrap items-start gap-2 pt-1">
-                  <Badge variant="neutral">Review drafts</Badge>
-                  <Badge variant="neutral">Changelogs</Badge>
+                  <Badge variant="neutral">Fix PRs</Badge>
+                  <Badge variant="neutral">Human-merged</Badge>
                 </div>
               </div>
             </div>
@@ -389,16 +441,16 @@ function ImmersiveGradientHero() {
                     Pairing Mode
                   </span>
                   <Badge variant="warning" icon={<FeatherClock />}>
-                    Beta
+                    Experimental
                   </Badge>
                 </div>
                 <span className="text-body font-body text-subtext-color">
-                  Work alongside maintainers in real-time, suggesting fixes and
-                  identifying edge cases before review.
+                  Developer-side skills you run in your own dev loop — multi-agent
+                  review pipelines and self-review before you open a PR.
                 </span>
                 <div className="flex flex-wrap items-start gap-2 pt-1">
-                  <Badge variant="neutral">Real-time assist</Badge>
-                  <Badge variant="neutral">Pre-checks</Badge>
+                  <Badge variant="neutral">Self-review</Badge>
+                  <Badge variant="neutral">Pre-flight</Badge>
                 </div>
               </div>
             </div>
@@ -416,13 +468,14 @@ function ImmersiveGradientHero() {
                   Auto-merge Mode
                 </span>
                 <Badge variant="neutral" icon={<FeatherLock />}>
-                  Planned
+                  Off
                 </Badge>
               </div>
               <span className="text-body font-body text-subtext-color max-w-[640px]">
-                For trusted, well-tested contributions that pass all checks,
-                Magpie can autonomously approve and merge with full audit trails
-                and rollback capability.
+                Narrowly-scoped fix-and-merge for objectively boring changes —
+                lint, allow-listed dependency bumps, formatting. Deliberately
+                off until the earlier modes have proven out, and never for
+                security-class changes.
               </span>
               <div className="flex flex-wrap items-start gap-2 pt-1">
                 <Badge variant="brand">Auto-approve</Badge>
@@ -434,6 +487,49 @@ function ImmersiveGradientHero() {
           </div>
         </div>
       </div>
+      <div id="skills" className="flex w-full flex-col items-center bg-default-background px-8 pb-24 mobile:px-4 mobile:pb-14">
+        <BlurFade inView className="flex flex-col items-center gap-4 max-w-[640px] pb-12 mobile:pb-8">
+          <div className="flex items-center gap-2 rounded-full border border-solid border-brand-200 bg-brand-50 px-4 py-1.5">
+            <FeatherLayers className="text-caption font-caption text-brand-600" />
+            <span className="text-caption font-caption text-brand-600">
+              7 Skill Families
+            </span>
+          </div>
+          <span className="font-['Inter'] text-[38px] font-[700] leading-[44px] text-default-font text-center -tracking-[0.035em] mobile:font-['Jost'] mobile:text-[28px] mobile:font-[400] mobile:leading-[34px] mobile:tracking-normal">
+            Pick the families your project needs
+          </span>
+          <span className="text-body font-body text-subtext-color text-center">
+            Modes describe what the agent can do; skill families are how those
+            capabilities ship. Adopt only the families that fit — symlinks for
+            the picked families land in your skill directory.
+          </span>
+        </BlurFade>
+        <div className="w-full items-stretch gap-4 grid grid-cols-3 auto-rows-fr max-w-[1100px] mobile:grid-cols-1">
+          {SKILL_FAMILIES.map((family) => {
+            const Icon = family.icon;
+            return (
+              <div
+                key={family.name}
+                className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm hover:border-brand-200 hover:shadow-md transition-all"
+              >
+                <div className="flex w-full items-center justify-between">
+                  <div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
+                    <Icon className="text-body-bold font-body-bold text-brand-700" />
+                  </div>
+                  <Badge variant="neutral">{family.count}</Badge>
+                </div>
+                <span className="font-mono text-body-bold font-body-bold text-default-font">
+                  {family.name}
+                </span>
+                <Badge variant="brand">{family.modes}</Badge>
+                <span className="text-caption font-caption text-subtext-color">
+                  {family.desc}
+                </span>
+              </div>
+            );
+          })}
+        </div>
+      </div>
       <div className="flex w-full flex-col items-center border-y border-solid border-neutral-100 bg-neutral-50">
         <div className="flex w-full flex-col items-center gap-14 px-8 py-24 max-w-[1100px] mobile:gap-8 mobile:px-4 mobile:py-14">
           <div className="flex flex-col items-center gap-4 max-w-[600px]">
@@ -451,77 +547,77 @@ function ImmersiveGradientHero() {
               every action respects the principle of least privilege.
             </span>
           </div>
-          <div className="w-full items-start gap-4 grid grid-cols-3 mobile:grid mobile:grid-cols-1">
-            <div className="flex flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
+          <div className="w-full items-stretch gap-4 grid grid-cols-3 auto-rows-fr mobile:grid mobile:grid-cols-1">
+            <div className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
               <div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
-                <FeatherKey className="text-body-bold font-body-bold text-brand-700" />
+                <FeatherShield className="text-body-bold font-body-bold text-brand-700" />
               </div>
               <span className="text-body-bold font-body-bold text-default-font">
-                Token Scoping
+                Sandboxed by Default
               </span>
               <span className="text-caption font-caption text-subtext-color">
-                Minimal permissions per operation. Magpie never requests more
-                access than needed.
+                Filesystem, network, and tool-permission rules enforced at the
+                harness layer. Sandbox bypasses warn loudly, never silently.
               </span>
             </div>
-            <div className="flex flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
+            <div className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
               <div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
-                <FeatherFileText className="text-body-bold font-body-bold text-brand-700" />
+                <FeatherLock className="text-body-bold font-body-bold text-brand-700" />
               </div>
               <span className="text-body-bold font-body-bold text-default-font">
-                Full Audit Logs
+                Privacy-Aware Routing
               </span>
               <span className="text-caption font-caption text-subtext-color">
-                Every AI decision logged with reasoning, context, and
-                timestamps. Full traceability.
+                Private content flows only to LLMs your PMC has explicitly
+                approved, with a recorded data-residency contract.
               </span>
             </div>
-            <div className="flex flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
+            <div className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
               <div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
                 <FeatherEyeOff className="text-body-bold font-body-bold text-brand-700" />
               </div>
               <span className="text-body-bold font-body-bold text-default-font">
-                No Data Retention
+                PII Redaction
               </span>
               <span className="text-caption font-caption text-subtext-color">
-                Code processed in-memory, never stored. Your intellectual
-                property stays yours.
+                Third-party PII is redacted to stable identifiers before any
+                content reaches an LLM context.
               </span>
             </div>
-            <div className="flex flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
+            <div className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
               <div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
-                <FeatherRefreshCw className="text-body-bold font-body-bold text-brand-700" />
+                <FeatherFileText className="text-body-bold font-body-bold text-brand-700" />
               </div>
               <span className="text-body-bold font-body-bold text-default-font">
-                Rollback Support
+                Full Audit Log
               </span>
               <span className="text-caption font-caption text-subtext-color">
-                Any automated action can be instantly reversed. Humans always
-                retain the final say.
+                Every agent-authored action — comment, label, draft, PR — is
+                logged and reversible where possible.
               </span>
             </div>
-            <div className="flex flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
+            <div className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
               <div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
-                <FeatherUsers className="text-body-bold font-body-bold text-brand-700" />
+                <FeatherKey className="text-body-bold font-body-bold text-brand-700" />
               </div>
               <span className="text-body-bold font-body-bold text-default-font">
-                Role-Based Access
+                Pinned &amp; Signed Deps
               </span>
               <span className="text-caption font-caption text-subtext-color">
-                Granular permissions aligned with project governance. Distinct
-                access for PMC and contributors.
+                Every system tool is pinned and aged through a cooldown window.
+                Version bumps are reviewed PRs, not silent updates.
               </span>
             </div>
-            <div className="flex flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
+            <div className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
               <div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
-                <FeatherShield className="text-body-bold font-body-bold text-brand-700" />
+                <FeatherCheckCircle className="text-body-bold font-body-bold text-brand-700" />
               </div>
               <span className="text-body-bold font-body-bold text-default-font">
-                ASF Compliance
+                Human-in-the-Loop
               </span>
               <span className="text-caption font-caption text-subtext-color">
-                Built to meet Apache Software Foundation standards for security
-                and governance.
+                Every outward action needs explicit maintainer confirmation.
+                External content is treated as data, never instructions.
               </span>
             </div>
           </div>
@@ -608,10 +704,10 @@ function ImmersiveGradientHero() {
           <div className="flex flex-wrap items-center justify-center gap-3">
             <a href={withBase("/docs")}>
               <Button size="large" icon={<FeatherArrowRight />}>
-                Get Started Free
+                Get Started
               </Button>
             </a>
-            <a href="https://github.com/apache/airflow-steward" target="_blank" rel="noreferrer">
+            <a href="https://github.com/apache/magpie" target="_blank" rel="noreferrer">
               <Button
                 className="border border-white/20 bg-white/10 text-white hover:bg-white/20"
                 size="large"
@@ -636,7 +732,7 @@ function ImmersiveGradientHero() {
               open-source maintainers.
             </span>
             <div className="flex items-center gap-2">
-              <a href="https://github.com/apache/airflow-steward" target="_blank" rel="noreferrer" aria-label="GitHub">
+              <a href="https://github.com/apache/magpie" target="_blank" rel="noreferrer" aria-label="GitHub">
                 <IconButton icon={<FeatherGithub />} />
               </a>
               <a href="https://twitter.com/TheASF" target="_blank" rel="noreferrer" aria-label="Twitter">
@@ -652,15 +748,15 @@ function ImmersiveGradientHero() {
               <span className="text-body-bold font-body-bold text-default-font">Project</span>
               <a className="text-body font-body text-subtext-color hover:text-brand-600" href="#features">Features</a>
               <a className="text-body font-body text-subtext-color hover:text-brand-600" href={withBase("/docs")}>Documentation</a>
-              <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/issues">Roadmap</a>
-              <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/releases">Changelog</a>
+              <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/issues">Roadmap</a>
+              <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/releases">Changelog</a>
             </div>
             <div className="flex grow shrink-0 basis-0 flex-col items-start gap-3 min-w-[130px]">
               <span className="text-body-bold font-body-bold text-default-font">Community</span>
-              <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/blob/main/CONTRIBUTING.md">Contributing</a>
-              <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://lists.apache.org/list.html?dev-magpie@airflow.apache.org">Mailing Lists</a>
+              <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/blob/main/CONTRIBUTING.md">Contributing</a>
+              <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://lists.apache.org/list.html?dev@magpie.apache.org">Mailing Lists</a>
               <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://the-asf.slack.com">Slack Channel</a>
-              <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/issues">Issue Tracker</a>
+              <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/issues">Issue Tracker</a>
             </div>
             <div className="flex grow shrink-0 basis-0 flex-col items-start gap-3 min-w-[130px]">
               <span className="text-body-bold font-body-bold text-default-font">Foundation</span>
diff --git a/src/components/landing/SiteFooter.tsx b/src/components/landing/SiteFooter.tsx
index 77ab817..d99d03a 100644
--- a/src/components/landing/SiteFooter.tsx
+++ b/src/components/landing/SiteFooter.tsx
@@ -33,7 +33,7 @@ export function SiteFooter() {
             open-source maintainers.
           </span>
           <div className="flex items-center gap-2">
-            <a href="https://github.com/apache/airflow-steward" target="_blank" rel="noreferrer" aria-label="GitHub">
+            <a href="https://github.com/apache/magpie" target="_blank" rel="noreferrer" aria-label="GitHub">
               <IconButton icon={<GithubIcon />} />
             </a>
             <a href="https://twitter.com/TheASF" target="_blank" rel="noreferrer" aria-label="Twitter">
@@ -49,15 +49,15 @@ export function SiteFooter() {
             <span className="text-body-bold font-body-bold text-default-font">Project</span>
             <a className="text-body font-body text-subtext-color hover:text-brand-600" href={`${withBase("/")}#features`}>Features</a>
             <a className="text-body font-body text-subtext-color hover:text-brand-600" href={withBase("/docs")}>Documentation</a>
-            <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/issues">Roadmap</a>
-            <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/releases">Changelog</a>
+            <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/issues">Roadmap</a>
+            <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/releases">Changelog</a>
           </div>
           <div className="flex grow shrink-0 basis-0 flex-col items-start gap-3 min-w-[130px]">
             <span className="text-body-bold font-body-bold text-default-font">Community</span>
-            <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/blob/main/CONTRIBUTING.md">Contributing</a>
-            <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://lists.apache.org/list.html?dev-magpie@airflow.apache.org">Mailing Lists</a>
+            <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/blob/main/CONTRIBUTING.md">Contributing</a>
+            <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://lists.apache.org/list.html?dev@magpie.apache.org">Mailing Lists</a>
             <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://the-asf.slack.com">Slack Channel</a>
-            <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/issues">Issue Tracker</a>
+            <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/issues">Issue Tracker</a>
           </div>
           <div className="flex grow shrink-0 basis-0 flex-col items-start gap-3 min-w-[130px]">
             <span className="text-body-bold font-body-bold text-default-font">Foundation</span>
diff --git a/src/components/landing/SiteHeader.tsx b/src/components/landing/SiteHeader.tsx
index b0b9ebb..c01b276 100644
--- a/src/components/landing/SiteHeader.tsx
+++ b/src/components/landing/SiteHeader.tsx
@@ -36,11 +36,11 @@ export function SiteHeader({ tone = "default" }: { tone?: "default" | "hero" })
       <div className="flex items-center gap-7 mobile:hidden">
         <a className="text-body font-body text-brand-600 hover:text-brand-700" href={`${withBase("/")}#features`}>Features</a>
         <a className="text-body font-body text-brand-600 hover:text-brand-700" href={withBase("/docs")}>Docs</a>
-        <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://lists.apache.org/list.html?dev-magpie@airflow.apache.org">Community</a>
-        <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://github.com/apache/airflow-steward">GitHub</a>
+        <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://lists.apache.org/list.html?dev@magpie.apache.org">Community</a>
+        <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://github.com/apache/magpie">GitHub</a>
       </div>
       <div className="flex items-center gap-2">
-        <a href="https://github.com/apache/airflow-steward" target="_blank" rel="noreferrer" className="mobile:hidden">
+        <a href="https://github.com/apache/magpie" target="_blank" rel="noreferrer" className="mobile:hidden">
           <Button className={ghBtnClass} variant="neutral-secondary" icon={<GithubIcon />}>
             Star on GitHub
           </Button>
diff --git a/src/layouts/DocsLayout.astro b/src/layouts/DocsLayout.astro
index bd0aae8..c046a92 100644
--- a/src/layouts/DocsLayout.astro
+++ b/src/layouts/DocsLayout.astro
@@ -10,7 +10,15 @@ interface Props {
 }
 
 const { title, currentSlug } = Astro.props;
-const all = await getCollection("docs");
+
+// Internal governance drafts that should not appear on the public site.
+const HIDDEN_DOCS = new Set(["board-resolution-draft"]);
+// Quick-start entry pinned to the top of the docs sidebar.
+const QUICK_START = { slug: "setup/install-recipes", label: "Quick Start" };
+
+const all = (await getCollection("docs")).filter(
+  (entry) => !HIDDEN_DOCS.has(entry.id.replace(/\.md$/, "")),
+);
 
 type NavGroup = { name: string; items: { slug: string; label: string }[] };
 const groups = new Map<string, NavGroup>();
@@ -37,6 +45,12 @@ const base = import.meta.env.BASE_URL.replace(/\/$/, "");
   <div class="flex w-full">
     <aside class="w-64 flex-none border-r border-neutral-200 bg-neutral-50 px-5 py-8 overflow-y-auto sticky top-0 max-h-screen mobile:hidden">
       <a href={`${base}/`} class="block mb-6 text-body-bold font-body-bold text-brand-700 hover:text-brand-600">← Back to home</a>
+      <a
+        href={`${base}/docs/${QUICK_START.slug}`}
+        class={`block mb-6 px-3 py-2 rounded-md text-body-bold font-body-bold ${currentSlug === QUICK_START.slug ? "bg-brand-600 text-white" : "bg-brand-50 text-brand-700 hover:bg-brand-100"}`}
+      >
+        ⚡ {QUICK_START.label}
+      </a>
       <nav class="flex flex-col gap-6">
         {sortedGroups.map((group) => (
           <div>
diff --git a/src/pages/docs/[...slug].astro b/src/pages/docs/[...slug].astro
index b404908..832abdc 100644
--- a/src/pages/docs/[...slug].astro
+++ b/src/pages/docs/[...slug].astro
@@ -3,11 +3,15 @@ import { getCollection, render } from "astro:content";
 import DocsLayout from "../../layouts/DocsLayout.astro";
 
 export async function getStaticPaths() {
+  // Internal governance drafts that should not appear on the public site.
+  const HIDDEN_DOCS = new Set(["board-resolution-draft"]);
   const docs = await getCollection("docs");
-  return docs.map((entry) => ({
-    params: { slug: entry.id.replace(/\.md$/, "") },
-    props: { entry },
-  }));
+  return docs
+    .filter((entry) => !HIDDEN_DOCS.has(entry.id.replace(/\.md$/, "")))
+    .map((entry) => ({
+      params: { slug: entry.id.replace(/\.md$/, "") },
+      props: { entry },
+    }));
 }
 
 const { entry } = Astro.props;
diff --git a/src/pages/docs/index.astro b/src/pages/docs/index.astro
index 1ad0051..7101446 100644
--- a/src/pages/docs/index.astro
+++ b/src/pages/docs/index.astro
@@ -1,20 +1,38 @@
 ---
 import DocsLayout from "../../layouts/DocsLayout.astro";
-import { getCollection } from "astro:content";
 
-const all = await getCollection("docs");
-const first = all.find((e) => e.id === "README.md") ?? all[0];
+const base = import.meta.env.BASE_URL.replace(/\/$/, "");
+const QUICK_START = `${base}/docs/setup/install-recipes`;
+const OVERVIEW = `${base}/docs/index`;
 ---
 
 <DocsLayout title="Documentation" currentSlug="">
   <h1>Apache Magpie Documentation</h1>
   <p>
-    Welcome. Source: <a href="https://github.com/apache/airflow-steward/tree/main/docs">apache/airflow-steward/docs</a>.
+    Apache Magpie is an AI assistant for open-source project maintainers. It
+    handles the repetitive parts of running a project — triaging issues,
+    reviewing PRs, onboarding contributors, managing security reports, cutting
+    releases — so maintainers can spend their time on the work that needs a
+    human. <strong>The agent proposes; the human decides.</strong>
+  </p>
+
+  <h2>Quick Start</h2>
+  <p>
+    Adopt Magpie in your repo with a single copy-pasteable bootstrap, then let
+    the <code>setup</code> skill wire up the rest. Pick an install method and
+    follow the verbatim recipe:
+  </p>
+  <p>
+    <a href={QUICK_START}><strong>⚡ Quick Start → Install recipes</strong></a>
+    &nbsp;·&nbsp;
+    <a href={`${base}/docs/prerequisites`}>Prerequisites</a>
+    &nbsp;·&nbsp;
+    <a href={OVERVIEW}>What is Apache Magpie?</a>
+  </p>
+
+  <p>
+    These pages are synced from
+    <a href="https://github.com/apache/magpie/tree/main/docs">apache/magpie/docs</a>.
+    Browse the full set from the sidebar.
   </p>
-  <p>Pick a topic from the sidebar to get started.</p>
-  {first && (
-    <p>
-      <a href={`${import.meta.env.BASE_URL.replace(/\/$/, "")}/docs/${first.id.replace(/\.md$/, "")}`}>→ Start with {first.id.replace(/\.md$/, "")}</a>
-    </p>
-  )}
 </DocsLayout>