Instructions for agents

AGENTS.md

@@ -0,0 +1,7 @@
+Please read the [Developers Guide](documentation/DEVELOPMENT.md) and other files
+in [documentation/](documentation/).
+
+When you are done, please execute these tasks in the root folder:
+
+- `make build` to type-check the codebase
+- `make test` to execute all tests

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

documentation/DEVELOPMENT.md

@@ -1,6 +1,6 @@
 # Developers Guide
 
-This guide is for all codebases in this mono-repo.
+This monorepo contains the code for Text-Runner and its standard library.
 
 ## Setup after cloning
 
@@ -15,6 +15,15 @@ To get the codebase into a runnable state after cloning:
 
 - <code type="make/command" dir="..">make setup</code> to install dependencies
 
+## Folders
+
+- text-runner-engine: implements the Text-Runner functionality as a library
+- text-runner-cli: a CLI wrapper around the Text-Runner engine, to call
+  Text-Runner in a shell
+- text-runner-features: end-to-end tests for Text-Runner
+
+The other folders are Text-Runner plugins or utility folders.
+
 ## Running tools
 
 All codebases in this mono-repo provide a standardized set of commands for