Skip to content

Adds initial agents.md file#250833

Merged
tylersmalley merged 1 commit intoelastic:mainfrom
tylersmalley:ai-config/agentsmd
Jan 30, 2026
Merged

Adds initial agents.md file#250833
tylersmalley merged 1 commit intoelastic:mainfrom
tylersmalley:ai-config/agentsmd

Conversation

@tylersmalley
Copy link
Copy Markdown
Member

@tylersmalley tylersmalley commented Jan 28, 2026 •
edited by kibanamachine
Loading

A group effort between @lukeelmers, @clintandrewhall and myself. We're intentionally starting small and should really only add things as we notice unintended behavior or the LLM wasting time to figure something out. We should intentionally keep this small, and use things like skills for more detailed information.

Assigning Tech Leads as codeowners to ensure we're intentional about the content here.

@tylersmalley tylersmalley force-pushed the ai-config/agentsmd branch 4 times, most recently from 1e7a990 to ba0a141 Compare January 29, 2026 23:56
@tylersmalley tylersmalley changed the title agents.md Adds initial agents.md file Jan 29, 2026
@tylersmalley tylersmalley added release_note:skip Skip the PR/issue when compiling release notes backport:skip This PR does not require backporting v9.4.0 labels Jan 29, 2026
@tylersmalley tylersmalley marked this pull request as ready for review January 30, 2026 00:03
@tylersmalley tylersmalley force-pushed the ai-config/agentsmd branch 5 times, most recently from c795a09 to 52e8406 Compare January 30, 2026 05:16
@elasticmachine
Copy link
Copy Markdown
Contributor

elasticmachine commented Jan 30, 2026

💛 Build succeeded, but was flaky

Failed CI Steps

Test Failures

  • [job] [logs] FTR Configs #26 / Serverless Observability - Deployment-agnostic Synthetics API integration tests SyntheticsAPITests DeleteProjectMonitors only allows 500 requests at a time

Metrics [docs]

✅ unchanged

History

stratoula
stratoula approved these changes Jan 30, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@stratoula stratoula left a comment

Choose a reason for hiding this comment

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

Looks awesome! Looking forward to testing it.

What I had asked in the meeting was if we can add agents.md files on the plugin level. @timductive had started something already here #250972

If it can also go on the plugin level it would be very beneficial.

AGENTS.md

### TypeScript & Types

- Use TypeScript for all new code; avoid `any`.
Copy link
Copy Markdown
Contributor

@stratoula stratoula Jan 30, 2026

Choose a reason for hiding this comment

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

Thank you!!! It adds anys every time!

@stratoula
Copy link
Copy Markdown
Contributor

stratoula commented Jan 30, 2026 •
edited
Loading

@tylersmalley other think that it is struggling with are the tests.

  • Adds a lot of tests that some times are duplicates
  • Adds tests that do not test anything

Can we also add some guidelines on how to write tests? I usually prompt it with "do not go crazy" and it works 😛

@clintandrewhall clintandrewhall mentioned this pull request Jan 30, 2026
Closed
timductive
timductive reviewed Jan 30, 2026
View reviewed changes
clintandrewhall
clintandrewhall reviewed Jan 30, 2026
View reviewed changes
clintandrewhall
clintandrewhall reviewed Jan 30, 2026
View reviewed changes
@tylersmalley @lukeelmers @clintandrewhall
Adds initial agents.md file
dee0860 
We're intentionally starting small and should really only add things as we notice unintended behavior or the LLM wasting time to figure something out. We should intentionally keep this small, and use things like skills for more detailed information.

Assigning Tech Leads as codeowners to ensure we're intentional about the content here.

Signed-off-by: Tyler Smalley <tyler.smalley@elastic.co>
Co-authored-by: Luke Elmers <luke.elmers@elastic.co>
Co-authored-by: Clint Andrew Hall <clint.hall@elastic.co>
lukeelmers
lukeelmers reviewed Jan 30, 2026
View reviewed changes
AGENTS.md

## Critical Thinking
- Fix root cause (not band-aid).
- Unsure: read more code; if still stuck, ask w/ short options.
Copy link
Copy Markdown
Contributor

@lukeelmers lukeelmers Jan 30, 2026

Choose a reason for hiding this comment

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

is it worth calling out the dev_docs/ directory as a place to look for help first? that's where most of our developer docs come from and is a good resource. possibly also examples/

Copy link
Copy Markdown
Contributor

@stratoula stratoula Feb 2, 2026

