diff --git a/AGENTS.md b/AGENTS.md
index 7986d99..294e3a1 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -7,12 +7,12 @@ repository.
 
 `jwks-client` is an async client that fetches and caches an identity provider's JSON Web Key Set and
 verifies JWTs against it; [`CONTEXT.md`](CONTEXT.md) opens with what it does and owns the
-vocabulary — read it before naming a concept in code, a test name, or an issue title.
+vocabulary. Read it before naming a concept in code, a test name, or an issue title.
 
 ## Commands
 
-`just` (task runner) and `uv` (package manager). The [`justfile`](justfile) is the source of truth —
-`just --list`, or read it.
+`just` (task runner) and `uv` (package manager). The [`justfile`](justfile) is the source of truth:
+run `just --list`, or read it.
 
 ## Architecture
 
diff --git a/README.md b/README.md
index 946f08d..8d2b9f8 100644
--- a/README.md
+++ b/README.md
@@ -199,4 +199,4 @@ signature, for local development only.
 ## Part of `modern-python`
 
 Browse the full list of templates and libraries in
-[`modern-python`](https://github.com/modern-python) — see the org profile for the categorized index.
+[`modern-python`](https://github.com/modern-python); see the org profile for the categorized index.