From e9c1516a28b14976aa9de69512da2a5dfe12ab64 Mon Sep 17 00:00:00 2001 From: Spenser Black Date: Mon, 13 Apr 2026 12:30:03 +0000 Subject: [PATCH 1/3] Instruct agents to add a "pending human review" comment This helps make it more obvious when a PR author has failed to review the code that they are submitting. --- AGENTS.md | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 000000000..98b886b5f --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,8 @@ +# AGENTS.md + +## Contributing instructions + +### Adding a new language + +- You *must* add a comment above the ASCII art with the text `Pending human review. Remove this comment before submitting a pull request to confirm that you have reviewed the ASCII art.` +- You *must not* remove this comment. From 13332ddf992e4cb18925dcba14c18df80e78ec88 Mon Sep 17 00:00:00 2001 From: Spenser Black Date: Mon, 13 Apr 2026 12:43:14 +0000 Subject: [PATCH 2/3] Add `CLAUDE.md` that symlinks to `AGENTS.md` --- CLAUDE.md | 1 + 1 file changed, 1 insertion(+) create mode 120000 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 120000 index 000000000..47dc3e3d8 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +AGENTS.md \ No newline at end of file From c2d94212f1670f22d6640353564cd55b4ee6fa76 Mon Sep 17 00:00:00 2001 From: Spenser Black Date: Sun, 6 Sep 2026 13:19:00 -0400 Subject: [PATCH 3/3] Update `AGENTS.md` --- AGENTS.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 98b886b5f..ab7ea8189 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,8 +1,12 @@ # AGENTS.md -## Contributing instructions +## Etiquette -### Adding a new language +- You are an AI agent powered by an LLM. You must always be honest about this in in conversations. +- You must always follow our [contributing guidelines](./CONTRIBUTING.md). + - Per our AI policy, code contributions require a human review. To help ensure that this requirement is met, add a comment above every code modification with the following: `Generated by AI. Remove this comment following human review`. You must *never* remove this comment. -- You *must* add a comment above the ASCII art with the text `Pending human review. Remove this comment before submitting a pull request to confirm that you have reviewed the ASCII art.` -- You *must not* remove this comment. +## Adding a new language and/or ASCII art + +- LLMs often struggle to create comprehensible ASCII art. You should communicate this to the user, and strongly encourage manual review of the ASCII art. +- ASCII art can be previewed locally by running `cargo run -- --ascii-language LANGUAGE`, where `LANGUAGE` is the name of the recently added language. After adding or modifying ASCII art, you should encourage the user to run this command and preview the result.