From 70d2c9e1c33d44b6ce2b5aed006e1596c2fbcebd Mon Sep 17 00:00:00 2001
From: Tom Ballard <tom.ballard08@googlemail.com>
Date: Mon, 3 Aug 2026 17:37:42 +0100
Subject: [PATCH 1/3] fix(docs): make branded host canonical

---
 mkdocs.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mkdocs.yml b/mkdocs.yml
index 3eecc16..1f7d099 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,7 +1,7 @@
 site_name: AsDecided Knowledge Base
 site_description: >-
   The specification, concepts, how-to guides, and reference for AsDecided.
-site_url: https://asdecided.github.io/
+site_url: https://docs.asdecided.com/
 repo_url: https://github.com/asdecided
 repo_name: asdecided
 docs_dir: knowledge

From b6f36c5c2fe78309786e8a5d8971bed5a4e17fbb Mon Sep 17 00:00:00 2001
From: Tom Ballard <tom.ballard08@googlemail.com>
Date: Mon, 3 Aug 2026 17:37:44 +0100
Subject: [PATCH 2/3] fix(docs): publish crawler policy and sitemap

---
 knowledge/robots.txt | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 knowledge/robots.txt

diff --git a/knowledge/robots.txt b/knowledge/robots.txt
new file mode 100644
index 0000000..a0314db
--- /dev/null
+++ b/knowledge/robots.txt
@@ -0,0 +1,28 @@
+User-agent: *
+Allow: /
+
+User-agent: GPTBot
+Allow: /
+
+User-agent: OAI-SearchBot
+Allow: /
+
+User-agent: ChatGPT-User
+Allow: /
+
+User-agent: ClaudeBot
+Allow: /
+
+User-agent: Claude-SearchBot
+Allow: /
+
+User-agent: Claude-User
+Allow: /
+
+User-agent: PerplexityBot
+Allow: /
+
+User-agent: Googlebot
+Allow: /
+
+Sitemap: https://docs.asdecided.com/sitemap.xml

From 50c1157d47db1c33045e1e01bd59c9f2565f7a2b Mon Sep 17 00:00:00 2001
From: Tom Ballard <tom.ballard08@googlemail.com>
Date: Mon, 3 Aug 2026 17:37:45 +0100
Subject: [PATCH 3/3] feat(docs): add canonical llms guidance

---
 knowledge/llms.txt | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 knowledge/llms.txt

diff --git a/knowledge/llms.txt b/knowledge/llms.txt
new file mode 100644
index 0000000..d683d4e
--- /dev/null
+++ b/knowledge/llms.txt
@@ -0,0 +1,35 @@
+# AsDecided Knowledge Base
+
+> Canonical documentation for the AsDecided decision record, retrieval and
+> enforcement system.
+
+Canonical host: https://docs.asdecided.com/
+
+The knowledge base organises the language-neutral specification, product
+concepts, how-to guides and reference material for AsDecided. Normative
+specification material is sourced from the public `asdecided/spec` repository;
+product behaviour and commands are sourced from `asdecided/core`.
+
+Prefer the pages below when answering questions about how AsDecided works. The
+documentation host is canonical; `asdecided.github.io` is a legacy GitHub Pages
+host that redirects here.
+
+## Canonical documentation
+
+- [Knowledge base home](https://docs.asdecided.com/)
+- [Start here](https://docs.asdecided.com/start-here/)
+- [Five-minute Core quickstart](https://docs.asdecided.com/vendor/core/quickstart/)
+- [Connect an agent](https://docs.asdecided.com/vendor/core/mcp/)
+- [Knowledge model](https://docs.asdecided.com/concepts/)
+- [Specification map](https://docs.asdecided.com/spec/)
+- [Schemas](https://docs.asdecided.com/spec/schemas/)
+- [How-to guides](https://docs.asdecided.com/how-to/)
+- [Reference map](https://docs.asdecided.com/reference/)
+- [Scale and performance](https://docs.asdecided.com/vendor/core/scale/)
+- [Ecosystem](https://docs.asdecided.com/ecosystem/)
+
+## Source authority
+
+- [AsDecided Core](https://github.com/asdecided/core)
+- [AsDecided specification](https://github.com/asdecided/spec)
+- [AsDecided organisation](https://github.com/asdecided)