| author | Alan Dipert
<alan@tailrecursion.com> 2025-12-29 17:21:14 UTC |
| committer | Alan Dipert
<alan@tailrecursion.com> 2025-12-29 17:21:14 UTC |
| parent | ce7c549273d5764fba36b72a309cf152fa057bc7 |
| 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