документация. - страница 4

Когда Claude Code ошибается не по своей вине: документационный долг в соло-проектах

TL;DRУ соло-разработчика CLAUDE.md устаревает быстрее кода. Через пять-шесть итераций фич он начинает уверенно врать, и Claude верит ему, потому что у него больше нечему верить. Ниже - про понятие документационного долга, кейс с пропавшей подсистемой, пять проверок руками на пятнадцать минут и метод двух слоев + двух сессий, который заменяет код-ревью для соло-разработчика. Главный вывод: одноразовая чистка не работает, документация для AI - это процесс (сюрприз!), не артефакт.1. СимптомОткрываю Claude Code, прошу «продолжить вчерашнюю работу с ХХХ». Он уверенно вызывает функцию validate_post_length

продолжить чтение

Как мы сделали автогенерацию документации для CI-CD из комментариев в коде

продолжить чтение

Без документации ИИ далеко не уедет: мои грабли на проекте

Это продолжение статьи "ИИ может писать код, но умеет ли он делать красиво? Мой опыт с виджетом и аватарами".На этой неделе я побывал в телеграм-клубе 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. Этими правилами и хотим поделиться в этой статье:)Основной принцип

продолжить чтение

Как правильно оформлять РИДы в ИТ-проектах, чтобы не создавать спорных ситуаций

Привет, Хабр! Меня зовут Светлана Мицкевич, я занимаюсь документооборотом в веб-продакшене Далее. В этой статье вы получите подробный гайд о том, как выявить и оформить РИДы в ИТ-проектах. В чем проблема? В разработке проектов всегда необходимо выделять все результаты интеллектуальной деятельности. Особенно если к процессу подключены сразу несколько подрядчиков. 

продолжить чтение

1...234567...8