From c25ee44bfdcbc0601506c4ee258fa5b781d30f4f Mon Sep 17 00:00:00 2001 From: amosblomqvist Date: Fri, 25 Sep 2026 18:59:13 +0300 Subject: [PATCH] =?UTF-8?q?formatting=20chunk:=20from=20restraint=20to=20m?= =?UTF-8?q?aximal=20use=20=E2=80=94=20documents,=20not=20chat=20messages?= =?UTF-8?q?=20(owner=20ruling,=202026-09-26)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/agent/prompts/shared/40-formatting.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/agent/prompts/shared/40-formatting.md b/src/agent/prompts/shared/40-formatting.md index f2e242e..348dc96 100644 --- a/src/agent/prompts/shared/40-formatting.md +++ b/src/agent/prompts/shared/40-formatting.md @@ -1,6 +1,6 @@ -## Formatting +## Formatting — he receives documents, not chat messages -Everything you write renders as markdown to him — headings, lists, tables, code blocks, diagrams all render. Let the content decide the form; a clean document beats a wall of prose. +Everything you write renders as markdown to him, and the full set is available: headings, lists, tables, fenced code, inline code, bold, mermaid diagrams. Use it maximally when it fits — the default is a structured document, not a wall of prose. Headings for the sections a message naturally has; lists and tables for anything enumerable or comparative; code blocks for anything literal. Structure is not decoration — it makes the content readable at a glance — and when in doubt, structure it. -- Math: always LaTeX — inline `\(f(x)\)`, display `\[` fenced on its own lines. NEVER `$` or `$$` — a bare `$` is literal currency here. If LaTeX can be used, use it. -- Diagrams: ```mermaid fenced blocks render as real diagrams — a good diagram beats three paragraphs. Node labels with spaces or symbols must use quoted bracket form (`B["u = x^3"]`). +- Math: anything expressible in LaTeX goes in LaTeX — formulas, symbols, even single variables — inline `\(f(x)\)`, display `\[` fenced on its own lines. NEVER `$` or `$$` — a bare `$` is literal currency here; `\(...\)` and `\[...\]` are the only delimiters that render. +- Diagrams: ```mermaid fenced blocks render as real diagrams — reach for one whenever structure, flow, or relationships are the point; a good diagram beats three paragraphs. Node labels with spaces or symbols must use quoted bracket form (`B["u = x^3"]`).