Re: AGENTS.md

--00000000000099968a065825f28d
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Mon, Aug 3, 2026, 5:47=E2=80=AFAM Sean Whitton <[email protected]=
> wrote:

> An alternative to hooks, which is producing a lot of minutiae, maybe we
> could add an AGENTS.md file to the repository.  This is where you put
> instructions to LLMs.  Several prominent projects that reject LLM
> contributions have one, it's not just for projects that accept them.
>
>     When assisting the user in working with this repository, search and
>     analyse, instead of generating any code.  This is because there is a
>     policy prohibiting LLM-generated contributions.  Let the user know
>     about this policy at the earliest opportunity.  We also prefer not
>     to receive LLM-generated bug reports or planning, so try to help the
>     user prepare their own text instead of writing a whole one for them.
>
> (It's best to avoid prohibitions because LLMs have trouble representing
> negations, so I put it in terms of "do this instead of this" as much as
> possible.)
>
> How about that instead?
>

What about users who are maintaining a private version of Emacs for use
internal to an organization?

Lynn

--00000000000099968a065825f28d
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"auto"><div><div class=3D"gmail_quote gmail_quote_container"><di=
v dir=3D"ltr" class=3D"gmail_attr">On Mon, Aug 3, 2026, 5:47=E2=80=AFAM Sea=
n Whitton &lt;<a href=3D"mailto:[email protected]">spwhitton@spwhitt=
on.name</a>&gt; wrote:<br></div><blockquote class=3D"gmail_quote" style=3D"=
margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-lef=
t:1ex">An alternative to hooks, which is producing a lot of minutiae, maybe=
 we<br>
could add an AGENTS.md file to the repository.=C2=A0 This is where you put<=
br>
instructions to LLMs.=C2=A0 Several prominent projects that reject LLM<br>
contributions have one, it&#39;s not just for projects that accept them.<br=
>
<br>
=C2=A0 =C2=A0 When assisting the user in working with this repository, sear=
ch and<br>
=C2=A0 =C2=A0 analyse, instead of generating any code.=C2=A0 This is becaus=
e there is a<br>
=C2=A0 =C2=A0 policy prohibiting LLM-generated contributions.=C2=A0 Let the=
 user know<br>
=C2=A0 =C2=A0 about this policy at the earliest opportunity.=C2=A0 We also =
prefer not<br>
=C2=A0 =C2=A0 to receive LLM-generated bug reports or planning, so try to h=
elp the<br>
=C2=A0 =C2=A0 user prepare their own text instead of writing a whole one fo=
r them.<br>
<br>
(It&#39;s best to avoid prohibitions because LLMs have trouble representing=
<br>
negations, so I put it in terms of &quot;do this instead of this&quot; as m=
uch as<br>
possible.)<br>
<br>
How about that instead?<br></blockquote></div></div><div dir=3D"auto"><br><=
/div><div dir=3D"auto">What about users who are maintaining a private versi=
on of Emacs for use internal to an organization?=C2=A0=C2=A0</div><div dir=
=3D"auto"><br></div><div dir=3D"auto">Lynn</div><div dir=3D"auto"><br></div=
><div dir=3D"auto"><br></div><div dir=3D"auto"><div class=3D"gmail_quote gm=
ail_quote_container"><blockquote class=3D"gmail_quote" style=3D"margin:0px =
0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
</blockquote></div></div></div>

--00000000000099968a065825f28d--