Add AGENTS.md for better LLM use by lurtz · Pull Request #22 · eclipse-score/inc_someip_gateway

lurtz · 2026-02-16T11:00:07Z

AGENTS.md should make using LLMs more effective by requiring less manual fixes of the generate code.

github-actions · 2026-02-16T11:04:00Z

License Check Results

🚀 The license check job ran with the Bazel command:

bazel run //:license-check

Status: ⚠️ Needs Review

Click to expand output

[License Check Output]
2026/04/02 08:45:51 Downloading https://releases.bazel.build/8.3.0/release/bazel-8.3.0-linux-x86_64...
Extracting Bazel installation...
Starting local Bazel server (8.3.0) and connecting to it...
INFO: Invocation ID: 23395aa3-3f77-4184-8a06-53a98b11eedf
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
WARNING: For repository 'score_bazel_platforms', the root module requires module version score_bazel_platforms@0.0.4, but got score_bazel_platforms@0.1.1 in the resolved dependency graph. Please update the version in your MODULE.bazel or set --check_direct_dependencies=off
WARNING: For repository 'score_tooling', the root module requires module version score_tooling@1.0.4, but got score_tooling@1.1.2 in the resolved dependency graph. Please update the version in your MODULE.bazel or set --check_direct_dependencies=off
Computing main repo mapping: 
Computing main repo mapping: 
Loading: 
Loading: 4 packages loaded
Loading: 4 packages loaded
    currently loading: 
Loading: 4 packages loaded
    currently loading: 
Loading: 4 packages loaded
    currently loading: 
Loading: 4 packages loaded
    currently loading: 
Analyzing: target //:license-check (5 packages loaded, 0 targets configured)
Analyzing: target //:license-check (5 packages loaded, 0 targets configured)

Analyzing: target //:license-check (29 packages loaded, 10 targets configured)

Analyzing: target //:license-check (87 packages loaded, 10 targets configured)

Analyzing: target //:license-check (94 packages loaded, 10 targets configured)

Analyzing: target //:license-check (108 packages loaded, 56 targets configured)

Analyzing: target //:license-check (165 packages loaded, 2849 targets configured)

Analyzing: target //:license-check (170 packages loaded, 5324 targets configured)

Analyzing: target //:license-check (170 packages loaded, 5324 targets configured)

Analyzing: target //:license-check (171 packages loaded, 5324 targets configured)

Analyzing: target //:license-check (173 packages loaded, 7331 targets configured)

Analyzing: target //:license-check (173 packages loaded, 7331 targets configured)

Analyzing: target //:license-check (175 packages loaded, 10039 targets configured)

Analyzing: target //:license-check (176 packages loaded, 10059 targets configured)

Analyzing: target //:license-check (176 packages loaded, 10059 targets configured)

Analyzing: target //:license-check (177 packages loaded, 10067 targets configured)

Analyzing: target //:license-check (177 packages loaded, 10067 targets configured)

Analyzing: target //:license-check (178 packages loaded, 10187 targets configured)

INFO: Analyzed target //:license-check (179 packages loaded, 11766 targets configured).
[7 / 13] checking cached actions
[9 / 13] checking cached actions
[9 / 13] JavaToolchainCompileClasses external/rules_java+/toolchains/platformclasspath_classes; 0s disk-cache, processwrapper-sandbox
INFO: From Generating Dash formatted dependency file ...:
INFO: Successfully converted 2 packages from Cargo.lock to bazel-out/k8-fastbuild/bin/formatted.txt
[11 / 13] JavaToolchainCompileBootClasspath external/rules_java+/toolchains/platformclasspath.jar; 0s disk-cache, processwrapper-sandbox
[12 / 13] Building license.check.license_check.jar (); 0s disk-cache, multiplex-worker
INFO: Found 1 target...
Target //:license.check.license_check up-to-date:
  bazel-bin/license.check.license_check
  bazel-bin/license.check.license_check.jar
INFO: Elapsed time: 212.705s, Critical Path: 2.49s
INFO: 13 processes: 9 internal, 3 processwrapper-sandbox, 1 worker.
INFO: Build completed successfully, 13 total actions
INFO: Running command line: bazel-bin/license.check.license_check ./formatted.txt <args omitted>
usage: org.eclipse.dash.licenses.cli.Main [-batch <int>] [-cd <url>]
       [-confidence <int>] [-ef <url>] [-excludeSources <sources>] [-help] [-lic
       <url>] [-project <shortname>] [-repo <url>] [-review] [-summary <file>]
       [-timeout <seconds>] [-token <token>]

github-actions · 2026-02-16T11:04:02Z

The created documentation from the pull request is available at: docu-html

AlexanderLanin · 2026-02-16T11:39:03Z

Can you explain how to use this? AFAIK copilot will only pick up files like these automatically: https://github.com/eclipse-score/docs-as-code/tree/main/.github/instructions

lurtz · 2026-02-16T11:55:18Z

Can you explain how to use this? AFAIK copilot will only pick up files like these automatically: https://github.com/eclipse-score/docs-as-code/tree/main/.github/instructions

The world is spinning really fast. Copilot got support for AGENTS.md:
https://github.blog/changelog/2025-08-28-copilot-coding-agent-now-supports-agents-md-custom-instructions/

The file was just created by typing /init Create a compact AGENTS.md. For new code tests should be added by default in the Chatwindow. I still have to learn what works and what does not.

