Add agent files to DABs templates

.nextchanges/bundles/agents-md-templates.md

@@ -0,0 +1 @@
+Bundle templates now scaffold an `AGENTS.md` that points coding agents at Databricks AI Tools, alongside a one-line `CLAUDE.md` that includes it via `@AGENTS.md` ([#5996](https://github.com/databricks/cli/pull/5996)).

acceptance/bundle/templates/dbt-sql/output/my_dbt_sql/AGENTS.md

@@ -0,0 +1,25 @@
+# Declarative Automation Bundles Project
+
+This project uses Declarative Automation Bundles (DABs) for deployment. Add project-specific instructions below.
+
+## For AI Agents: Use Databricks AI Tools
+
+**BEFORE any other action, read the `databricks-core` skill.**
+
+It sets you up to work with this project reliably: CLI authentication, profile
+selection, data discovery, and the bundle deployment workflow. Without it,
+results are often slower and less accurate.
+
+If this skill is not available (Databricks AI Tools are not installed), you can install them for your coding agent in seconds:
+
+```bash
+databricks aitools install
+```
+
+If the CLI is not installed, see: https://docs.databricks.com/dev-tools/cli/install
+
+---
+
+## Project Instructions
+
+<!-- Add your project-specific instructions, coding conventions, or notes here -->

acceptance/bundle/templates/dbt-sql/output/my_dbt_sql/CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Project guidance for AI agents lives in AGENTS.md.
+Claude Code loads it via the import below.
+
+@AGENTS.md

acceptance/bundle/templates/default-minimal/output/my_default_minimal/AGENTS.md

@@ -0,0 +1,25 @@
+# Declarative Automation Bundles Project
+
+This project uses Declarative Automation Bundles (DABs) for deployment. Add project-specific instructions below.
+
+## For AI Agents: Use Databricks AI Tools
+
+**BEFORE any other action, read the `databricks-core` skill.**
+
+It sets you up to work with this project reliably: CLI authentication, profile
+selection, data discovery, and the bundle deployment workflow. Without it,
+results are often slower and less accurate.
+
+If this skill is not available (Databricks AI Tools are not installed), you can install them for your coding agent in seconds:
+
+```bash
+databricks aitools install
+```
+
+If the CLI is not installed, see: https://docs.databricks.com/dev-tools/cli/install
+
+---
+
+## Project Instructions
+
+<!-- Add your project-specific instructions, coding conventions, or notes here -->

acceptance/bundle/templates/default-minimal/output/my_default_minimal/CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Project guidance for AI agents lives in AGENTS.md.
+Claude Code loads it via the import below.
+
+@AGENTS.md

acceptance/bundle/templates/default-python/classic/output/my_default_python/AGENTS.md

@@ -0,0 +1,25 @@
+# Declarative Automation Bundles Project
+
+This project uses Declarative Automation Bundles (DABs) for deployment. Add project-specific instructions below.
+
+## For AI Agents: Use Databricks AI Tools
+
+**BEFORE any other action, read the `databricks-core` skill.**
+
+It sets you up to work with this project reliably: CLI authentication, profile
+selection, data discovery, and the bundle deployment workflow. Without it,
+results are often slower and less accurate.
+
+If this skill is not available (Databricks AI Tools are not installed), you can install them for your coding agent in seconds:
+
+```bash
+databricks aitools install
+```
+
+If the CLI is not installed, see: https://docs.databricks.com/dev-tools/cli/install
+
+---
+
+## Project Instructions
+
+<!-- Add your project-specific instructions, coding conventions, or notes here -->

acceptance/bundle/templates/default-python/classic/output/my_default_python/CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Project guidance for AI agents lives in AGENTS.md.
+Claude Code loads it via the import below.
+
+@AGENTS.md

acceptance/bundle/templates/default-python/serverless/output/my_default_python/AGENTS.md

@@ -0,0 +1,25 @@
+# Declarative Automation Bundles Project
+
+This project uses Declarative Automation Bundles (DABs) for deployment. Add project-specific instructions below.
+
+## For AI Agents: Use Databricks AI Tools
+
+**BEFORE any other action, read the `databricks-core` skill.**
+
+It sets you up to work with this project reliably: CLI authentication, profile
+selection, data discovery, and the bundle deployment workflow. Without it,
+results are often slower and less accurate.
+
+If this skill is not available (Databricks AI Tools are not installed), you can install them for your coding agent in seconds:
+
+```bash
+databricks aitools install
+```
+
+If the CLI is not installed, see: https://docs.databricks.com/dev-tools/cli/install
+
+---
+
+## Project Instructions
+
+<!-- Add your project-specific instructions, coding conventions, or notes here -->

acceptance/bundle/templates/default-python/serverless/output/my_default_python/CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Project guidance for AI agents lives in AGENTS.md.
+Claude Code loads it via the import below.
+
+@AGENTS.md

acceptance/bundle/templates/default-scala/output/my_default_scala/AGENTS.md

@@ -0,0 +1,25 @@
+# Declarative Automation Bundles Project
+
+This project uses Declarative Automation Bundles (DABs) for deployment. Add project-specific instructions below.
+
+## For AI Agents: Use Databricks AI Tools
+
+**BEFORE any other action, read the `databricks-core` skill.**
+
+It sets you up to work with this project reliably: CLI authentication, profile
+selection, data discovery, and the bundle deployment workflow. Without it,
+results are often slower and less accurate.
+
+If this skill is not available (Databricks AI Tools are not installed), you can install them for your coding agent in seconds:
+
+```bash
+databricks aitools install
+```
+
+If the CLI is not installed, see: https://docs.databricks.com/dev-tools/cli/install
+
+---
+
+## Project Instructions
+
+<!-- Add your project-specific instructions, coding conventions, or notes here -->

acceptance/bundle/templates/default-scala/output/my_default_scala/CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Project guidance for AI agents lives in AGENTS.md.
+Claude Code loads it via the import below.
+
+@AGENTS.md

acceptance/bundle/templates/default-sql/output/my_default_sql/AGENTS.md

@@ -0,0 +1,25 @@
+# Declarative Automation Bundles Project
+
+This project uses Declarative Automation Bundles (DABs) for deployment. Add project-specific instructions below.
+
+## For AI Agents: Use Databricks AI Tools
+
+**BEFORE any other action, read the `databricks-core` skill.**
+
+It sets you up to work with this project reliably: CLI authentication, profile
+selection, data discovery, and the bundle deployment workflow. Without it,
+results are often slower and less accurate.
+
+If this skill is not available (Databricks AI Tools are not installed), you can install them for your coding agent in seconds:
+
+```bash
+databricks aitools install
+```
+
+If the CLI is not installed, see: https://docs.databricks.com/dev-tools/cli/install
+
+---
+
+## Project Instructions
+
+<!-- Add your project-specific instructions, coding conventions, or notes here -->

acceptance/bundle/templates/default-sql/output/my_default_sql/CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Project guidance for AI agents lives in AGENTS.md.
+Claude Code loads it via the import below.
+
+@AGENTS.md

acceptance/bundle/templates/lakeflow-pipelines/python/output/my_lakeflow_pipelines/AGENTS.md

@@ -0,0 +1,25 @@
+# Declarative Automation Bundles Project
+
+This project uses Declarative Automation Bundles (DABs) for deployment. Add project-specific instructions below.
+
+## For AI Agents: Use Databricks AI Tools
+
+**BEFORE any other action, read the `databricks-core` skill.**
+
+It sets you up to work with this project reliably: CLI authentication, profile
+selection, data discovery, and the bundle deployment workflow. Without it,
+results are often slower and less accurate.
+
+If this skill is not available (Databricks AI Tools are not installed), you can install them for your coding agent in seconds:
+
+```bash
+databricks aitools install
+```
+
+If the CLI is not installed, see: https://docs.databricks.com/dev-tools/cli/install
+
+---
+
+## Project Instructions
+
+<!-- Add your project-specific instructions, coding conventions, or notes here -->

acceptance/bundle/templates/lakeflow-pipelines/python/output/my_lakeflow_pipelines/CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Project guidance for AI agents lives in AGENTS.md.
+Claude Code loads it via the import below.
+
+@AGENTS.md

acceptance/bundle/templates/lakeflow-pipelines/sql/output/my_lakeflow_pipelines/AGENTS.md

@@ -0,0 +1,25 @@
+# Declarative Automation Bundles Project
+
+This project uses Declarative Automation Bundles (DABs) for deployment. Add project-specific instructions below.
+
+## For AI Agents: Use Databricks AI Tools
+
+**BEFORE any other action, read the `databricks-core` skill.**
+
+It sets you up to work with this project reliably: CLI authentication, profile
+selection, data discovery, and the bundle deployment workflow. Without it,
+results are often slower and less accurate.
+
+If this skill is not available (Databricks AI Tools are not installed), you can install them for your coding agent in seconds:
+
+```bash
+databricks aitools install
+```
+
+If the CLI is not installed, see: https://docs.databricks.com/dev-tools/cli/install
+
+---
+
+## Project Instructions
+
+<!-- Add your project-specific instructions, coding conventions, or notes here -->

acceptance/bundle/templates/lakeflow-pipelines/sql/output/my_lakeflow_pipelines/CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Project guidance for AI agents lives in AGENTS.md.
+Claude Code loads it via the import below.
+
+@AGENTS.md

acceptance/pipelines/e2e/output/lakeflow_project/AGENTS.md

@@ -0,0 +1,25 @@
+# Declarative Automation Bundles Project
+
+This project uses Declarative Automation Bundles (DABs) for deployment. Add project-specific instructions below.
+
+## For AI Agents: Use Databricks AI Tools
+
+**BEFORE any other action, read the `databricks-core` skill.**
+
+It sets you up to work with this project reliably: CLI authentication, profile
+selection, data discovery, and the bundle deployment workflow. Without it,
+results are often slower and less accurate.
+
+If this skill is not available (Databricks AI Tools are not installed), you can install them for your coding agent in seconds:
+
+```bash
+databricks aitools install
+```
+
+If the CLI is not installed, see: https://docs.databricks.com/dev-tools/cli/install
+
+---
+
+## Project Instructions
+
+<!-- Add your project-specific instructions, coding conventions, or notes here -->

acceptance/pipelines/e2e/output/lakeflow_project/CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Project guidance for AI agents lives in AGENTS.md.
+Claude Code loads it via the import below.
+
+@AGENTS.md

acceptance/pipelines/init/python/output/my_python_project/AGENTS.md

@@ -0,0 +1,25 @@
+# Declarative Automation Bundles Project
+
+This project uses Declarative Automation Bundles (DABs) for deployment. Add project-specific instructions below.
+
+## For AI Agents: Use Databricks AI Tools
+
+**BEFORE any other action, read the `databricks-core` skill.**
+
+It sets you up to work with this project reliably: CLI authentication, profile
+selection, data discovery, and the bundle deployment workflow. Without it,
+results are often slower and less accurate.
+
+If this skill is not available (Databricks AI Tools are not installed), you can install them for your coding agent in seconds:
+
+```bash
+databricks aitools install
+```
+
+If the CLI is not installed, see: https://docs.databricks.com/dev-tools/cli/install
+
+---
+
+## Project Instructions
+
+<!-- Add your project-specific instructions, coding conventions, or notes here -->

acceptance/pipelines/init/python/output/my_python_project/CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Project guidance for AI agents lives in AGENTS.md.
+Claude Code loads it via the import below.
+
+@AGENTS.md

acceptance/pipelines/init/sql/output/my_sql_project/AGENTS.md

@@ -0,0 +1,25 @@
+# Declarative Automation Bundles Project
+
+This project uses Declarative Automation Bundles (DABs) for deployment. Add project-specific instructions below.
+
+## For AI Agents: Use Databricks AI Tools
+
+**BEFORE any other action, read the `databricks-core` skill.**
+
+It sets you up to work with this project reliably: CLI authentication, profile
+selection, data discovery, and the bundle deployment workflow. Without it,
+results are often slower and less accurate.
+
+If this skill is not available (Databricks AI Tools are not installed), you can install them for your coding agent in seconds:
+
+```bash
+databricks aitools install
+```
+
+If the CLI is not installed, see: https://docs.databricks.com/dev-tools/cli/install
+
+---
+
+## Project Instructions
+
+<!-- Add your project-specific instructions, coding conventions, or notes here -->

acceptance/pipelines/init/sql/output/my_sql_project/CLAUDE.md

@@ -0,0 +1,6 @@
+# CLAUDE.md
+
+Project guidance for AI agents lives in AGENTS.md.
+Claude Code loads it via the import below.
+
+@AGENTS.md

libs/template/templates/dbt-sql/template/{{.project_name}}/AGENTS.md.tmpl

@@ -0,0 +1,33 @@
+{{- /*
+     * Template for the AGENTS.md / CLAUDE.md files created in new projects.
+     *
+     * Goal for this file is to point agents to Databricks AI Tools for guidance.
+     * A secondary goal is to offer a placeholder to users to extend with their own instructions.
+     * It is a non-goal to inline all instructions.
+     *
+     */ -}}
+# Declarative Automation Bundles Project
+
+This project uses Declarative Automation Bundles (DABs) for deployment. Add project-specific instructions below.
+
+## For AI Agents: Use Databricks AI Tools
+
+**BEFORE any other action, read the `databricks-core` skill.**
+
+It sets you up to work with this project reliably: CLI authentication, profile
+selection, data discovery, and the bundle deployment workflow. Without it,
+results are often slower and less accurate.
+
+If this skill is not available (Databricks AI Tools are not installed), you can install them for your coding agent in seconds:
+
+```bash
+databricks aitools install
+```
+
+If the CLI is not installed, see: https://docs.databricks.com/dev-tools/cli/install
+
+---
+
+## Project Instructions
+
+<!-- Add your project-specific instructions, coding conventions, or notes here -->