Choose a reason for hiding this comment

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

Examples too ++

@tylersmalley tylersmalley enabled auto-merge (squash) January 30, 2026 18:41
@tylersmalley tylersmalley merged commit 64e5398 into elastic:main Jan 30, 2026
17 checks passed
@tylersmalley tylersmalley deleted the ai-config/agentsmd branch January 30, 2026 20:28
hannahbrooks pushed a commit to hannahbrooks/kibana that referenced this pull request Jan 30, 2026
@tylersmalley @lukeelmers
@clintandrewhall @hannahbrooks
Adds initial agents.md file (elastic#250833)
687bf6a 
A group effort between @lukeelmers, @clintandrewhall and myself. We're
intentionally starting small and should really only add things as we
notice unintended behavior or the LLM wasting time to figure something
out. We should intentionally keep this small, and use things like skills
for more detailed information.

Assigning Tech Leads as codeowners to ensure we're intentional about the
content here.

Signed-off-by: Tyler Smalley <tyler.smalley@elastic.co>
Co-authored-by: Luke Elmers <luke.elmers@elastic.co>
Co-authored-by: Clint Andrew Hall <clint.hall@elastic.co>
mbondyra added a commit to mbondyra/kibana that referenced this pull request Feb 2, 2026
@mbondyra
Merge commit '32efd9b2fb078ade51073fd2d0068bc74c029d6b' into copy_rev…
5daad2c 
…iew_cps

* commit '32efd9b2fb078ade51073fd2d0068bc74c029d6b': (49 commits)
  [Security Solution] Rules exceptions subfeatures (elastic#245722)
  [BK] Upgrade axios (elastic#251150)
  Fix AI Connector form fields resetting to default value when cleared by user (elastic#251095)
  deduplicate otel dependencies (elastic#250841)
  Adds initial agents.md file (elastic#250833)
  [index management] Faster index list loading (elastic#246276)
  skip failing test suite (elastic#251086)
  skip failing test suite (elastic#251048)
  [Security Solutions] Trial Companion - adjust UX design (elastic#250910)
  [Traces][Discover] Prevent flyout remount when switching document types in Trace Waterfall (elastic#250406)
  [DOCS][Cases][9.4 & Serverless]: Doc new `Maximum amount of cases to open` setting for case action (elastic#250993)
  [Discover][Traces] Explore trace.id from logs in Discover (elastic#249632)
  Remove ! from SOs docs link (elastic#251097)
  [ML] Maps: Add telemetry events for file uploads (elastic#247543)
  [Fleet] Fix dupplicate ids when copying an integration policy or an agent policy (elastic#250971)
  [Dashboards as Code] Add snake case object keys util (elastic#250962)
  [Core] Remove URL Overflow & Deprecate `storeInSessionStorage` setting (elastic#242972)
  [One Workflow] fix: Fix Variable Retrieval in Workflow Execution Engine (elastic#250852)
  Rework Elastic Managed LLMs page (elastic#251069)
  [Lens powered by ES|QL] Update Switch to Query mode modal warning message (elastic#251051)
  ...
@tylersmalley tylersmalley added backport:all-open Backport to all branches that could still receive a release and removed backport:skip This PR does not require backporting labels Feb 18, 2026
tylersmalley added a commit to tylersmalley/kibana that referenced this pull request Feb 18, 2026
@tylersmalley @lukeelmers @clintandrewhall
Adds initial agents.md file (elastic#250833)
945f358 
A group effort between @lukeelmers, @clintandrewhall and myself. We're
intentionally starting small and should really only add things as we
notice unintended behavior or the LLM wasting time to figure something
out. We should intentionally keep this small, and use things like skills
for more detailed information.

Assigning Tech Leads as codeowners to ensure we're intentional about the
content here.

Signed-off-by: Tyler Smalley <tyler.smalley@elastic.co>
Co-authored-by: Luke Elmers <luke.elmers@elastic.co>
Co-authored-by: Clint Andrew Hall <clint.hall@elastic.co>
(cherry picked from commit 64e5398)
@tylersmalley tylersmalley mentioned this pull request Feb 18, 2026
Merged
tylersmalley added a commit to tylersmalley/kibana that referenced this pull request Feb 18, 2026
@tylersmalley @lukeelmers @clintandrewhall
Adds initial agents.md file (elastic#250833)
ff17ebe 
A group effort between @lukeelmers, @clintandrewhall and myself. We're
intentionally starting small and should really only add things as we
notice unintended behavior or the LLM wasting time to figure something
out. We should intentionally keep this small, and use things like skills
for more detailed information.

Assigning Tech Leads as codeowners to ensure we're intentional about the
content here.

Signed-off-by: Tyler Smalley <tyler.smalley@elastic.co>
Co-authored-by: Luke Elmers <luke.elmers@elastic.co>
Co-authored-by: Clint Andrew Hall <clint.hall@elastic.co>
(cherry picked from commit 64e5398)
@tylersmalley tylersmalley mentioned this pull request Feb 18, 2026
Merged
@elastic elastic deleted a comment from kibanamachine Feb 18, 2026
tylersmalley added a commit to tylersmalley/kibana that referenced this pull request Feb 18, 2026
@tylersmalley @lukeelmers @clintandrewhall
Adds initial agents.md file (elastic#250833)
15de05a 
A group effort between @lukeelmers, @clintandrewhall and myself. We're
intentionally starting small and should really only add things as we
notice unintended behavior or the LLM wasting time to figure something
out. We should intentionally keep this small, and use things like skills
for more detailed information.

Assigning Tech Leads as codeowners to ensure we're intentional about the
content here.

Signed-off-by: Tyler Smalley <tyler.smalley@elastic.co>
Co-authored-by: Luke Elmers <luke.elmers@elastic.co>
Co-authored-by: Clint Andrew Hall <clint.hall@elastic.co>
(cherry picked from commit 64e5398)
@tylersmalley tylersmalley mentioned this pull request Feb 18, 2026
Merged
@tylersmalley
Copy link
Copy Markdown
Member Author

tylersmalley commented Feb 18, 2026

💚 All backports created successfully

Status Branch Result
✅ 9.3
✅ 9.2
✅ 8.19

Note: Successful backport PRs will be merged automatically after passing CI.

Questions ?

Please refer to the Backport tool documentation

@elastic elastic deleted a comment from kibanamachine Feb 18, 2026
tylersmalley added a commit that referenced this pull request Feb 18, 2026
@tylersmalley @lukeelmers @clintandrewhall
[9.2] Adds initial agents.md file (#250833) (#253806)
cb1b752 
# Backport

This will backport the following commits from `main` to `9.2`:
- [Adds initial agents.md file
(#250833)](#250833)

<!--- Backport version: 10.2.0 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sorenlouv/backport)

<!--BACKPORT [{"author":{"name":"Tyler
Smalley","email":"tyler.smalley@elastic.co"},"sourceCommit":{"committedDate":"2026-01-30T20:28:49Z","message":"Adds
initial agents.md file (#250833)\n\nA group effort between @lukeelmers,
@clintandrewhall and myself. We're\nintentionally starting small and
should really only add things as we\nnotice unintended behavior or the
LLM wasting time to figure something\nout. We should intentionally keep
this small, and use things like skills\nfor more detailed
information.\n\nAssigning Tech Leads as codeowners to ensure we're
intentional about the\ncontent here.\n\nSigned-off-by: Tyler Smalley
<tyler.smalley@elastic.co>\nCo-authored-by: Luke Elmers
<luke.elmers@elastic.co>\nCo-authored-by: Clint Andrew Hall
<clint.hall@elastic.co>","sha":"64e53989d21cd553a1c5592d597d085b6ab0cbca","branchLabelMapping":{"^v9.4.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:skip","backport:skip","v9.4.0"],"title":"Adds
initial agents.md
file","number":250833,"url":"https://github.com/elastic/kibana/pull/250833","mergeCommit":{"message":"Adds
initial agents.md file (#250833)\n\nA group effort between @lukeelmers,
@clintandrewhall and myself. We're\nintentionally starting small and
should really only add things as we\nnotice unintended behavior or the
LLM wasting time to figure something\nout. We should intentionally keep
this small, and use things like skills\nfor more detailed
information.\n\nAssigning Tech Leads as codeowners to ensure we're
intentional about the\ncontent here.\n\nSigned-off-by: Tyler Smalley
<tyler.smalley@elastic.co>\nCo-authored-by: Luke Elmers
<luke.elmers@elastic.co>\nCo-authored-by: Clint Andrew Hall
<clint.hall@elastic.co>","sha":"64e53989d21cd553a1c5592d597d085b6ab0cbca"}},"sourceBranch":"main","suggestedTargetBranches":[],"targetPullRequestStates":[{"branch":"main","label":"v9.4.0","branchLabelMappingKey":"^v9.4.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/250833","number":250833,"mergeCommit":{"message":"Adds
initial agents.md file (#250833)\n\nA group effort between @lukeelmers,
@clintandrewhall and myself. We're\nintentionally starting small and
should really only add things as we\nnotice unintended behavior or the
LLM wasting time to figure something\nout. We should intentionally keep
this small, and use things like skills\nfor more detailed
information.\n\nAssigning Tech Leads as codeowners to ensure we're
intentional about the\ncontent here.\n\nSigned-off-by: Tyler Smalley
<tyler.smalley@elastic.co>\nCo-authored-by: Luke Elmers
<luke.elmers@elastic.co>\nCo-authored-by: Clint Andrew Hall
<clint.hall@elastic.co>","sha":"64e53989d21cd553a1c5592d597d085b6ab0cbca"}}]}]
BACKPORT-->

Signed-off-by: Tyler Smalley <tyler.smalley@elastic.co>
Co-authored-by: Luke Elmers <luke.elmers@elastic.co>
Co-authored-by: Clint Andrew Hall <clint.hall@elastic.co>
tylersmalley added a commit that referenced this pull request Feb 18, 2026
@tylersmalley @lukeelmers @clintandrewhall
[9.3] Adds initial agents.md file (#250833) (#253805)
6da2d47 
# Backport

This will backport the following commits from `main` to `9.3`:
- [Adds initial agents.md file
(#250833)](#250833)

<!--- Backport version: 10.2.0 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sorenlouv/backport)

<!--BACKPORT [{"author":{"name":"Tyler
Smalley","email":"tyler.smalley@elastic.co"},"sourceCommit":{"committedDate":"2026-01-30T20:28:49Z","message":"Adds
initial agents.md file (#250833)\n\nA group effort between @lukeelmers,
@clintandrewhall and myself. We're\nintentionally starting small and
should really only add things as we\nnotice unintended behavior or the
LLM wasting time to figure something\nout. We should intentionally keep
this small, and use things like skills\nfor more detailed
information.\n\nAssigning Tech Leads as codeowners to ensure we're
intentional about the\ncontent here.\n\nSigned-off-by: Tyler Smalley
<tyler.smalley@elastic.co>\nCo-authored-by: Luke Elmers
<luke.elmers@elastic.co>\nCo-authored-by: Clint Andrew Hall
<clint.hall@elastic.co>","sha":"64e53989d21cd553a1c5592d597d085b6ab0cbca","branchLabelMapping":{"^v9.4.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:skip","backport:skip","v9.4.0"],"title":"Adds
initial agents.md
file","number":250833,"url":"https://github.com/elastic/kibana/pull/250833","mergeCommit":{"message":"Adds
initial agents.md file (#250833)\n\nA group effort between @lukeelmers,
@clintandrewhall and myself. We're\nintentionally starting small and
should really only add things as we\nnotice unintended behavior or the
LLM wasting time to figure something\nout. We should intentionally keep
this small, and use things like skills\nfor more detailed
information.\n\nAssigning Tech Leads as codeowners to ensure we're
intentional about the\ncontent here.\n\nSigned-off-by: Tyler Smalley
<tyler.smalley@elastic.co>\nCo-authored-by: Luke Elmers
<luke.elmers@elastic.co>\nCo-authored-by: Clint Andrew Hall
<clint.hall@elastic.co>","sha":"64e53989d21cd553a1c5592d597d085b6ab0cbca"}},"sourceBranch":"main","suggestedTargetBranches":[],"targetPullRequestStates":[{"branch":"main","label":"v9.4.0","branchLabelMappingKey":"^v9.4.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/250833","number":250833,"mergeCommit":{"message":"Adds
initial agents.md file (#250833)\n\nA group effort between @lukeelmers,
@clintandrewhall and myself. We're\nintentionally starting small and
should really only add things as we\nnotice unintended behavior or the
LLM wasting time to figure something\nout. We should intentionally keep
this small, and use things like skills\nfor more detailed
information.\n\nAssigning Tech Leads as codeowners to ensure we're
intentional about the\ncontent here.\n\nSigned-off-by: Tyler Smalley
<tyler.smalley@elastic.co>\nCo-authored-by: Luke Elmers
<luke.elmers@elastic.co>\nCo-authored-by: Clint Andrew Hall
<clint.hall@elastic.co>","sha":"64e53989d21cd553a1c5592d597d085b6ab0cbca"}}]}]
BACKPORT-->

Signed-off-by: Tyler Smalley <tyler.smalley@elastic.co>
Co-authored-by: Luke Elmers <luke.elmers@elastic.co>
Co-authored-by: Clint Andrew Hall <clint.hall@elastic.co>
This was referenced Feb 19, 2026
Merged
Merged
tylersmalley added a commit that referenced this pull request Feb 19, 2026
@tylersmalley @lukeelmers @clintandrewhall
[8.19] Adds initial agents.md file (#250833) (#253808)
093f395 
# Backport

This will backport the following commits from `main` to `8.19`:
- [Adds initial agents.md file
(#250833)](#250833)

<!--- Backport version: 10.2.0 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sorenlouv/backport)

<!--BACKPORT [{"author":{"name":"Tyler
Smalley","email":"tyler.smalley@elastic.co"},"sourceCommit":{"committedDate":"2026-01-30T20:28:49Z","message":"Adds
initial agents.md file (#250833)\n\nA group effort between @lukeelmers,
@clintandrewhall and myself. We're\nintentionally starting small and
should really only add things as we\nnotice unintended behavior or the
LLM wasting time to figure something\nout. We should intentionally keep
this small, and use things like skills\nfor more detailed
information.\n\nAssigning Tech Leads as codeowners to ensure we're
intentional about the\ncontent here.\n\nSigned-off-by: Tyler Smalley
<tyler.smalley@elastic.co>\nCo-authored-by: Luke Elmers
<luke.elmers@elastic.co>\nCo-authored-by: Clint Andrew Hall
<clint.hall@elastic.co>","sha":"64e53989d21cd553a1c5592d597d085b6ab0cbca","branchLabelMapping":{"^v9.4.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:skip","backport:skip","v9.4.0"],"title":"Adds
initial agents.md
file","number":250833,"url":"https://github.com/elastic/kibana/pull/250833","mergeCommit":{"message":"Adds
initial agents.md file (#250833)\n\nA group effort between @lukeelmers,
@clintandrewhall and myself. We're\nintentionally starting small and
should really only add things as we\nnotice unintended behavior or the
LLM wasting time to figure something\nout. We should intentionally keep
this small, and use things like skills\nfor more detailed
information.\n\nAssigning Tech Leads as codeowners to ensure we're
intentional about the\ncontent here.\n\nSigned-off-by: Tyler Smalley
<tyler.smalley@elastic.co>\nCo-authored-by: Luke Elmers
<luke.elmers@elastic.co>\nCo-authored-by: Clint Andrew Hall
<clint.hall@elastic.co>","sha":"64e53989d21cd553a1c5592d597d085b6ab0cbca"}},"sourceBranch":"main","suggestedTargetBranches":[],"targetPullRequestStates":[{"branch":"main","label":"v9.4.0","branchLabelMappingKey":"^v9.4.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/250833","number":250833,"mergeCommit":{"message":"Adds
initial agents.md file (#250833)\n\nA group effort between @lukeelmers,
@clintandrewhall and myself. We're\nintentionally starting small and
should really only add things as we\nnotice unintended behavior or the
LLM wasting time to figure something\nout. We should intentionally keep
this small, and use things like skills\nfor more detailed
information.\n\nAssigning Tech Leads as codeowners to ensure we're
intentional about the\ncontent here.\n\nSigned-off-by: Tyler Smalley
<tyler.smalley@elastic.co>\nCo-authored-by: Luke Elmers
<luke.elmers@elastic.co>\nCo-authored-by: Clint Andrew Hall
<clint.hall@elastic.co>","sha":"64e53989d21cd553a1c5592d597d085b6ab0cbca"}}]}]
BACKPORT-->

Signed-off-by: Tyler Smalley <tyler.smalley@elastic.co>
Co-authored-by: Luke Elmers <luke.elmers@elastic.co>
Co-authored-by: Clint Andrew Hall <clint.hall@elastic.co>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@timductive timductive timductive left review comments

@lukeelmers lukeelmers lukeelmers left review comments

@stratoula stratoula stratoula approved these changes

@clintandrewhall clintandrewhall clintandrewhall approved these changes

Assignees

No one assigned

Labels

backport:all-open Backport to all branches that could still receive a release release_note:skip Skip the PR/issue when compiling release notes v8.19.12 v9.2.6 v9.3.1 v9.4.0

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

7 participants

@tylersmalley @elasticmachine @stratoula @clintandrewhall @timductive @lukeelmers @kibanamachine