lurtz · 2026-02-16T12:07:34Z

This also states a top level AGENTS.md should work:
https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions?tool=vscode#creating-custom-instructions-1

AGENTS.md

NEOatNHNG · 2026-02-16T16:34:17Z

AGENTS.md

+
+The IPC boundary between gatewayd and someipd enforces **ASIL/QM context separation**—this is a critical architectural boundary. Changes affecting message transfer across this boundary require careful review.
+
+**No direct ASIL/QM security features documented;** this is a QM-level project ([project_config.bzl](project_config.bzl)).


The gatewayd targets ASIL-B. Therefore the project is also ASIL-B, I guess?

I have at the moment no idea how we deal with the situation that have both QM and ASIL-B in this repo. Anything related to vsomeip will be QM

I removed this from the AGENTS.md file. I do not know what to do with project_config.bzl. This seems only to be required by Rust code and could get rid of it by removing the Rust code.

so the agent will pick this even when i just tell it to do some random task inside this project . wont this create conflicts and add burden to the agent limited memory ? any prompt i give will make the agent cautious because of this critical stuff . this also looks vague to me and will cause the agent to hallucinate
"The IPC boundary between gatewayd and someipd enforces ASIL/QM context separation—this is a critical architectural boundary. Changes affecting message transfer across this boundary require careful review."

yes it is used every time the agent is used. Actually the goal is to make it hallucinate less and save work for yourself by having less often to repeat yourself.

For example at the moment the agent needs to read the code to figure something out. If it would have learned the same from the AGENTS.md, it would not have needed to read the code and thus keep a smaller context window.

If we notice that instructions are misleading we can fix them.

AGENTS.md

…eanup

We are ourselves confused how we will deal with that in this code

lurtz · 2026-02-17T12:10:08Z

Keep in mind there is some discussion in Slack about this PR and might be unlikely to be merged at the moment.

Add AGENTS.md for improved slopyness

2fe96d5

AGENTS.md should make using LLMs more effective by requiring less manual fixes of the generate code.

Merge branch 'main' into add-agents-md-rust-cleanup

9043064

lurtz changed the title ~~Add AGENTS.md for improved slopyness~~ Add AGENTS.md for better LLM use Feb 16, 2026

lurtz marked this pull request as ready for review February 16, 2026 13:36

NEOatNHNG reviewed Feb 16, 2026

View reviewed changes

lurtz added 4 commits February 17, 2026 11:55

Merge remote-tracking branch 'origin/main' into add-agents-md-rust-cl…

e1a3131

…eanup

update year

ecf1848

remove signing eclipse contributors agreement

6f84384

remove ASIL / QM security features statement

d22bd1e

We are ourselves confused how we will deal with that in this code

lurtz had a problem deploying to workflow-approval February 17, 2026 12:05 — with GitHub Actions Failure

lurtz force-pushed the add-agents-md-rust-cleanup branch from 8b03d56 to d22bd1e Compare February 17, 2026 12:07

lurtz had a problem deploying to workflow-approval February 17, 2026 12:07 — with GitHub Actions Failure

lurtz temporarily deployed to workflow-approval March 11, 2026 12:26 — with GitHub Actions Inactive

lurtz had a problem deploying to workflow-approval March 11, 2026 12:26 — with GitHub Actions Failure

lurtz and others added 2 commits April 2, 2026 10:09

Merge branch 'main' into add-agents-md-rust-cleanup

e8addef

reflect last changes and add default directory layout

c6f7488

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add AGENTS.md for better LLM use#22

Add AGENTS.md for better LLM use#22
lurtz wants to merge 8 commits intoeclipse-score:mainfrom
elektrobit-contrib:add-agents-md-rust-cleanup

lurtz commented Feb 16, 2026

Uh oh!

github-actions bot commented Feb 16, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 16, 2026

Uh oh!

AlexanderLanin commented Feb 16, 2026

Uh oh!

lurtz commented Feb 16, 2026 •

edited

Loading

Uh oh!

lurtz commented Feb 16, 2026 •

edited

Loading

Uh oh!

Uh oh!

NEOatNHNG Feb 16, 2026

Uh oh!

lurtz Feb 17, 2026

Uh oh!

lurtz Feb 17, 2026

Uh oh!

TimofteBogdan1900 Feb 19, 2026 •

edited

Loading

Uh oh!

lurtz Apr 2, 2026

Uh oh!

Uh oh!

lurtz commented Feb 17, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants


		The IPC boundary between gatewayd and someipd enforces ASIL/QM context separation—this is a critical architectural boundary. Changes affecting message transfer across this boundary require careful review.

		No direct ASIL/QM security features documented; this is a QM-level project ([project_config.bzl](project_config.bzl)).

Conversation

lurtz commented Feb 16, 2026

Uh oh!

github-actions bot commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

License Check Results

Uh oh!

github-actions bot commented Feb 16, 2026

Uh oh!

AlexanderLanin commented Feb 16, 2026

Uh oh!

lurtz commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lurtz commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

NEOatNHNG Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

lurtz Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

lurtz Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

TimofteBogdan1900 Feb 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

lurtz Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

lurtz commented Feb 17, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

github-actions bot commented Feb 16, 2026 •

edited

Loading

lurtz commented Feb 16, 2026 •

edited

Loading

lurtz commented Feb 16, 2026 •

edited

Loading

TimofteBogdan1900 Feb 19, 2026 •

edited

Loading