Стандарт авиастроения против AI-слопа 🔹 AminBlg/SimpleEnglish ⭐ 289 звёзд · Python Agent Skill, который заставляет LLM писать документацию по стандарту ASD-STE100 — контролируемому английскому, на котором аэрокосмическая отрасль пишет мануалы с 1983 года. 53 пронумерованных правила в 9 разделах: максимум 20 слов на инструкцию, активный залог, простые времена, одно слово — одно значение, запрет на should/would/may/might и «-ing»-обороты. Ровно те приёмы, по которым узнаётся AI-слоп: «leveraging», «seamlessly», «it should be noted», хедж-модальность, канцелярит на 40 слов в предложении. Скилл вычищает это на входе, а не правкой постфактум — модель сразу пишет короче и конкретнее. На бенчмарке из 96 генераций (6 моделей Claude × 8 задач) нарушений STE стало меньше на 72,9%, средняя длина предложения упала с 11,2 до 9,7 слова, токенов на выходе тоже меньше. Ставится через npx skills add в Claude Code, Cursor, Codex, Copilot, Gemini CLI и ещё ~25 агентов. Для ChatGPT и claude.ai — версия промптом, есть урезанный вариант на ~60 токенов. На маркетинг и блог-посты скилл сознательно не распространяется. репозиторий Полезная Репа ✈️

Пару мыслей • MCP and API connectors will be the way - то есть UI/UX немного может отойти на 2ой план - все будут работать из своих терминалов etc • MCP amd API - нужны для почти любого сервиса сейчас, это повышает conversion/stickiness • многие сейчас делают так - MCP продают по одному pricing а-ля $99/month => можно только из своего терминала/Claude Desktop/Code работать - API за $199 => можно встраивать в процессы • под API and MCP нужна документация, чтобы LLM с ней лучше работали https://www.mintlify.com - супер крутой сервис - даешь свой сайт - и он сам вытягивает инфо и сразу тебе делает документацию под docs.YOURDOMAIN.COM и это бесплатно

😱 Коду не нужна документация!  Когда LLM начали генерировать мне кучу кода, я решил что хорошей идей будет начать вести документацию к этому коду на понятном человеческом языке. Тогда я думал что это поможет мне понять что там написали агенты быстрее и лучше. 🤷‍♂️ В итоге не прокатило  По факту я просто внедрял в систему еще одно тонкое место, за которым нужно следить, которое нужно поддерживать, и, самое главное, которое жрет контекст. 🫠 Тогда я посмотрел на то, как я сам подхожу к изучению и пониманию кода. И оказалось: я просто читаю код. 😅

Когда-то я так разобрался в том как работает Magento, во времена, когда документации к ней практически не было. Я просто открывал исходники и буквально читал как работает этот фрэймворк.

  🤔 И вашему агенту так же не нужна документация. Ему нужен понятный, читаемый и структурированный код.  К такому же выводу пришел и человек со скриншота, Мэт Покок, человек создавший такие скилы как grill-me, to-spec и teach.  Документировать стоит только то, что не описывает код: бизнес домены, архитектурные решения, инфраструктуру и все в таком духе. Экономьте токены, сегодня они не дешевые 😅 Свята место | 10МДК | ВЕБМастер | YHub

Доделал наконец переезд «один проект - одна папка с репозиторием» и теперь работаю разными агентами - Claude Code, Codex, Hermes, Cursor. Вывод короткий: агенту почти всё равно, чем ты работаешь. Ему важно, как сложены файлы. Google недавно оформил ту же мысль в стандарт для агентов - Open Knowledge Format. Это не сервис и не база данных. Просто формат хранения: — markdown-файлы с короткой шапкой: тип, заголовок, теги, дата — связи - обычные ссылки между файлами — всё лежит в git, читает и человек, и агент Кто вёл заметки в Obsidian, узнает подход: каждая мысль - отдельная заметка со ссылками. Пока работаешь один, про хранение можно вообще не думать: свалил всё в одну папку и просишь Claude Code разобраться - он разберётся. Но как только вас хотя бы двое, начинается: часть документов в заметках, часть в гугл-доках, остальное в головах. Новый человек спрашивает «где у нас про это написано» - а никто и не помнит уже. Собери всё в один репозиторий по понятному формату - и любой, хоть продакт, хоть дизайнер, открывает свой Cursor и спрашивает: «как у нас устроено вот это». Или сам правит пару строк. Выходит общая база знаний, которую каждый читает и самое главное легко обновляет. Самый дешёвый способ держать знания команды живыми. А как у вас устроены общие знания команд или все по старинке ?