git » homepage.git » commit 0827200

Document backlinks requirement and AI wording guidance

author Alan Dipert
2025-12-29 17:21:14 UTC
committer Alan Dipert
2025-12-29 17:21:14 UTC
parent ce7c549273d5764fba36b72a309cf152fa057bc7

Document backlinks requirement and AI wording guidance

AGENTS.md +2 -0

diff --git a/AGENTS.md b/AGENTS.md
index f8ce466..83d0b1b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -18,6 +18,7 @@ Welcome! This document describes how automated helpers should operate when worki
 - Keep the generated `out/Index.html` in sync; the `tools/gen_index.sh` helper runs automatically from `make`.
 - Keep updates idempotent: don’t delete generated output or vendor directories unless instructed.
 - When in doubt about improvements, have the AI tour the site like a new reader (browser pass, no edits) and capture TODOs for confusing spots or visual glitches before proposing changes.
+- Backlinks: every page renders a “Backlinks” block built from the cmark AST; keep it working whenever you touch build tooling.
 
 ## Blog Post Style Guidelines
 
@@ -31,6 +32,7 @@ When drafting or editing Markdown articles under `md/`:
 - Avoid HTML unless necessary for layout—stick to Markdown headings, lists, and links.
 - Signatures are not required; rely on the build footer for publication metadata.
 - Skip em-dash pivots like “This isn’t X—it’s Y.” Write the contrast plainly instead.
+- Prefer generic “AI coding agent” phrasing over specific product names when writing about AI unless a brand is central to the point.
 
 ## Communication Notes