> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cortex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Prepare for effective use of AI tools

export const RecipeBadges = ({badges = []}) => {
  const map = {
    "recipe": {
      label: "Recipe",
      color: "#A86400"
    },
    "ai-excellence": {
      label: "AI excellence",
      color: "#653EE8"
    },
    "production-readiness": {
      label: "Production readiness",
      color: "#226686"
    },
    "incident-mgmt": {
      label: "Incident management",
      color: "#86198F"
    },
    "migrations": {
      label: "Migrations",
      color: "#0E7C66"
    },
    "compliance": {
      label: "Compliance",
      color: "#475569"
    },
    "dora": {
      label: "DORA metrics",
      color: "#1D4ED8"
    },
    "security": {
      label: "Security",
      color: "#B42318"
    },
    "operational-readiness": {
      label: "Operational readiness",
      color: "#B54708"
    },
    "dev-onboarding": {
      label: "Developer onboarding",
      color: "#C11574"
    }
  };
  const items = badges.map(key => map[key]).filter(Boolean);
  if (items.length === 0) return null;
  return <div className="not-prose flex flex-wrap gap-2 mb-6">
      {items.map(b => <span key={b.label} className="rounded-lg px-2 py-1 text-xs font-medium" style={{
    backgroundColor: b.color,
    color: b.textColor || "#FFFFFF"
  }}>
          {b.label}
        </span>)}
    </div>;
};

<RecipeBadges badges={["recipe", "ai-excellence"]} />

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](/standardize/scorecards/create).

### Step 2: Review and modify rules

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

<AccordionGroup>
  <Accordion title="AI Maturity: Bronze level rules">
    * Git PR templates exist<br />
      `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<br />
      `git.fileExists(".pre-commit-config.yaml")`
    * Repository contains README file<br />
      `git.fileExists("README.md")`
  </Accordion>

  <Accordion title="AI Maturity: Silver level rules">
    * Anthropic Claude instructions in repo<br />
      `git.fileExists("CLAUDE.md")`
    * Google Gemini instructions in repo<br />
      `git.fileExists("GEMINI.md")`
    * GitHub Copilot coding agent development environment<br />
      `git.fileExists(".github/workflows/copilot-setup-steps.yml")`
    * GitHub Copilot instructions in repo<br />
      `git.fileExists(".github/copilot-instructions.md")`
    * Amazon Q instructions in repo<br />
      `git.fileExists("AmazonQ.md")`
  </Accordion>

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

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)query; you can edit the existing CQL or write your own queries to further refine your rules.


## Related topics

- [Scorecards](/guides/product-areas/scorecards.md)
- [Measure AI impact](/guides/ai-excellence/measure-ai-impact.md)
- [AI in Cortex](/get-started/cortex-ai-assistant.md)