docs(specs): decouple-docforge design (master spec + PR0/PR1/PR2)

[klocke-io]

How to categorize this PR?

/kind discussion

What this PR does / why we need it:

Adds design notes under .specs/2026-06-02-decouple-docforge/ for splitting docforge out of the per-build pipeline:

• README.md — master spec (problem, goals, architecture, cross-PR decision log).
• pr0-sitemap-diff.md — sitemap-diff gate that runs on every PR and posts added/removed sitemap URLs as a comment.
• pr1-decouple-build.md — commits the current hugo/ snapshot, drops docforge from per-build CI, ships the docs-sync GitHub Action.
• pr2-migrate-to-website.md — strips /website/* from docforge config, switches VitePress srcDir to ./website, deletes hugo/.

Draft for design discussion.

Which issue(s) this PR fixes:
Fixes #

Special notes for your reviewer:
Spec only — no code changes.

[netlify]

✅ Deploy Preview for gardener-docs ready!

Name	Link
🔨 Latest commit	339284f
🔍 Latest deploy log	https://app.netlify.com/projects/gardener-docs/deploys/6a1ee71c69ff3c000871eced
😎 Deploy Preview	https://deploy-preview-990--gardener-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: d093be2f-a388-44a8-9f2c-01537e290f92

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/spec-decouple-docforge-design

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[gardener-prow]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign klocke-io for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment