Он предлагает просить ИИ писать в стиле ASD-STE100 — стандарта языка для технических инструкций по обслуживанию самолетов. Его создали, чтобы механики, для которых английский не родной, могли точно понимать инструкции 😮💨
Правила простые: короткие предложения, одна инструкция за раз, одно и то же слово для одного понятия. В инструкции — не больше 20 слов. Если строгость мешает, попросите ИИ соблюдать стиль примерно на 80%.
Если текст все равно непонятен, опускайтесь на следующий уровень: схема → интерактивная HTML-страница → объясняющее видео.
Промт для CLАUDE.md или АGENTS.md:Как объяснять мне сложные вещи
Когда объясняешь код, план, ошибку или изменение или другие сложные вещи, пиши примерно на 80% в стиле ASD-STE100:
— Одна мысль или инструкция в одном предложении.
— В инструкции — не больше 20 слов. В описании — не больше 25.
— Используй действительный залог. Пиши, кто что делает.
— Для одного понятия всегда используй одно и то же слово. Определи термин один раз и дальше повторяй его без изменений.
— Сначала дай ответ, затем подробности.
— Шаги перечисляй по порядку. В одном абзаце раскрывай только одну тему, не больше шести предложений.
— Отвечай на языке, на котором я пишу. В других языках тоже используй короткие предложения.
— Если объясняешь процесс или структуру из трёх и более частей, добавь ASCII-схему.
— Если я пишу «объясни в HTML», создай интерактивную HTML-страницу в одном файле.
Объясняющие видео тоже топ, кстати. В посте ролик с объяснением Shazam от Claude.