feat: boilerplate for AI docs. (#1295)

* feat: boilerplate for AI docs.

* feat: adds first AI docs [sc-00]

Author: tnolet

package-lock.json

@@ -58,7 +58,7 @@
     "@babel/preset-env": "^7.26.0",
     "@babel/register": "7.25.9",
     "@playwright/test": "1.31.2",
-    "checkly": "5.0.1",
+    "checkly": "5.5.0",
     "eslint": "^8.50.0",
     "eslint-config-standard": "^17.1.0",
     "eslint-plugin-html": "^7.1.0",

package.json

@@ -73,6 +73,11 @@ disqusShortname = "checkly"
 [[menu.platform]]
 	name = "Traces"
 	url = "/docs/traces-open-telemetry/"
+	weight = 40
+
+[[menu.platform]]
+	name = "AI"
+	url = "/docs/ai/"
 	weight = 50
 
 [[menu.resources]]

site/assets/docs/images/ai/pwt-error-explainer-example.png

@@ -0,0 +1,38 @@
+---
+title: How Checkly uses AI - Checkly Docs
+displayTitle: How Checkly uses AI 
+navTitle: How Checkly uses AI
+weight: 1
+slug: /
+menu:
+  platform:
+    parent: "AI"
+---
+
+Checkly uses AI to enhance our monitoring and testing capabilities. Checkly's AI features are always opt-in. You can 
+opt in on the [AI settings screen](https://app.checklyhq.com/settings/account/ai). 
+
+> During the beta phase, Enterprise customers need to enable the AI features in the [Lab settings screen](https://app.checklyhq.com/settings/account/labs) to use them.
+
+We focus the use of AI on three following areas:
+
+1. **Check creation**: use AI to quickly generate checks based making it quicker and easier to set up monitoring for new applications or features.
+2. **Check failure triage**: use AI to analyze check failures and provide insights into impacted users and features, helping teams quickly identify and resolve issues.
+3. **Check failure remediation**: use AI to propose remediation steps for check failures, reducing the time spent on troubleshooting and improving overall system reliability.
+
+## Data Privacy and Security
+
+All AI features are designed to operate on the data you provide or the data generated by your checks. This data is already 
+stored in Checkly, and we do not send any additional data to third-party AI providers. 
+
+Any provided [environment secrets](https://www.checklyhq.com/docs/api-checks/variables/) are scrubbed before being sent to the AI provider.
+
+We do not train any custom models on your data. Any data used by the AI features is processed in real-time and not stored for future use.
+To address further privacy concerns, you can bring your own AI model and provider to Checkly. For more information, see the section below on built-in and custom models.
+
+## Built-in and Custom Models
+
+By default, Checkly uses OpenAI's GPT-4.1 model for AI features. However, you can also bring your own model (BYOM) and provider to Checkly.
+To do this, you need to set up a custom AI provider in the [AI settings screen](https://app.checklyhq.com/settings/account/ai).
+
+> The Bring Your Own Model (BYOM) feature is available for Enterprise customers only.

site/assets/docs/images/ai/pwt-test-analysis-example.png

@@ -0,0 +1,44 @@
+---
+title: AI assisted features in Checkly - Checkly Docs
+displayTitle: AI assisted Checkly features
+navTitle: AI assisted features
+weight: 2
+menu:
+  platform:
+    parent: "AI"
+---
+
+Checkly AI is not one feature, but a set of features that use AI to enhance your monitoring and testing capabilities. Currently,
+you can use AI in the following parts of the product:
+
+## Playwright Test Analysis
+
+On each failed Playwright-powered check result, Checkly AI analyzes the traces, script code, screenshots and script code to provide you with a detailed analysis of the failure. 
+This includes:
+
+- **End-user impact**: Checkly AI analyzes the failure and provides you with a list of impacted users and features. The text used is generated by AI and can be enriched with organisation-specific domain knowledge using the **Tag description editor** the [AI settings screen](https://app.checklyhq.com/settings/account/ai).
+- **Step summary**: Checkly AI summarizes the steps in the check script, making it easier to understand what the check is doing and where it failed.
+- **Root cause**: Checkly AI analyzes the failure and provides you with a root cause analysis, helping you quickly remediate the issue.
+
+![Playwright Test AI analysis](/docs/images/ai/pwt-test-analysis-example.png)
+
+
+## Tag Description Editor
+
+Using the [Tag Description Editor](https://app.checklyhq.com/settings/account/ai), you can add custom descriptions to your tags. Checkly AI uses these descriptions to 
+provide more context and insights into failures and the impact on user groups, features and applications. 
+
+This is very useful for organizations with specific domain knowledge and terminology embedded in their tags. For example,
+a tag like `feat:checkout` can be enriched with a description like "This tag is used for the checkout feature of our e-commerce application, which allows users to purchase products online."
+
+![Tag description](/docs/images/ai/tag-description-example.png)
+
+## Playwright Error Explainer
+
+On each Playwright error, Checkly AI provides you with an error explanation. This includes:
+
+- A general explanation of the error.
+- A suggestion on how to fix the error with a code snippet.
+- A (set of) link(s) to the Playwright documentation for the error.
+
+![Playwright Test AI error explainer](/docs/images/ai/pwt-error-explainer-example.png)

site/assets/docs/images/ai/tag-description-example.png

@@ -0,0 +1,16 @@
+---
+title: Using Checkly with AI IDEs and Copilots - Checkly Docs
+displayTitle: Use Checkly with AI IDEs & Copilots
+navTitle: Use Checkly with AI IDEs & Copilots
+weight: 3
+draft: true
+menu:
+  platform:
+    parent: "AI"
+---
+
+## GitHub Copilot
+
+## Cursor
+
+