From fe473bcf73999a46d61e7456fac01932539e5236 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Alexander=20H=C3=A4renstam=27s=20Machine=20Account?=
 <322488294+alehar9320-bot@users.noreply.github.com>
Date: Wed, 2 Sep 2026 08:10:21 +0200
Subject: [PATCH 1/2] docs: add docs/ README index

Give engineers and agents a single entry point for ADRs, MCP, Zod, and inspirations, and point changelog readers at GitHub Releases.
---
 docs/README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 docs/README.md

diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 00000000..1aa80ab8
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,27 @@
+# docs/
+
+Engineering documentation for this repo. Visitor copy lives on the live site ([https://me.alehar.workers.dev/](https://me.alehar.workers.dev/)). The [GitHub Wiki](https://github.com/alehar9320/astro-cloudflare-personal-website/wiki) is a map only; it is not a second source of truth.
+
+## Index
+
+| Path | Role |
+| --- | --- |
+| [adr/0001-cloudflare-production-render-jules.md](adr/0001-cloudflare-production-render-jules.md) | ADR: Cloudflare Workers = production; Render = Jules test env (not failover) |
+| [mcp.md](mcp.md) | MCP server setup for AI agents (Cursor and siblings) |
+| [zod-guidelines.md](zod-guidelines.md) | Zod schema-first / runtime validation practices |
+| [inspirations.md](inspirations.md) | Reference personal sites for design and structure |
+
+## Nearby (repo root)
+
+| Path | Role |
+| --- | --- |
+| [README.md](../README.md) | Human front door: what this is, how to run, how prod deploys |
+| [AGENTS.md](../AGENTS.md) | AI / agent source of truth |
+| [SECURITY.md](../SECURITY.md) | Vulnerability reports via LinkedIn |
+| GitHub Releases | Canonical changelog (prefer releases over root `CHANGELOG.md`) |
+
+## Locks (do not undo in docs)
+
+- Hire path: [LinkedIn](https://www.linkedin.com/in/alehar/) only (no public email, no mailto hire, no placeholder CV PDF).
+- Production host: Cloudflare Workers only.
+- GitHub Pages stays off.

From ba1d38c596c05377f7b3383cb4f5552f3413856a Mon Sep 17 00:00:00 2001
From: alehar9320-bot <322488294+alehar9320-bot@users.noreply.github.com>
Date: Wed, 2 Sep 2026 17:28:45 +0000
Subject: [PATCH 2/2] ci: retrigger Quality for docs/README index