Skip to content

[docs for ai] Add configuration reference docs to AGENTS.md#8201

Merged
lucaspimentel merged 2 commits intomasterfrom
lpimentel/ai/add-config-docs-to-agents.md
Feb 13, 2026
Merged

[docs for ai] Add configuration reference docs to AGENTS.md#8201
lucaspimentel merged 2 commits intomasterfrom
lpimentel/ai/add-config-docs-to-agents.md

Conversation

@lucaspimentel
Copy link
Member

@lucaspimentel lucaspimentel commented Feb 13, 2026

Summary of changes

Added a Configuration section to AGENTS.md with references to:

  • supported-configurations-docs.yaml — human-readable descriptions and defaults for all DD_* env vars
  • supported-configurations.json — machine-readable metadata (product categorization, aliases, deprecations)
  • docs/development/Configuration/AddingConfigurationKeys.md — step-by-step guide for adding new config keys

Reason for change

AI agents working in this repo need quick access to tracer configuration documentation. The two reference files and the how-to guide were not linked from AGENTS.md.

Implementation details

Added entries following the established "📖 Load when..." pattern, with two load-when groups:

  1. Reference lookup — for querying existing config settings
  2. Adding/modifying config keys — for the procedural guide

Test coverage

Documentation-only change.

Other details

N/A

"I linked three config files so AI agents can finally stop grepping for DD_TRACE_ENABLED like it's a scavenger hunt." — Claude 🤖

@lucaspimentel lucaspimentel changed the title [docs] Add tracer config docs to AGENTS.md for AI reference Add configuration reference to AGENTS.md Feb 13, 2026
@lucaspimentel lucaspimentel marked this pull request as ready for review February 13, 2026 16:33
@lucaspimentel lucaspimentel requested a review from a team as a code owner February 13, 2026 16:33
@lucaspimentel lucaspimentel changed the title Add configuration reference to AGENTS.md [docs for ai agent] Add configuration reference to AGENTS.md Feb 13, 2026
@lucaspimentel lucaspimentel changed the title [docs for ai agent] Add configuration reference to AGENTS.md Add configuration reference docs to AGENTS.md Feb 13, 2026
@lucaspimentel lucaspimentel requested a review from a team February 13, 2026 16:56
🤖 Co-Authored-By: Claude Code <noreply@anthropic.com>
@lucaspimentel lucaspimentel changed the title Add configuration reference docs to AGENTS.md [docs for ai] Add configuration reference docs to AGENTS.md Feb 13, 2026
@pr-commenter

This comment was marked as off-topic.

- **`tracer/src/Datadog.Trace/Configuration/supported-configurations-docs.yaml`** — Human-readable descriptions and default values for all `DD_*` environment variables
- **`tracer/src/Datadog.Trace/Configuration/supported-configurations.json`** — Machine-readable config metadata: product categorization, key aliases, and deprecations (consumed by source generators)

📖 **Load when**: Adding a new `DD_*` configuration key or modifying the configuration system
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some of these (like adding a new config or Azure Functions details) could be converted into skills that don't require calling explicitly with a slash command (disable-model-invocation: false) to reduce the size of this file.

I'll look into that later.

@lucaspimentel lucaspimentel merged commit 0fa972a into master Feb 13, 2026
98 of 101 checks passed
@lucaspimentel lucaspimentel deleted the lpimentel/ai/add-config-docs-to-agents.md branch February 13, 2026 21:12
@github-actions github-actions bot added this to the vNext-v3 milestone Feb 13, 2026
@lucaspimentel lucaspimentel added the ai-agents 🤖 files used by AI agents label Feb 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai-agents 🤖 files used by AI agents area:docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants