# Prepare for effective use of AI tools

To prepare your services for effective usage of AI tools, you can use the AI Maturity Scorecard template. This Scorecard validates the presence of essential files, pre-commit, safeguards, and observability integrations, ensuring you can effectively leverage AI tools across the software lifecycle.

## Create a Scorecard for AI Maturity

### Step 1: Create the Scorecard and configure its basic settings

1. On the [**Scorecards** page](https://app.getcortexapp.com/admin/scorecards) in your workspace, click **Create Scorecard**.
2. On the `AI Maturity` template, click **Use**.
3. Configure basic settings, including the Scorecard's name, unique identifier, description, and more.
   * Learn about configuring the basic settings in the [Creating a Scorecard documentation](https://app.gitbook.com/o/RD51qiGImxmmq8NjALb1/s/JW7pYRxS4dHS3Hv6wxve/standardize/scorecards/create).

### Step 2: Review and modify rules

Cortex's templated rules are based on common industry standards:

<details>

<summary>AI Maturity: Bronze level rules</summary>

* Git PR templates exist\
  `git.fileExists("pull_request_template.md") OR git.fileExists("docs/pull_request_template.md") OR git.fileExists(".github/PULL_REQUEST_TEMPLATE.md") OR git.fileExists(".github/pull_request_template.md") OR git.fileExists(".github/PULL_REQUEST_TEMPLATE/*.md") OR git.fileExists("PULL_REQUEST_TEMPLATE/*.md") OR git.fileExists("docs/PULL_REQUEST_TEMPLATE/*.md")`
* Pre-commit settings file\
  `git.fileExists(".pre-commit-config.yaml")`
* Repository contains README file\
  `git.fileExists("README.md")`

</details>

<details>

<summary>AI Maturity: Silver level rules</summary>

* Anthropic Claude instructions in repo\
  `git.fileExists("CLAUDE.md")`
* Google Gemini instructions in repo\
  `git.fileExists("GEMINI.md")`
* GitHub Copilot coding agent development environment\
  `git.fileExists(".github/workflows/copilot-setup-steps.yml")`
* GitHub Copilot instructions in repo\
  `git.fileExists(".github/copilot-instructions.md")`
* Amazon Q instructions in repo\
  `git.fileExists("AmazonQ.md")`

</details>

<details>

<summary>AI Maturity: Gold level rules</summary>

* Amazon Q rules in repo\
  `git.fileExists(".amazonq/rules/*.md")`
* GitHub Copilot rules in repo\
  `git.fileExists(".github/instructions/*.instructions.md")`
* Cursor rules in repo\
  `git.fileExists(".cursor/rules/*")`
* AI-driven anomaly detection in observability stack\
  `datadog.monitors().filter((monitor) => monitor.name.matches(".ai.")).length > 0`

</details>

You can reorder, delete, and edit rules, add more rules to a level, and assign more points to a rule to signify its importance. Behind each rule is a [Cortex Query Language (CQL) ](/standardize/cql.md)query; you can edit the existing CQL or write your own queries to further refine your rules.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cortex.io/guides/ai-excellence/prepare-for-effective-use-of-ai-tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.