Skip to content

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

Merged
lucaspimentel merged 2 commits into
masterfrom
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 into
masterfrom
lpimentel/ai/add-config-docs-to-agents.md

Conversation

@lucaspimentel

@lucaspimentel lucaspimentel commented Feb 13, 2026

Copy link
Copy Markdown
Member

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
Comment thread AGENTS.md Outdated
@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.

Comment thread AGENTS.md
- **`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
Copy Markdown
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 for-ai-agents 🤖 files used by AI agents, not humans label Feb 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs for-ai-agents 🤖 files used by AI agents, not humans

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants