docs(specs): decouple-docforge PR1 + PR2 designs

[klocke-io]

How to categorize this PR?

/kind discussion

What this PR does / why we need it:

Adds the PR1 and PR2 design notes under .specs/2026-06-02-decouple-docforge/:

• pr1-decouple-build.md — commits the current hugo/ snapshot, drops docforge from per-build CI, and ships the docs-sync GitHub Action.
• pr2-migrate-to-website.md — strips /website/* from the docforge config, switches VitePress srcDir to ./website, deletes hugo/.

Companion to #990 (master spec + PR0 design). Draft for design discussion.

Which issue(s) this PR fixes:
Fixes #

Special notes for your reviewer:
Spec only — no code changes. Read #990 first for the master spec context.

[netlify]

✅ Deploy Preview for gardener-docs ready!

Name	Link
🔨 Latest commit	28fa465
🔍 Latest deploy log	https://app.netlify.com/projects/gardener-docs/deploys/6a1ee607bf97aa0009cf3296
😎 Deploy Preview	https://deploy-preview-991--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.

[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 bohristova 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

[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: 4aa54993-44b8-4e4a-8fab-2847eb6a6434

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-pr1-pr2

---

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.}

[klocke-io]

Folded into #990.