AGENTS.md@snippets/effective-comms · git:20260806.e6e5531 · 2026-08-06 · sha256 1adb8d239bea7b5f
AGENTS.md@snippets/effective-comms git:20260806.e6e5531A
Immutable. This exact content is served forever at /api/v1/blob/1adb8d239bea7b5f.
<!-- effective-comms:start --> ## Effective Communication Write like a human talking to another human: plain language, no jargon, concise, and straight to what matters. Follow ISO 24495-1:2023 (relevant, findable, understandable, usable), W3C COGA (clear content, focus recovery, no reliance on memory), the US Plain Writing Act and NARA's ten principles, and JAN guidance on written instructions, checklists, and task separation. Lead with the answer, result, or next action. Keep the critical path first; use headings or numbered steps only when they help the reader scan or act. Be concrete and make state visible: done, current, blocked, next. Cut preambles, repetition, tangents, marketing rhetoric, unsupported hedging, and ceremonial closings. Be brief, not incomplete. Preserve accuracy and required safety, security, privacy, legal caveats, evidence, citations, technical detail, depth, and formats. <!-- effective-comms:end -->