From 96ec6e3146f01c9a722874e224b2515cda79edd8 Mon Sep 17 00:00:00 2001 From: Brice Dutheil Date: Thu, 22 Oct 2026 15:51:03 +0200 Subject: [PATCH 1/9] docs: add agent guardrails for shared modules --- .agents/shared-module-guardrails.md | 16 ++++++++++++++++ communication/AGENTS.md | 5 +++++ components/AGENTS.md | 5 +++++ dd-java-agent/agent-bootstrap/AGENTS.md | 5 +++++ dd-java-agent/agent-installer/AGENTS.md | 5 +++++ dd-java-agent/agent-tooling/AGENTS.md | 5 +++++ dd-java-agent/src/AGENTS.md | 5 +++++ dd-trace-api/AGENTS.md | 5 +++++ dd-trace-core/AGENTS.md | 5 +++++ internal-api/AGENTS.md | 5 +++++ remote-config/AGENTS.md | 5 +++++ telemetry/AGENTS.md | 5 +++++ utils/AGENTS.md | 5 +++++ 13 files changed, 76 insertions(+) create mode 100644 .agents/shared-module-guardrails.md create mode 100644 communication/AGENTS.md create mode 100644 components/AGENTS.md create mode 100644 dd-java-agent/agent-bootstrap/AGENTS.md create mode 100644 dd-java-agent/agent-installer/AGENTS.md create mode 100644 dd-java-agent/agent-tooling/AGENTS.md create mode 100644 dd-java-agent/src/AGENTS.md create mode 100644 dd-trace-api/AGENTS.md create mode 100644 dd-trace-core/AGENTS.md create mode 100644 internal-api/AGENTS.md create mode 100644 remote-config/AGENTS.md create mode 100644 telemetry/AGENTS.md create mode 100644 utils/AGENTS.md diff --git a/.agents/shared-module-guardrails.md b/.agents/shared-module-guardrails.md new file mode 100644 index 00000000000..99fa140580a --- /dev/null +++ b/.agents/shared-module-guardrails.md @@ -0,0 +1,16 @@ +# Shared module guardrails + +These rules apply in directories whose `AGENTS.md` links here. + +- Before editing, warn the user that the change affects shared code and needs Language Platform review. +- Keep behavior for one product in its product module or instrumentation. Change a shared module for a product + feature only when product code and existing contracts cannot meet the requirement. +- Argue why the shared change belongs here, which consumers it affects, and any compatibility risks. Keep the + shared change minimal. +- In a PR, put that argument under `# Motivation`. Check [CODEOWNERS](../.github/CODEOWNERS) for the current area + owner. Under `# Additional Notes`, include this GitHub alert: + + ```markdown + > [!IMPORTANT] + > Language Platform review is needed for this shared module change. Please involve @DataDog/apm-lang-platform-java. + ``` diff --git a/communication/AGENTS.md b/communication/AGENTS.md new file mode 100644 index 00000000000..200be5db221 --- /dev/null +++ b/communication/AGENTS.md @@ -0,0 +1,5 @@ +# communication + +HTTP transport, agent discovery, and communication objects shared by product modules. + +Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/components/AGENTS.md b/components/AGENTS.md new file mode 100644 index 00000000000..09a9dbc370a --- /dev/null +++ b/components/AGENTS.md @@ -0,0 +1,5 @@ +# components + +Low-level context, environment, JSON, HTTP, and native loading components shared by the agent. + +Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/dd-java-agent/agent-bootstrap/AGENTS.md b/dd-java-agent/agent-bootstrap/AGENTS.md new file mode 100644 index 00000000000..f699b94e635 --- /dev/null +++ b/dd-java-agent/agent-bootstrap/AGENTS.md @@ -0,0 +1,5 @@ +# agent-bootstrap + +Bootstrap classloader code and startup services visible across the agent. + +Read and follow the [shared module guardrails](../../.agents/shared-module-guardrails.md). diff --git a/dd-java-agent/agent-installer/AGENTS.md b/dd-java-agent/agent-installer/AGENTS.md new file mode 100644 index 00000000000..5ed49f281f2 --- /dev/null +++ b/dd-java-agent/agent-installer/AGENTS.md @@ -0,0 +1,5 @@ +# agent-installer + +Instrumentation installation and class transformation pipeline shared by products. + +Read and follow the [shared module guardrails](../../.agents/shared-module-guardrails.md). diff --git a/dd-java-agent/agent-tooling/AGENTS.md b/dd-java-agent/agent-tooling/AGENTS.md new file mode 100644 index 00000000000..81764c97a20 --- /dev/null +++ b/dd-java-agent/agent-tooling/AGENTS.md @@ -0,0 +1,5 @@ +# agent-tooling + +Instrumentation framework for matching, advice, and Muzzle validation. + +Read and follow the [shared module guardrails](../../.agents/shared-module-guardrails.md). diff --git a/dd-java-agent/src/AGENTS.md b/dd-java-agent/src/AGENTS.md new file mode 100644 index 00000000000..f0aac5e1476 --- /dev/null +++ b/dd-java-agent/src/AGENTS.md @@ -0,0 +1,5 @@ +# dd-java-agent/src + +Agent entry point and jar loading code used during premain. + +Read and follow the [shared module guardrails](../../.agents/shared-module-guardrails.md). diff --git a/dd-trace-api/AGENTS.md b/dd-trace-api/AGENTS.md new file mode 100644 index 00000000000..c9801d4ff6d --- /dev/null +++ b/dd-trace-api/AGENTS.md @@ -0,0 +1,5 @@ +# dd-trace-api + +Public tracing API and configuration keys used by applications and agent modules. + +Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/dd-trace-core/AGENTS.md b/dd-trace-core/AGENTS.md new file mode 100644 index 00000000000..575a6c0be75 --- /dev/null +++ b/dd-trace-core/AGENTS.md @@ -0,0 +1,5 @@ +# dd-trace-core + +Core tracer, spans, propagation, sampling, and writer pipeline. + +Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/internal-api/AGENTS.md b/internal-api/AGENTS.md new file mode 100644 index 00000000000..6387499d8d9 --- /dev/null +++ b/internal-api/AGENTS.md @@ -0,0 +1,5 @@ +# internal-api + +Internal contracts shared across agent modules, including product interfaces. + +Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/remote-config/AGENTS.md b/remote-config/AGENTS.md new file mode 100644 index 00000000000..9855f82babc --- /dev/null +++ b/remote-config/AGENTS.md @@ -0,0 +1,5 @@ +# remote-config + +Remote configuration API and polling client used by multiple products. + +Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/telemetry/AGENTS.md b/telemetry/AGENTS.md new file mode 100644 index 00000000000..c04bb386728 --- /dev/null +++ b/telemetry/AGENTS.md @@ -0,0 +1,5 @@ +# telemetry + +Agent telemetry collection and reporting used by multiple products. + +Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/utils/AGENTS.md b/utils/AGENTS.md new file mode 100644 index 00000000000..3d632009e2f --- /dev/null +++ b/utils/AGENTS.md @@ -0,0 +1,5 @@ +# utils + +Shared utility modules for configuration, queues, sockets, time, and test support. + +Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). From 50cc9325e648c37c272f6ee8bf82a11ae7a278d5 Mon Sep 17 00:00:00 2001 From: Brice Dutheil Date: Thu, 22 Oct 2026 15:57:29 +0200 Subject: [PATCH 2/9] docs: clarify shared module PR guidance --- .agents/shared-module-guardrails.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/.agents/shared-module-guardrails.md b/.agents/shared-module-guardrails.md index 99fa140580a..cfc20bd97d1 100644 --- a/.agents/shared-module-guardrails.md +++ b/.agents/shared-module-guardrails.md @@ -4,11 +4,12 @@ These rules apply in directories whose `AGENTS.md` links here. - Before editing, warn the user that the change affects shared code and needs Language Platform review. - Keep behavior for one product in its product module or instrumentation. Change a shared module for a product - feature only when product code and existing contracts cannot meet the requirement. -- Argue why the shared change belongs here, which consumers it affects, and any compatibility risks. Keep the - shared change minimal. -- In a PR, put that argument under `# Motivation`. Check [CODEOWNERS](../.github/CODEOWNERS) for the current area - owner. Under `# Additional Notes`, include this GitHub alert: + feature only when product code and existing contracts cannot meet the requirement. Keep the shared change minimal. +- Under `# Motivation` in the PR, add `## Shared module change` apart from any product motivation. Argue why + this module must change, why product code and existing contracts cannot meet the need, which consumers it + affects, and any compatibility risks. +- Check [CODEOWNERS](../.github/CODEOWNERS) for the current area owner. Put this GitHub alert at the very start + of the PR description, before `# What Does This Do`: ```markdown > [!IMPORTANT] From 1a90bc380d4392ac1d7c9c0e40e89c300b7c88f6 Mon Sep 17 00:00:00 2001 From: Brice Dutheil Date: Thu, 22 Oct 2026 16:30:40 +0200 Subject: [PATCH 3/9] docs: protect shared modules from incidental changes --- .agents/shared-module-guardrails.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/.agents/shared-module-guardrails.md b/.agents/shared-module-guardrails.md index cfc20bd97d1..6908ba9a949 100644 --- a/.agents/shared-module-guardrails.md +++ b/.agents/shared-module-guardrails.md @@ -2,12 +2,16 @@ These rules apply in directories whose `AGENTS.md` links here. -- Before editing, warn the user that the change affects shared code and needs Language Platform review. -- Keep behavior for one product in its product module or instrumentation. Change a shared module for a product - feature only when product code and existing contracts cannot meet the requirement. Keep the shared change minimal. -- Under `# Motivation` in the PR, add `## Shared module change` apart from any product motivation. Argue why - this module must change, why product code and existing contracts cannot meet the need, which consumers it - affects, and any compatibility risks. +- Leave these modules untouched by default. Implement product features in their own modules using existing + contracts. Do not bundle changes to shared modules into a broad product PR. +- Change a shared module only for a concrete goal in that module. Language Platform can lead such work. + Outside that team, keep changes tactical and specific to this module. Put them in a separate PR from broader + product work. +- Before editing, tell the user the goal for the module and why an exception is needed. If that rationale is + unclear, leave the module untouched. Warn that Language Platform review is needed. +- Under `# Motivation` in the PR, add `## Shared module change` apart from any product motivation. Explain + the goal for this module, why the work belongs here, affected consumers, and compatibility risks. When + prompted by product work, explain why product code and existing contracts cannot meet the need. - Check [CODEOWNERS](../.github/CODEOWNERS) for the current area owner. Put this GitHub alert at the very start of the PR description, before `# What Does This Do`: From 9b13710b4d0457ff0258e69cc6148a59d5742b78 Mon Sep 17 00:00:00 2001 From: Brice Dutheil Date: Fri, 23 Oct 2026 09:57:09 +0200 Subject: [PATCH 4/9] docs: load shared module guidance for Claude --- communication/CLAUDE.md | 1 + components/CLAUDE.md | 1 + dd-java-agent/agent-bootstrap/CLAUDE.md | 1 + dd-java-agent/agent-installer/CLAUDE.md | 1 + dd-java-agent/agent-tooling/CLAUDE.md | 1 + dd-java-agent/src/CLAUDE.md | 1 + dd-trace-api/CLAUDE.md | 1 + dd-trace-core/CLAUDE.md | 1 + internal-api/CLAUDE.md | 1 + remote-config/CLAUDE.md | 1 + telemetry/CLAUDE.md | 1 + utils/CLAUDE.md | 1 + 12 files changed, 12 insertions(+) create mode 100644 communication/CLAUDE.md create mode 100644 components/CLAUDE.md create mode 100644 dd-java-agent/agent-bootstrap/CLAUDE.md create mode 100644 dd-java-agent/agent-installer/CLAUDE.md create mode 100644 dd-java-agent/agent-tooling/CLAUDE.md create mode 100644 dd-java-agent/src/CLAUDE.md create mode 100644 dd-trace-api/CLAUDE.md create mode 100644 dd-trace-core/CLAUDE.md create mode 100644 internal-api/CLAUDE.md create mode 100644 remote-config/CLAUDE.md create mode 100644 telemetry/CLAUDE.md create mode 100644 utils/CLAUDE.md diff --git a/communication/CLAUDE.md b/communication/CLAUDE.md new file mode 100644 index 00000000000..43c994c2d36 --- /dev/null +++ b/communication/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/components/CLAUDE.md b/components/CLAUDE.md new file mode 100644 index 00000000000..43c994c2d36 --- /dev/null +++ b/components/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/dd-java-agent/agent-bootstrap/CLAUDE.md b/dd-java-agent/agent-bootstrap/CLAUDE.md new file mode 100644 index 00000000000..43c994c2d36 --- /dev/null +++ b/dd-java-agent/agent-bootstrap/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/dd-java-agent/agent-installer/CLAUDE.md b/dd-java-agent/agent-installer/CLAUDE.md new file mode 100644 index 00000000000..43c994c2d36 --- /dev/null +++ b/dd-java-agent/agent-installer/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/dd-java-agent/agent-tooling/CLAUDE.md b/dd-java-agent/agent-tooling/CLAUDE.md new file mode 100644 index 00000000000..43c994c2d36 --- /dev/null +++ b/dd-java-agent/agent-tooling/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/dd-java-agent/src/CLAUDE.md b/dd-java-agent/src/CLAUDE.md new file mode 100644 index 00000000000..43c994c2d36 --- /dev/null +++ b/dd-java-agent/src/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/dd-trace-api/CLAUDE.md b/dd-trace-api/CLAUDE.md new file mode 100644 index 00000000000..43c994c2d36 --- /dev/null +++ b/dd-trace-api/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/dd-trace-core/CLAUDE.md b/dd-trace-core/CLAUDE.md new file mode 100644 index 00000000000..43c994c2d36 --- /dev/null +++ b/dd-trace-core/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/internal-api/CLAUDE.md b/internal-api/CLAUDE.md new file mode 100644 index 00000000000..43c994c2d36 --- /dev/null +++ b/internal-api/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/remote-config/CLAUDE.md b/remote-config/CLAUDE.md new file mode 100644 index 00000000000..43c994c2d36 --- /dev/null +++ b/remote-config/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/telemetry/CLAUDE.md b/telemetry/CLAUDE.md new file mode 100644 index 00000000000..43c994c2d36 --- /dev/null +++ b/telemetry/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/utils/CLAUDE.md b/utils/CLAUDE.md new file mode 100644 index 00000000000..43c994c2d36 --- /dev/null +++ b/utils/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md From 80ad98f30dcf71a39f4e30cf412cd2a49609ca11 Mon Sep 17 00:00:00 2001 From: Brice Dutheil Date: Fri, 23 Oct 2026 10:21:57 +0200 Subject: [PATCH 5/9] chore: Use platform team handle Co-authored-by: Bruce Bujon --- .agents/shared-module-guardrails.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.agents/shared-module-guardrails.md b/.agents/shared-module-guardrails.md index 6908ba9a949..589e0771259 100644 --- a/.agents/shared-module-guardrails.md +++ b/.agents/shared-module-guardrails.md @@ -4,11 +4,11 @@ These rules apply in directories whose `AGENTS.md` links here. - Leave these modules untouched by default. Implement product features in their own modules using existing contracts. Do not bundle changes to shared modules into a broad product PR. -- Change a shared module only for a concrete goal in that module. Language Platform can lead such work. +- Change a shared module only for a concrete goal in that module. Language Platform @DataDog/apm-lang-platform-java should lead such work. Outside that team, keep changes tactical and specific to this module. Put them in a separate PR from broader product work. - Before editing, tell the user the goal for the module and why an exception is needed. If that rationale is - unclear, leave the module untouched. Warn that Language Platform review is needed. + unclear, leave the module untouched. Warn that Language Platform @DataDog/apm-lang-platform-java review is needed. - Under `# Motivation` in the PR, add `## Shared module change` apart from any product motivation. Explain the goal for this module, why the work belongs here, affected consumers, and compatibility risks. When prompted by product work, explain why product code and existing contracts cannot meet the need. From 3605b9a28a1f950c7728b4bd9c04f9801a6da196 Mon Sep 17 00:00:00 2001 From: Brice Dutheil Date: Fri, 23 Oct 2026 11:00:38 +0200 Subject: [PATCH 6/9] docs: explain startup guardrail placement dd-java-agent combines jar assembly and startup sources in the parent project. Scope the guardrails under src to cover startup code and tests without applying them to every product and instrumentation subproject. Idiomatic Gradle describes separating code modules from aggregation projects: https://github.com/jjohannes/idiomatic-gradle#individual-modules---production-code-and-tests --- dd-java-agent/src/AGENTS.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/dd-java-agent/src/AGENTS.md b/dd-java-agent/src/AGENTS.md index f0aac5e1476..a4317d2ae09 100644 --- a/dd-java-agent/src/AGENTS.md +++ b/dd-java-agent/src/AGENTS.md @@ -2,4 +2,11 @@ Agent entry point and jar loading code used during premain. +> [!NOTE] +> `dd-java-agent` both assembles the agent jar and owns startup code under `src`. +> This layout does not follow Idiomatic Gradle's separation of code modules and aggregation projects: +> startup code lives in the parent project rather than in a dedicated subproject. +> These instructions therefore live under `src` to cover startup code and its tests without applying +> the same guardrails to every product and instrumentation subproject. + Read and follow the [shared module guardrails](../../.agents/shared-module-guardrails.md). From 0aa3201f134886ee25a297a149ab95f87fd95cd1 Mon Sep 17 00:00:00 2001 From: Brice Dutheil Date: Fri, 23 Oct 2026 11:23:25 +0200 Subject: [PATCH 7/9] docs: Applies suggestion --- .agents/shared-module-guardrails.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.agents/shared-module-guardrails.md b/.agents/shared-module-guardrails.md index 589e0771259..35aba7049ac 100644 --- a/.agents/shared-module-guardrails.md +++ b/.agents/shared-module-guardrails.md @@ -3,7 +3,7 @@ These rules apply in directories whose `AGENTS.md` links here. - Leave these modules untouched by default. Implement product features in their own modules using existing - contracts. Do not bundle changes to shared modules into a broad product PR. + contracts. Do not implement product specific feature into shared modules. - Change a shared module only for a concrete goal in that module. Language Platform @DataDog/apm-lang-platform-java should lead such work. Outside that team, keep changes tactical and specific to this module. Put them in a separate PR from broader product work. From fc51610f5ee776e4045577ee639716f38749534d Mon Sep 17 00:00:00 2001 From: Brice Dutheil Date: Fri, 23 Oct 2026 11:29:37 +0200 Subject: [PATCH 8/9] docs: Update CODEOWNER file for these specific AGENTS.md files --- .github/CODEOWNERS | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 09e44b790e1..78a1fc07cfc 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -19,6 +19,7 @@ # Shared communication /communication/*.* @DataDog/apm-java +/communication/*.md @DataDog/apm-lang-platform-java /communication/src/*/*/datadog/communication/*.* @DataDog/apm-java /communication/src/*/*/datadog/communication/ddagent/ @DataDog/apm-java /communication/src/*/*/datadog/communication/http/ @DataDog/apm-java @@ -29,6 +30,7 @@ /communication/src/test/resources/ @DataDog/apm-java # Shared utility modules +/utils/*.md @DataDog/apm-lang-platform-java /utils/filesystem-utils/ @DataDog/apm-java /utils/logging-utils/ @DataDog/apm-java /utils/queue-utils/ @DataDog/apm-java @@ -47,6 +49,7 @@ /dd-java-agent/load-generator/ @DataDog/apm-java # Core tracing API +/dd-trace-api/*.md @DataDog/apm-lang-platform-java /dd-trace-api/src/*/*/datadog/trace/api/*.* @DataDog/apm-java /dd-trace-api/**/config/CwsConfig* @DataDog/apm-java /dd-trace-api/**/config/GeneralConfig* @DataDog/apm-java @@ -58,6 +61,7 @@ /dd-trace-api/src/*/*/datadog/trace/payloadtags/ @DataDog/apm-java # Core tracer +/dd-trace-core/*.md @DataDog/apm-lang-platform-java /dd-trace-core/src/test @DataDog/apm-java /dd-trace-core/src/*/*/datadog/context/*.* @DataDog/apm-java /dd-trace-core/src/*/*/datadog/trace/api/naming/ @DataDog/apm-java @@ -80,6 +84,7 @@ /dd-trace-core/src/traceAgentTest/ @DataDog/apm-java # Core internal API +/internal-api/*.md @DataDog/apm-lang-platform-java /internal-api/internal-api-9/ @DataDog/apm-java /internal-api/src/test @DataDog/apm-java /internal-api/src/*/*/datadog/trace/advice/ @DataDog/apm-java From 4fcaaeca7b836396bf18174e3cb43d526f0df500 Mon Sep 17 00:00:00 2001 From: Brice Dutheil Date: Fri, 23 Oct 2026 12:00:46 +0200 Subject: [PATCH 9/9] docs: reference architecture for module descriptions Keep module descriptions in ARCHITECTURE.md to avoid documentation drift. Use "Module described in" to identify optional background information without instructing agents to load the architecture document. Link to the file without section anchors or automatic imports. Keep the explicit instruction to read and follow the shared guardrails. --- communication/AGENTS.md | 2 +- components/AGENTS.md | 2 +- dd-java-agent/agent-bootstrap/AGENTS.md | 2 +- dd-java-agent/agent-installer/AGENTS.md | 2 +- dd-java-agent/agent-tooling/AGENTS.md | 2 +- dd-java-agent/src/AGENTS.md | 2 +- dd-trace-api/AGENTS.md | 2 +- dd-trace-core/AGENTS.md | 2 +- internal-api/AGENTS.md | 2 +- remote-config/AGENTS.md | 2 +- telemetry/AGENTS.md | 2 +- utils/AGENTS.md | 2 +- 12 files changed, 12 insertions(+), 12 deletions(-) diff --git a/communication/AGENTS.md b/communication/AGENTS.md index 200be5db221..1e3ffc7cecc 100644 --- a/communication/AGENTS.md +++ b/communication/AGENTS.md @@ -1,5 +1,5 @@ # communication -HTTP transport, agent discovery, and communication objects shared by product modules. +Module described in [ARCHITECTURE.md](../ARCHITECTURE.md). Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/components/AGENTS.md b/components/AGENTS.md index 09a9dbc370a..c0fae2fc8dc 100644 --- a/components/AGENTS.md +++ b/components/AGENTS.md @@ -1,5 +1,5 @@ # components -Low-level context, environment, JSON, HTTP, and native loading components shared by the agent. +Module described in [ARCHITECTURE.md](../ARCHITECTURE.md). Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/dd-java-agent/agent-bootstrap/AGENTS.md b/dd-java-agent/agent-bootstrap/AGENTS.md index f699b94e635..90e1148e1e4 100644 --- a/dd-java-agent/agent-bootstrap/AGENTS.md +++ b/dd-java-agent/agent-bootstrap/AGENTS.md @@ -1,5 +1,5 @@ # agent-bootstrap -Bootstrap classloader code and startup services visible across the agent. +Module described in [ARCHITECTURE.md](../../ARCHITECTURE.md). Read and follow the [shared module guardrails](../../.agents/shared-module-guardrails.md). diff --git a/dd-java-agent/agent-installer/AGENTS.md b/dd-java-agent/agent-installer/AGENTS.md index 5ed49f281f2..2ad4d9e1980 100644 --- a/dd-java-agent/agent-installer/AGENTS.md +++ b/dd-java-agent/agent-installer/AGENTS.md @@ -1,5 +1,5 @@ # agent-installer -Instrumentation installation and class transformation pipeline shared by products. +Module described in [ARCHITECTURE.md](../../ARCHITECTURE.md). Read and follow the [shared module guardrails](../../.agents/shared-module-guardrails.md). diff --git a/dd-java-agent/agent-tooling/AGENTS.md b/dd-java-agent/agent-tooling/AGENTS.md index 81764c97a20..70915012126 100644 --- a/dd-java-agent/agent-tooling/AGENTS.md +++ b/dd-java-agent/agent-tooling/AGENTS.md @@ -1,5 +1,5 @@ # agent-tooling -Instrumentation framework for matching, advice, and Muzzle validation. +Module described in [ARCHITECTURE.md](../../ARCHITECTURE.md). Read and follow the [shared module guardrails](../../.agents/shared-module-guardrails.md). diff --git a/dd-java-agent/src/AGENTS.md b/dd-java-agent/src/AGENTS.md index a4317d2ae09..6ad3352a0f2 100644 --- a/dd-java-agent/src/AGENTS.md +++ b/dd-java-agent/src/AGENTS.md @@ -1,6 +1,6 @@ # dd-java-agent/src -Agent entry point and jar loading code used during premain. +Module described in [ARCHITECTURE.md](../../ARCHITECTURE.md). > [!NOTE] > `dd-java-agent` both assembles the agent jar and owns startup code under `src`. diff --git a/dd-trace-api/AGENTS.md b/dd-trace-api/AGENTS.md index c9801d4ff6d..a2874c71be3 100644 --- a/dd-trace-api/AGENTS.md +++ b/dd-trace-api/AGENTS.md @@ -1,5 +1,5 @@ # dd-trace-api -Public tracing API and configuration keys used by applications and agent modules. +Module described in [ARCHITECTURE.md](../ARCHITECTURE.md). Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/dd-trace-core/AGENTS.md b/dd-trace-core/AGENTS.md index 575a6c0be75..b89d9e78ffc 100644 --- a/dd-trace-core/AGENTS.md +++ b/dd-trace-core/AGENTS.md @@ -1,5 +1,5 @@ # dd-trace-core -Core tracer, spans, propagation, sampling, and writer pipeline. +Module described in [ARCHITECTURE.md](../ARCHITECTURE.md). Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/internal-api/AGENTS.md b/internal-api/AGENTS.md index 6387499d8d9..fd5541a184b 100644 --- a/internal-api/AGENTS.md +++ b/internal-api/AGENTS.md @@ -1,5 +1,5 @@ # internal-api -Internal contracts shared across agent modules, including product interfaces. +Module described in [ARCHITECTURE.md](../ARCHITECTURE.md). Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/remote-config/AGENTS.md b/remote-config/AGENTS.md index 9855f82babc..ffcb2a3349a 100644 --- a/remote-config/AGENTS.md +++ b/remote-config/AGENTS.md @@ -1,5 +1,5 @@ # remote-config -Remote configuration API and polling client used by multiple products. +Module described in [ARCHITECTURE.md](../ARCHITECTURE.md). Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/telemetry/AGENTS.md b/telemetry/AGENTS.md index c04bb386728..f193ea1ac3c 100644 --- a/telemetry/AGENTS.md +++ b/telemetry/AGENTS.md @@ -1,5 +1,5 @@ # telemetry -Agent telemetry collection and reporting used by multiple products. +Module described in [ARCHITECTURE.md](../ARCHITECTURE.md). Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md). diff --git a/utils/AGENTS.md b/utils/AGENTS.md index 3d632009e2f..24490a1a1af 100644 --- a/utils/AGENTS.md +++ b/utils/AGENTS.md @@ -1,5 +1,5 @@ # utils -Shared utility modules for configuration, queues, sockets, time, and test support. +Module described in [ARCHITECTURE.md](../ARCHITECTURE.md). Read and follow the [shared module guardrails](../.agents/shared-module-guardrails.md).