Your message dated Sat, 5 Sep 2026 01:30:16 +0530
with message-id <[email protected]>
and subject line Re: Bug#1143541: lintian: add new tag
'agent-instructions-exists'
has caused the Debian Bug report #1143541,
regarding lintian: add new tag 'agent-instructions-exists'
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)
--
1143541: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1143541
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: lintian
Version: 2.138.0
Tags: patch
Hi,
The attached patch adds a new classification tag
'agent-instructions-exists' that is issued when the upstream sources
ship an instructions file consumed by an AI coding agent. The following
files are detected: AGENTS.md, CLAUDE.md, GEMINI.md, .cursorrules,
.windsurfrules, .github/copilot-instructions.md, and files under
.cursor/rules/.
I plan to use it in trends.debian.net, to track AI adoption among
Debian's upstreams.
Best,
Lucas
commit 33a03d05ced0178b06d01cee6f9e9621227d4f4f
Author: Lucas Nussbaum <[email protected]>
Date: Mon Aug 3 18:49:51 2026 +0000
new tag 'agent-instructions-exists'
Add a new classification tag 'agent-instructions-exists' that is issued
when the upstream sources ship an instructions file consumed by an AI
coding agent. The following files are detected:
AGENTS.md, CLAUDE.md, GEMINI.md, .cursorrules, .windsurfrules,
.github/copilot-instructions.md, and files under .cursor/rules/.
A new check 'upstream/agent-instructions' is added, which walks the
patched source files and emits one hint per match. The naming follows
the existing 'upstream-metadata-exists' convention.
A test recipe is added that places AGENTS.md, .cursorrules and a file
under .cursor/rules/ in the upstream source and verifies the expected
hints.
Assisted-By: AI (OpenCode+LLM 5.2)
diff --git a/lib/Lintian/Check/Upstream/AgentInstructions.pm b/lib/Lintian/Check/Upstream/AgentInstructions.pm
new file mode 100644
index 000000000..44c522810
--- /dev/null
+++ b/lib/Lintian/Check/Upstream/AgentInstructions.pm
@@ -0,0 +1,71 @@
+# upstream/agent-instructions -- lintian check script -*- perl -*-
+
+# Copyright (C) 2026 Lucas Nussbaum <[email protected]>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, you can find it on the World Wide
+# Web at https://www.gnu.org/copyleft/gpl.html, or write to the Free
+# Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
+# MA 02110-1301, USA.
+
+package Lintian::Check::Upstream::AgentInstructions;
+
+use v5.20;
+use warnings;
+use utf8;
+
+use List::SomeUtils qw(any);
+
+use Moo;
+use namespace::clean;
+
+with 'Lintian::Check';
+
+# Files consumed by AI coding agents and shipped by upstream.
+# Matched against the file name (relative to the patched source tree root).
+my @KNOWN_FILES = qw(
+ AGENTS.md
+ CLAUDE.md
+ GEMINI.md
+ .cursorrules
+ .windsurfrules
+ .github/copilot-instructions.md
+);
+
+# Glob match for files under .cursor/rules/.
+my $CURSOR_RULES_RE = qr{^\.cursor/rules/[^/]+\.mdc$};
+
+sub visit_patched_files {
+ my ($self, $item) = @_;
+
+ return
+ unless $item->is_file;
+
+ my $matched = any { $item->name eq $_ } @KNOWN_FILES;
+ $matched ||= $item->name =~ $CURSOR_RULES_RE;
+
+ return
+ unless $matched;
+
+ $self->pointed_hint('agent-instructions-exists', $item->pointer);
+
+ return;
+}
+
+1;
+
+# Local Variables:
+# indent-tabs-mode: nil
+# cperl-indent-level: 4
+# End:
+# vim: syntax=perl sw=4 sts=4 sr et
diff --git a/t/recipes/checks/upstream/agent-instructions/agent-instructions/build-spec/fill-values b/t/recipes/checks/upstream/agent-instructions/agent-instructions/build-spec/fill-values
new file mode 100644
index 000000000..085058c2f
--- /dev/null
+++ b/t/recipes/checks/upstream/agent-instructions/agent-instructions/build-spec/fill-values
@@ -0,0 +1,3 @@
+Skeleton: source-native
+Testname: agent-instructions
+Description: Upstream sources provide AI coding-agent instructions files.
diff --git a/t/recipes/checks/upstream/agent-instructions/agent-instructions/build-spec/orig/.cursor/rules/copilot.mdc b/t/recipes/checks/upstream/agent-instructions/agent-instructions/build-spec/orig/.cursor/rules/copilot.mdc
new file mode 100644
index 000000000..9b91ea1a8
--- /dev/null
+++ b/t/recipes/checks/upstream/agent-instructions/agent-instructions/build-spec/orig/.cursor/rules/copilot.mdc
@@ -0,0 +1 @@
+# Cursor managed rules
diff --git a/t/recipes/checks/upstream/agent-instructions/agent-instructions/build-spec/orig/.cursorrules b/t/recipes/checks/upstream/agent-instructions/agent-instructions/build-spec/orig/.cursorrules
new file mode 100644
index 000000000..dc5b04160
--- /dev/null
+++ b/t/recipes/checks/upstream/agent-instructions/agent-instructions/build-spec/orig/.cursorrules
@@ -0,0 +1 @@
+# Cursor rules
diff --git a/t/recipes/checks/upstream/agent-instructions/agent-instructions/build-spec/orig/AGENTS.md b/t/recipes/checks/upstream/agent-instructions/agent-instructions/build-spec/orig/AGENTS.md
new file mode 100644
index 000000000..7d2dfc7c9
--- /dev/null
+++ b/t/recipes/checks/upstream/agent-instructions/agent-instructions/build-spec/orig/AGENTS.md
@@ -0,0 +1 @@
+# Upstream agent instructions
diff --git a/t/recipes/checks/upstream/agent-instructions/agent-instructions/eval/desc b/t/recipes/checks/upstream/agent-instructions/agent-instructions/eval/desc
new file mode 100644
index 000000000..1edebc739
--- /dev/null
+++ b/t/recipes/checks/upstream/agent-instructions/agent-instructions/eval/desc
@@ -0,0 +1,2 @@
+Testname: agent-instructions
+Check: upstream/agent-instructions
diff --git a/t/recipes/checks/upstream/agent-instructions/agent-instructions/eval/hints b/t/recipes/checks/upstream/agent-instructions/agent-instructions/eval/hints
new file mode 100644
index 000000000..6b8a29594
--- /dev/null
+++ b/t/recipes/checks/upstream/agent-instructions/agent-instructions/eval/hints
@@ -0,0 +1,3 @@
+agent-instructions (source): upstream/agent-instructions/agent-instructions-exists [.cursor/rules/copilot.mdc]
+agent-instructions (source): upstream/agent-instructions/agent-instructions-exists [.cursorrules]
+agent-instructions (source): upstream/agent-instructions/agent-instructions-exists [AGENTS.md]
diff --git a/tags/upstream/agent-instructions/agent-instructions-exists.tag b/tags/upstream/agent-instructions/agent-instructions-exists.tag
new file mode 100644
index 000000000..ab25bcc10
--- /dev/null
+++ b/tags/upstream/agent-instructions/agent-instructions-exists.tag
@@ -0,0 +1,9 @@
+Tag: agent-instructions-exists
+Severity: classification
+Check: upstream/agent-instructions
+Name-Spaced: yes
+Explanation: The upstream sources ship an instructions file consumed by an
+ AI coding agent, such as <code>AGENTS.md</code>, <code>CLAUDE.md</code>,
+ <code>GEMINI.md</code>, <code>.cursorrules</code>,
+ <code>.windsurfrules</code>, <code>.github/copilot-instructions.md</code>,
+ or a file under <code>.cursor/rules/</code>.
--- End Message ---
--- Begin Message ---
Version: 2.140.0
Your MR was accepted and released in this lintian version, but missing the
`Closes` in d/ch.
Hence closing manually.
Thanks for the report and the patch.
--- End Message ---
