From bb217fe40460c8d37ea6657537624a88e2197686 Mon Sep 17 00:00:00 2001
From: bool <bolaji.olajide@sourcegraph.com>
Date: Wed, 2 Sep 2026 17:17:07 +0000
Subject: [PATCH] Add AGENTS.md

---
 AGENTS.md | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..59ea006
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,53 @@
+# AGENTS.md
+
+Guidance for coding agents working in this repository.
+
+## Project overview
+
+This is a test fixture repository, not a real project. Its README states that it
+exists to exercise Sourcegraph batch changes. It contains only Markdown files
+plus a placeholder CI workflow — there is no application code.
+
+Some files exist specifically to test text-handling edge cases: `TRAILING.md`
+and `NONTRAILING.md` differ in whether the file ends with a trailing newline.
+
+## Repository layout
+
+Flat, single level — there are no source directories.
+
+| Path | Purpose |
+| --- | --- |
+| `README.md` | Placeholder; states the repo is for testing batch changes |
+| `CONTRIBUTING.md` | Heading only, no content |
+| `CHANGELOG.md` | Single trivial entry |
+| `ANOTHER.md`, `RANDOM.md`, `TESTING.md`, `TESTINGGG.md` | Placeholder Markdown |
+| `TRAILING.md`, `NONTRAILING.md` | Fixtures for trailing-newline behavior |
+| `.github/workflows/blank.yml` | Unmodified GitHub Actions starter template |
+| `.gitignore` | Ignores `.DS_Store` and `.env` |
+
+## Setup, build, test, lint
+
+There is nothing to set up, build, test, or lint. The repository has no package
+manager manifest, no Makefile, and no linter configuration. Do not add build
+tooling unless a task explicitly asks for it.
+
+`.github/workflows/blank.yml` is the default GitHub Actions starter workflow; it
+echoes a greeting and validates nothing. A green CI run here does not mean a
+change is correct.
+
+## Conventions
+
+- Content is plain Markdown. No style guide or linter is enforced.
+- No formatter runs over this repository, so avoid reflowing or reformatting
+  files you were not asked to change.
+
+## Gotchas
+
+- Preserve each file's existing trailing-newline state. `TRAILING.md` and
+  `NONTRAILING.md` are fixtures for exactly this; normalizing them defeats their
+  purpose.
+- Scope edits narrowly. Because the files are near-identical placeholder text, a
+  broad find-and-replace can easily touch fixtures a task did not intend to
+  modify.
+- Treat this repository as disposable test data. Do not rely on anything here as
+  an example of production conventions.