Когда Claude Code ошибается не по своей вине: документационный долг в соло-проектах
TL;DRУ соло-разработчика CLAUDE.md устаревает быстрее кода. Через пять-шесть итераций фич он начинает уверенно врать, и Claude верит ему, потому что у него больше нечему верить. Ниже - про понятие документационного долга, кейс с пропавшей подсистемой, пять проверок руками на пятнадцать минут и метод двух слоев + двух сессий, который заменяет код-ревью для соло-разработчика. Главный вывод: одноразовая чистка не работает, документация для AI - это процесс (сюрприз!), не артефакт.1. СимптомОткрываю Claude Code, прошу «продолжить вчерашнюю работу с ХХХ». Он уверенно вызывает функцию validate_post_length
Без документации ИИ далеко не уедет: мои грабли на проекте
Это продолжение статьи "ИИ может писать код, но умеет ли он делать красиво? Мой опыт с виджетом и аватарами".На этой неделе я побывал в телеграм-клубе AI Practiq, где ребята собираются, обсуждают вайбкодинг, делятся опытом и практиками.Один из участников рассказывал о своём опыте и выделил четыре важных аспекта качественной разработки с ИИ. Один из них - документация.Это очень точно совпало с моими ощущениями.ИИ не должен работать по принципу First Code.
Veai 5.10: общие скиллы и подсказки в чате
Главное в релизе – скиллы теперь подхватываются из dot-директорий других ассистентов. В чат добавили быструю документацию по ссылкам на код.Скиллы из dot-директорий других вендоровТипичная ситуация – в команде один работает на Claude Code, второй на Cursor, третий на Veai. У каждого своя папка под скиллы, и одни и те же инструкции расходятся по .claude, .cursor, .veai. Чтобы агент в Veai знал то же, что агент в Claude Code, скиллы приходилось копировать руками и потом следить, чтобы версии не разъехались.Теперь Veai ищет скиллы не только в .veai/skills/*/SKILL.md, но и в .*/skills/*/
AI-friendly и AI-first: как адаптировать ИТ-проекты под эру LLM
Привет, Хабр! Последние полгода стало модно создавать новые и переводить старые проекты на рельсы AI-First (или AI-Friendly) стандарта. Уже появляются проекты, которые декларируются как «designed for AI to write». Например, AIR
Пять книг для IT авторов, технических писателей и редакторов
Перечитала недавно книгу «Слово живое и мёртвое» и опять открыла для себя интересные моменты, которые до этого не замечала. Хочу представить вам пять книг, которые действительно полезны для IT авторов, а также полезны техническим писателям, IT редакторам и всем, кто вообще работает с текстом.Нора Галь «Слово живое и мёртвое»
Парсим MDN и пишем оффлайн RAG-MCP
Привет.В этой технической статье мы на практике разберёмся, что такое RAG, распарсим MDN Web Docs, научимся готовить эмбеддинги, заполним ими векторную базу данных и напишем свой MCP сервер с гибридным векторным и полнотекстовым поиском. Зальём всё получившееся добро на HuggingFace, GitHub и NPM, и настроим автоматическое обновление данных.Внутри будет много пошаговых инструкций и примеров кода на Bun + TypeScript.Скриншот вместо тысячи слов:
Незаменимые сотрудники это не проблема
Недавно на Хабре вышла статья Ивана Потапенко «Зачем и как избавляться от незаменимых сотрудников». Там про bus factor, про бутылочное горлышко, про ротацию, про дубляж знаний и работу вслух. Выглядит убедительно. Автор с 20 летним опытом, управлял отделами, доклад на конференции. Но есть одна проблема.Иван описал идеальную команду в идеальном мире. Мир, где все хотят читать документацию. Где сотрудники сами пишут статьи в Wiki. Где ротация воспринимается с энтузиазмом, а не как «опять этот менеджер придумал». В реальности живут другие люди.
Как редактору повысить качество ответов RAG-поиска
Всем привет! Меня зовут Катя, я развиваю Gramax — базу знаний для ИТ-команд.В Gramax мы делаем упор на качественную работу как человека, так и машины. И часто получаем вопросы, как автор статей может повлиять на качество выдачи ИИ-поиска. В большей мере качество поиска зависит от нас: мы регулярно улучшаем внутренние механизмы, чтобы авторы не становились заложниками технологий. Но есть универсальные правила, которые работают в любой системе с RAG. Этими правилами и хотим поделиться в этой статье:)Основной принцип
Как правильно оформлять РИДы в ИТ-проектах, чтобы не создавать спорных ситуаций
Привет, Хабр! Меня зовут Светлана Мицкевич, я занимаюсь документооборотом в веб-продакшене Далее. В этой статье вы получите подробный гайд о том, как выявить и оформить РИДы в ИТ-проектах. В чем проблема? В разработке проектов всегда необходимо выделять все результаты интеллектуальной деятельности. Особенно если к процессу подключены сразу несколько подрядчиков.

