From d24b528c95c55503828428e60f18dc22c3c6c6c7 Mon Sep 17 00:00:00 2001 From: Igor Trujnara <53370556+itrujnara@users.noreply.github.com> Date: Mon, 1 Jun 2026 14:26:37 +0000 Subject: [PATCH 1/9] Add first draft of agents RFC document (0141) --- proposals/0141-agent-steering.md | 145 +++++++++++++++++++++++++++++++ 1 file changed, 145 insertions(+) create mode 100644 proposals/0141-agent-steering.md diff --git a/proposals/0141-agent-steering.md b/proposals/0141-agent-steering.md new file mode 100644 index 0000000..7a9caff --- /dev/null +++ b/proposals/0141-agent-steering.md @@ -0,0 +1,145 @@ +- Start Date: 2026-06-01 +- Reference Issues: https://github.com/nf-core/proposals/issues/141 +- Implementation PRs: + - None yet + +# Summary + +AI agents are an increasingly used tool in software development, and Nextflow pipelines are no exception. As it stands, nf-core has some guidance on AI use, but no specific steering files for AI agents. This RFC proposes introducing a minimal `AGENTS.md` file to the template, as well as a larger remote steering file, to ensure agents have a basic understanding of nf-core best practices when working in template-based repositories. + +# Champion + +[@itrujnara](https://github.com/itrujnara) + +# Background & Motivation + +AI agents are systems that combine a Large Language Model with multiple deterministic tools to partially or fully automate software development. Apart from the user's prompts, they rely on several types of fixed input (*steering files*), including project instructions and skills. While there are differences in how agents from different vendors discover these files, `AGENTS.md` (https://agents.md/) has become a de facto standard. All popular agents are now set up to read this file before working in a directory. + +nf-core currently has no specific `AGENTS.md` or other agent steering files. This requires extra work from developers to ensure that the agent output complies with nf-core standards, and creates room for divergence in practices. To promote uniformity and reduce the issue of non-compliant AI contributions, it would be prudent to introduce some basic guidance into the template, so that it affects every project automatically after the next update. + +Concerns have been rightly raised about keeping the main steering file up to date, given the limited template release schedule and the dynamic nature of the AI sector. To address that, we propose to introduce a minimal `AGENTS.md`, consisting mostly of references to other, more updateable files. + +Some community members have argued that `CONTRIBUTING.md` is a sufficient file to guide agents as well as human programmers. While this file is valuable, it is not automatically introduced into agent context, and thus should be explicitly included by reference. Furthermore, it is optimized for humans, so agent guidance should extend beyond this file. + +There was previously an RFC on this topic, but it has gone stale months ago. + +# Goals + +- Add a minimal `AGENTS.md` to the template, with references to `CONTRIBUTING.md` and other steering files. +- Add a general `AGENTS_nfcore.md` to a public repository (website or otherwise), referenced by `AGENTS.md`. +- Add a pipeline-specific ~~`AGENTS_[pipeline].md`~~ **section** to the template, ~~initially near-empty, intended for pipeline-specific coding standards and referenced by~~ **within** the main `AGENTS.md`. \[Alteration by IT, introduced following discussion in the original proposal issue\] + +# Non-Goals + +- Overload the template with extensive agent steering (e.g. skills); this should be handled with an extension. +- Create lag and/or undue maintenance burden; all steering files should be updateable with a simple PR. + +# Detailed Design + +## `nf-core/agent-steering` + +To create a dedicated, findable space for agent-related documents in nf-core, a new repository called `nf-core/agent-steering` \[name open to discussion - IT\] is created. Within this RFC, a single file called `AGENTS.md` (see *infra*) will be created in the repository. No other file should be created, unless called for by a future RFC. + +## Template `AGENTS.md` + +A new file called `AGENTS.md` is added to the nf-core pipeline template. This file contains 2 sections: the preamble and the pipeline section. + +### Preamble + +The preamble contains: +- a one-sentence reference to nf-core ("This repository was created with the nf-core pipeline template" or OWTTE), +- the instruction to consult `CONTRIBUTING.md`, +- the instruction to consult the remote steering file (*infra*). + +The preamble does not contain any other information or instructions. + +### Pipeline-specific section + +The pipeline-specific section contains any standards and practices specific to a given pipeline. Developing it and keeping it up to date is the resposibility of the maintainers of the pipeline. This section should not recapitulate any general nf-core standards. + +`nf-core/modules` may utilize this section to explain the specifics of the repository. + +## Remote `AGENTS.md` + +A new file called `AGENTS.md` is created inside `nf-core/agent-steering` (*supra*). This file contains ample guidance for AI agents about the template and nf-core coding practices. The file will be updated as agents evolve, with updates via PR as required. + +This RFC does not specify a rigid structure or contents, but the following elements will tentatively be included (in some order): +- a treemap of the template with explanations of directories and files, +- a description of nf-core tools, list of commands, and examples for the most common operations in pipeline development, +- a description of nf-test and basic testing concepts, +- commit and PR discipline (scopes, message format), +- pre-commit routine (linting, tests, prek), +- self-disclosure rules for fully autonomous agents, +- references to nf-core documentation as required. + +## Pipeline creation workflow + +A new "Include AGENTS.md"/`include_agents_md` flag is added to the pipeline creation workflow. It is on by default, and is switchable in nf-core mode. `AGENTS.md` is only added to the pipeline directory if this flag is set. + +## Pipeline linting tests + +A new linting test is added to `nf-core pipelines lint`. This test verifies that the preamble of `AGENTS.md` exactly matches that in the template. + +## Documentation + +- A paragraph about the `AGENTS.md` option is added to the documentation for `nf-core pipelines create`. +- A blog post about the changes will be published after the drafting and testing stages are concluded. +- Template `AGENTS.md` contains one-line comments for each section + +# Drawbacks + +- **More files in the template.** The pipeline template is heavy as it is. This RFC requires the addition of one extra top-level file, which may cause additional confusion, especially for newer contributors. + +# Alternatives + +- **Status quo: no centralized agent guidance.** This is the easiest solution to implement, but it is and will keep causing divergent development practices. It also increases the influx of low-quality PRs from developers who forget to include any nf-core guidance, often due to the lack of domain knowledge. +- **Delegate all agent guidance to an extension.** While this would prevent any template pollution, it has the significant drawback of requiring an additional manual step from the developer. Thus, it is not a complete solution to the problem of poorly curated AI contributions. A more comprehensive nf-core extension might be created in the future, but is out of scope of this RFC. + +# Adoption Strategy + +## Drafting stage + +- [ ] Creating `nf-core/agent-steering` (core team) +- [ ] Pipeline `AGENTS.md` first draft (anyone) +- [ ] Central `AGENTS.md` first draft (anyone) + +## Testing stage + +- [ ] Manual addition of `AGENTS.md` to: + - [ ] `nf-core/modules` (maintainers) + - [ ] at least 5 pipelines (volunteer pipeline maintainers) +- [ ] Testing by volunteers for at least 1 month (volunteer developers) + +## Implementation stage + +- [ ] Pipeline `AGENTS.md` second draft (anyone) +- [ ] Central `AGENTS.md` second draft (anyone) +- [ ] Addition of `AGENTS.md` to the template (infrastructure team) +- [ ] Addition of relevant options to pipeline creation (infrastructure team) +- [ ] Addition of `AGENTS.md` lint test (infrastructure team) +- [ ] Addition of `AGENTS.md` documentation to the website (anyone) +- [ ] Blog post (anyone) +- [ ] Bytesize explaining the setup (Igor/Phil/Evangelos) + +## Release stage + +- [ ] tools release with the updated template (infrastructure team) +- [ ] Central `AGENTS.md` ready for swift updates (core team) + +## Tentative timeline + +Start of drafting: immediately +End of drafting and start of testing: by June 30, 2026 +End of testing and start of implementation: by July 31, 2026 +Tools release with new features: September-October 2026 + +# Unresolved Questions + +- **Exact content of the central `AGENTS.md`.** This will develop progressively during drafting and testing. + +# References +- Previous RFC: https://github.com/nf-core/proposals/issues/61 +- Slack discussion 1 (#rfc-suggestions): https://nfcore.slack.com/archives/C08TXM0GGMT/p1779271876671859 +- Slack discussion 2 (#team-maintainers): https://nfcore.slack.com/archives/C043UU89KKQ/p1779271926707799 +- General information on AGENTS.md: https://agents.md/ +- Module developer Claude extension: https://github.com/vagkaratzas/nf-core-module-dev From 8b035858dab86b0a245cb47689db52d1b06047ff Mon Sep 17 00:00:00 2001 From: Igor Trujnara <53370556+itrujnara@users.noreply.github.com> Date: Mon, 1 Jun 2026 14:37:45 +0000 Subject: [PATCH 2/9] Add information on README and LICENSE for the new repo to #141 implementation --- proposals/0141-agent-steering.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/proposals/0141-agent-steering.md b/proposals/0141-agent-steering.md index 7a9caff..820159d 100644 --- a/proposals/0141-agent-steering.md +++ b/proposals/0141-agent-steering.md @@ -38,7 +38,7 @@ There was previously an RFC on this topic, but it has gone stale months ago. ## `nf-core/agent-steering` -To create a dedicated, findable space for agent-related documents in nf-core, a new repository called `nf-core/agent-steering` \[name open to discussion - IT\] is created. Within this RFC, a single file called `AGENTS.md` (see *infra*) will be created in the repository. No other file should be created, unless called for by a future RFC. +To create a dedicated, findable space for agent-related documents in nf-core, a new repository called `nf-core/agent-steering` \[name open to discussion - IT\] is created. Within this RFC, a single file called `AGENTS.md` (see *infra*) will be created in the repository, alongside a standard README and LICENSE. No other file should be created, unless called for by a future RFC. ## Template `AGENTS.md` From d31a4b991d91a149ae5cc3fddeb4304891d0b7cd Mon Sep 17 00:00:00 2001 From: Igor Trujnara <53370556+itrujnara@users.noreply.github.com> Date: Mon, 1 Jun 2026 14:48:31 +0000 Subject: [PATCH 3/9] Make prettier happy --- proposals/0141-agent-steering.md | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/proposals/0141-agent-steering.md b/proposals/0141-agent-steering.md index 820159d..8b086df 100644 --- a/proposals/0141-agent-steering.md +++ b/proposals/0141-agent-steering.md @@ -1,7 +1,7 @@ - Start Date: 2026-06-01 - Reference Issues: https://github.com/nf-core/proposals/issues/141 - Implementation PRs: - - None yet + - None yet # Summary @@ -13,7 +13,7 @@ AI agents are an increasingly used tool in software development, and Nextflow pi # Background & Motivation -AI agents are systems that combine a Large Language Model with multiple deterministic tools to partially or fully automate software development. Apart from the user's prompts, they rely on several types of fixed input (*steering files*), including project instructions and skills. While there are differences in how agents from different vendors discover these files, `AGENTS.md` (https://agents.md/) has become a de facto standard. All popular agents are now set up to read this file before working in a directory. +AI agents are systems that combine a Large Language Model with multiple deterministic tools to partially or fully automate software development. Apart from the user's prompts, they rely on several types of fixed input (_steering files_), including project instructions and skills. While there are differences in how agents from different vendors discover these files, `AGENTS.md` (https://agents.md/) has become a de facto standard. All popular agents are now set up to read this file before working in a directory. nf-core currently has no specific `AGENTS.md` or other agent steering files. This requires extra work from developers to ensure that the agent output complies with nf-core standards, and creates room for divergence in practices. To promote uniformity and reduce the issue of non-compliant AI contributions, it would be prudent to introduce some basic guidance into the template, so that it affects every project automatically after the next update. @@ -38,7 +38,7 @@ There was previously an RFC on this topic, but it has gone stale months ago. ## `nf-core/agent-steering` -To create a dedicated, findable space for agent-related documents in nf-core, a new repository called `nf-core/agent-steering` \[name open to discussion - IT\] is created. Within this RFC, a single file called `AGENTS.md` (see *infra*) will be created in the repository, alongside a standard README and LICENSE. No other file should be created, unless called for by a future RFC. +To create a dedicated, findable space for agent-related documents in nf-core, a new repository called `nf-core/agent-steering` \[name open to discussion - IT\] is created. Within this RFC, a single file called `AGENTS.md` (see _infra_) will be created in the repository, alongside a standard README and LICENSE. No other file should be created, unless called for by a future RFC. ## Template `AGENTS.md` @@ -47,9 +47,10 @@ A new file called `AGENTS.md` is added to the nf-core pipeline template. This fi ### Preamble The preamble contains: + - a one-sentence reference to nf-core ("This repository was created with the nf-core pipeline template" or OWTTE), - the instruction to consult `CONTRIBUTING.md`, -- the instruction to consult the remote steering file (*infra*). +- the instruction to consult the remote steering file (_infra_). The preamble does not contain any other information or instructions. @@ -61,9 +62,10 @@ The pipeline-specific section contains any standards and practices specific to a ## Remote `AGENTS.md` -A new file called `AGENTS.md` is created inside `nf-core/agent-steering` (*supra*). This file contains ample guidance for AI agents about the template and nf-core coding practices. The file will be updated as agents evolve, with updates via PR as required. +A new file called `AGENTS.md` is created inside `nf-core/agent-steering` (_supra_). This file contains ample guidance for AI agents about the template and nf-core coding practices. The file will be updated as agents evolve, with updates via PR as required. This RFC does not specify a rigid structure or contents, but the following elements will tentatively be included (in some order): + - a treemap of the template with explanations of directories and files, - a description of nf-core tools, list of commands, and examples for the most common operations in pipeline development, - a description of nf-test and basic testing concepts, @@ -78,7 +80,7 @@ A new "Include AGENTS.md"/`include_agents_md` flag is added to the pipeline crea ## Pipeline linting tests -A new linting test is added to `nf-core pipelines lint`. This test verifies that the preamble of `AGENTS.md` exactly matches that in the template. +A new linting test is added to `nf-core pipelines lint`. This test verifies that the preamble of `AGENTS.md` exactly matches that in the template. ## Documentation @@ -93,7 +95,7 @@ A new linting test is added to `nf-core pipelines lint`. This test verifies that # Alternatives - **Status quo: no centralized agent guidance.** This is the easiest solution to implement, but it is and will keep causing divergent development practices. It also increases the influx of low-quality PRs from developers who forget to include any nf-core guidance, often due to the lack of domain knowledge. -- **Delegate all agent guidance to an extension.** While this would prevent any template pollution, it has the significant drawback of requiring an additional manual step from the developer. Thus, it is not a complete solution to the problem of poorly curated AI contributions. A more comprehensive nf-core extension might be created in the future, but is out of scope of this RFC. +- **Delegate all agent guidance to an extension.** While this would prevent any template pollution, it has the significant drawback of requiring an additional manual step from the developer. Thus, it is not a complete solution to the problem of poorly curated AI contributions. A more comprehensive nf-core extension might be created in the future, but is out of scope of this RFC. # Adoption Strategy @@ -106,14 +108,14 @@ A new linting test is added to `nf-core pipelines lint`. This test verifies that ## Testing stage - [ ] Manual addition of `AGENTS.md` to: - - [ ] `nf-core/modules` (maintainers) - - [ ] at least 5 pipelines (volunteer pipeline maintainers) + - [ ] `nf-core/modules` (maintainers) + - [ ] at least 5 pipelines (volunteer pipeline maintainers) - [ ] Testing by volunteers for at least 1 month (volunteer developers) ## Implementation stage - [ ] Pipeline `AGENTS.md` second draft (anyone) -- [ ] Central `AGENTS.md` second draft (anyone) +- [ ] Central `AGENTS.md` second draft (anyone) - [ ] Addition of `AGENTS.md` to the template (infrastructure team) - [ ] Addition of relevant options to pipeline creation (infrastructure team) - [ ] Addition of `AGENTS.md` lint test (infrastructure team) @@ -138,6 +140,7 @@ Tools release with new features: September-October 2026 - **Exact content of the central `AGENTS.md`.** This will develop progressively during drafting and testing. # References + - Previous RFC: https://github.com/nf-core/proposals/issues/61 - Slack discussion 1 (#rfc-suggestions): https://nfcore.slack.com/archives/C08TXM0GGMT/p1779271876671859 - Slack discussion 2 (#team-maintainers): https://nfcore.slack.com/archives/C043UU89KKQ/p1779271926707799 From c503e77ad176e1e6537c4c1fa7ec66f87e25dcba Mon Sep 17 00:00:00 2001 From: Igor Trujnara <53370556+itrujnara@users.noreply.github.com> Date: Tue, 2 Jun 2026 10:19:22 +0200 Subject: [PATCH 4/9] Apply suggestions from code review Co-authored-by: Phil Ewels --- proposals/0141-agent-steering.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/proposals/0141-agent-steering.md b/proposals/0141-agent-steering.md index 8b086df..357995f 100644 --- a/proposals/0141-agent-steering.md +++ b/proposals/0141-agent-steering.md @@ -27,7 +27,7 @@ There was previously an RFC on this topic, but it has gone stale months ago. - Add a minimal `AGENTS.md` to the template, with references to `CONTRIBUTING.md` and other steering files. - Add a general `AGENTS_nfcore.md` to a public repository (website or otherwise), referenced by `AGENTS.md`. -- Add a pipeline-specific ~~`AGENTS_[pipeline].md`~~ **section** to the template, ~~initially near-empty, intended for pipeline-specific coding standards and referenced by~~ **within** the main `AGENTS.md`. \[Alteration by IT, introduced following discussion in the original proposal issue\] +- Add a pipeline-specific section to the template, within the main `AGENTS.md`. The section will initially be nearly-empty, intended for developers to add pipeline-specific coding standards. # Non-Goals @@ -38,7 +38,7 @@ There was previously an RFC on this topic, but it has gone stale months ago. ## `nf-core/agent-steering` -To create a dedicated, findable space for agent-related documents in nf-core, a new repository called `nf-core/agent-steering` \[name open to discussion - IT\] is created. Within this RFC, a single file called `AGENTS.md` (see _infra_) will be created in the repository, alongside a standard README and LICENSE. No other file should be created, unless called for by a future RFC. +To create a dedicated, findable space for agent-related documents in nf-core, a new repository called `nf-core/agent-steering` is created. Within this RFC, a single file called `AGENTS.md` (see _infra_) will be created in the root of the repository. ## Template `AGENTS.md` @@ -62,7 +62,7 @@ The pipeline-specific section contains any standards and practices specific to a ## Remote `AGENTS.md` -A new file called `AGENTS.md` is created inside `nf-core/agent-steering` (_supra_). This file contains ample guidance for AI agents about the template and nf-core coding practices. The file will be updated as agents evolve, with updates via PR as required. +A new file called `AGENTS.md` is created inside `nf-core/agent-steering` (_supra_). This file contains guidance for AI agents about the template and nf-core coding practices. The file will be updated as agents evolve, with updates via PR as required. This RFC does not specify a rigid structure or contents, but the following elements will tentatively be included (in some order): @@ -95,7 +95,7 @@ A new linting test is added to `nf-core pipelines lint`. This test verifies that # Alternatives - **Status quo: no centralized agent guidance.** This is the easiest solution to implement, but it is and will keep causing divergent development practices. It also increases the influx of low-quality PRs from developers who forget to include any nf-core guidance, often due to the lack of domain knowledge. -- **Delegate all agent guidance to an extension.** While this would prevent any template pollution, it has the significant drawback of requiring an additional manual step from the developer. Thus, it is not a complete solution to the problem of poorly curated AI contributions. A more comprehensive nf-core extension might be created in the future, but is out of scope of this RFC. +- **Delegate all agent guidance to an extension / plugin.** While this would prevent any template pollution, it has the significant drawback of requiring the developer to install the plugin ahead of time. Thus, it is not a complete solution to the problem of poorly curated AI contributions. A more comprehensive nf-core extension might be created in the future, but is out of scope of this RFC. # Adoption Strategy @@ -130,10 +130,10 @@ A new linting test is added to `nf-core pipelines lint`. This test verifies that ## Tentative timeline -Start of drafting: immediately -End of drafting and start of testing: by June 30, 2026 -End of testing and start of implementation: by July 31, 2026 -Tools release with new features: September-October 2026 +- Start of drafting: immediately +- End of drafting and start of testing: by June 30, 2026 +- End of testing and start of implementation: by July 31, 2026 +- Tools release with new features: September-October 2026 # Unresolved Questions From eee96562b0e4e36a6267e1fb2e1cb26519b1dadd Mon Sep 17 00:00:00 2001 From: Igor Trujnara <53370556+itrujnara@users.noreply.github.com> Date: Tue, 2 Jun 2026 08:39:16 +0000 Subject: [PATCH 5/9] Apply more suggestions from code review --- proposals/0141-agent-steering.md | 36 ++++++++++++++++++-------------- 1 file changed, 20 insertions(+), 16 deletions(-) diff --git a/proposals/0141-agent-steering.md b/proposals/0141-agent-steering.md index 357995f..9e7548d 100644 --- a/proposals/0141-agent-steering.md +++ b/proposals/0141-agent-steering.md @@ -36,9 +36,21 @@ There was previously an RFC on this topic, but it has gone stale months ago. # Detailed Design -## `nf-core/agent-steering` +## `nf-core/agents` and remote `AGENTS.md` -To create a dedicated, findable space for agent-related documents in nf-core, a new repository called `nf-core/agent-steering` is created. Within this RFC, a single file called `AGENTS.md` (see _infra_) will be created in the root of the repository. +To create a dedicated, findable space for agent-related documents in nf-core, a new repository called `nf-core/agents` is created. Within this RFC, a single file called `AGENTS.md` is created in the root of the repository. + +`AGENTS.md` contains guidance for AI agents about the template and nf-core coding practices. The file will be updated as agents evolve, with updates via PR as required. + +This RFC does not specify a rigid structure or contents, but the following elements will tentatively be included (in some order): + +- a treemap of the template with explanations of directories and files, +- a description of nf-core tools, list of commands, and examples for the most common operations in pipeline development, +- a description of nf-test and basic testing concepts, +- commit and PR discipline (scopes, message format), +- pre-commit routine (nextflow lint, nf-core lint, tests, prek), +- self-disclosure rules for fully autonomous agents, +- references to nf-core documentation as required. ## Template `AGENTS.md` @@ -50,7 +62,7 @@ The preamble contains: - a one-sentence reference to nf-core ("This repository was created with the nf-core pipeline template" or OWTTE), - the instruction to consult `CONTRIBUTING.md`, -- the instruction to consult the remote steering file (_infra_). +- the instruction to consult the remote steering file (_supra_). The preamble does not contain any other information or instructions. @@ -58,21 +70,13 @@ The preamble does not contain any other information or instructions. The pipeline-specific section contains any standards and practices specific to a given pipeline. Developing it and keeping it up to date is the resposibility of the maintainers of the pipeline. This section should not recapitulate any general nf-core standards. -`nf-core/modules` may utilize this section to explain the specifics of the repository. - -## Remote `AGENTS.md` +## `AGENTS.md` in non-template repositories -A new file called `AGENTS.md` is created inside `nf-core/agent-steering` (_supra_). This file contains guidance for AI agents about the template and nf-core coding practices. The file will be updated as agents evolve, with updates via PR as required. +nf-core repositories not synced with the template may have separate `AGENTS.md` files. These files do not need to follow the structure of the template `AGENTS.md`. -This RFC does not specify a rigid structure or contents, but the following elements will tentatively be included (in some order): +Within this RFC, `AGENTS.md` is added to `nf-core/modules`. The file contains a preamble similar to that from the template, and a modules-specific section. -- a treemap of the template with explanations of directories and files, -- a description of nf-core tools, list of commands, and examples for the most common operations in pipeline development, -- a description of nf-test and basic testing concepts, -- commit and PR discipline (scopes, message format), -- pre-commit routine (linting, tests, prek), -- self-disclosure rules for fully autonomous agents, -- references to nf-core documentation as required. +Given their special nature, this RFC does not decide on the inclusion and/or content of `AGENTS.md` in other non-template repositories. ## Pipeline creation workflow @@ -101,7 +105,7 @@ A new linting test is added to `nf-core pipelines lint`. This test verifies that ## Drafting stage -- [ ] Creating `nf-core/agent-steering` (core team) +- [ ] Creating `nf-core/agents` (core team) - [ ] Pipeline `AGENTS.md` first draft (anyone) - [ ] Central `AGENTS.md` first draft (anyone) From 258072abfce2f8cc6702504c156f552ad850358c Mon Sep 17 00:00:00 2001 From: Igor Trujnara <53370556+itrujnara@users.noreply.github.com> Date: Wed, 3 Jun 2026 07:09:25 +0000 Subject: [PATCH 6/9] Apply suggestions from Jose --- proposals/0141-agent-steering.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/proposals/0141-agent-steering.md b/proposals/0141-agent-steering.md index 9e7548d..7a7a591 100644 --- a/proposals/0141-agent-steering.md +++ b/proposals/0141-agent-steering.md @@ -21,7 +21,7 @@ Concerns have been rightly raised about keeping the main steering file up to dat Some community members have argued that `CONTRIBUTING.md` is a sufficient file to guide agents as well as human programmers. While this file is valuable, it is not automatically introduced into agent context, and thus should be explicitly included by reference. Furthermore, it is optimized for humans, so agent guidance should extend beyond this file. -There was previously an RFC on this topic, but it has gone stale months ago. +There was previously [an RFC](https://github.com/nf-core/proposals/issues/61) on this topic, but it has gone stale months ago and thus was closed (as not planned). # Goals @@ -46,7 +46,11 @@ This RFC does not specify a rigid structure or contents, but the following eleme - a treemap of the template with explanations of directories and files, - a description of nf-core tools, list of commands, and examples for the most common operations in pipeline development, +- nf-core workflows, subworkflows, and modules, +- roles of different config files, +- meta map conventions, - a description of nf-test and basic testing concepts, +- common Nextflow pitfalls (possibly by reference), - commit and PR discipline (scopes, message format), - pre-commit routine (nextflow lint, nf-core lint, tests, prek), - self-disclosure rules for fully autonomous agents, From 1c5f72c62e32608c6efad80e7e3c3d74ae5df8dc Mon Sep 17 00:00:00 2001 From: Igor Trujnara <53370556+itrujnara@users.noreply.github.com> Date: Tue, 9 Jun 2026 17:04:16 +0200 Subject: [PATCH 7/9] Add tools PR --- proposals/0141-agent-steering.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/proposals/0141-agent-steering.md b/proposals/0141-agent-steering.md index 7a7a591..81eb00a 100644 --- a/proposals/0141-agent-steering.md +++ b/proposals/0141-agent-steering.md @@ -1,7 +1,7 @@ - Start Date: 2026-06-01 - Reference Issues: https://github.com/nf-core/proposals/issues/141 - Implementation PRs: - - None yet + - https://github.com/nf-core/tools/pull/4318 # Summary @@ -110,7 +110,7 @@ A new linting test is added to `nf-core pipelines lint`. This test verifies that ## Drafting stage - [ ] Creating `nf-core/agents` (core team) -- [ ] Pipeline `AGENTS.md` first draft (anyone) +- [x] Pipeline `AGENTS.md` first draft (anyone) - [ ] Central `AGENTS.md` first draft (anyone) ## Testing stage From fe7e1100a406d1525614ad4e93ca4852b8864fab Mon Sep 17 00:00:00 2001 From: Igor Trujnara <53370556+itrujnara@users.noreply.github.com> Date: Wed, 17 Jun 2026 09:53:25 +0200 Subject: [PATCH 8/9] Update agent steering proposal with new PR link Add reference to new implementation PR for agents. --- proposals/0141-agent-steering.md | 1 + 1 file changed, 1 insertion(+) diff --git a/proposals/0141-agent-steering.md b/proposals/0141-agent-steering.md index 81eb00a..99e8cca 100644 --- a/proposals/0141-agent-steering.md +++ b/proposals/0141-agent-steering.md @@ -2,6 +2,7 @@ - Reference Issues: https://github.com/nf-core/proposals/issues/141 - Implementation PRs: - https://github.com/nf-core/tools/pull/4318 + - https://github.com/nf-core/agents/pull/2 # Summary From 60190cf30dece28e7e8425ca2c04f483340c19ae Mon Sep 17 00:00:00 2001 From: Igor Trujnara <53370556+itrujnara@users.noreply.github.com> Date: Wed, 17 Jun 2026 16:21:57 +0200 Subject: [PATCH 9/9] Add information on modules PR --- proposals/0141-agent-steering.md | 1 + 1 file changed, 1 insertion(+) diff --git a/proposals/0141-agent-steering.md b/proposals/0141-agent-steering.md index 99e8cca..9a32607 100644 --- a/proposals/0141-agent-steering.md +++ b/proposals/0141-agent-steering.md @@ -3,6 +3,7 @@ - Implementation PRs: - https://github.com/nf-core/tools/pull/4318 - https://github.com/nf-core/agents/pull/2 + - https://github.com/nf-core/modules/pull/12028 # Summary