almdev Технический блог
almdev/ Тег/ #dokumentaciya
#dokumentaciya 9 материала

Тег #dokumentaciya

Все статьи с этим тегом — подборка из разных разделов собирается автоматически по мере публикации.

Публикации

Карточки из кода собираются в спецификацию, публичный контракт закрыт печатью
Воркфлоу 6 мин

Я перестал писать Swagger вручную: что в документации API можно делегировать AI

Как делегировать coding agent исследование endpoint, обновление OpenAPI и поиск рассинхронизации, не отдавая е...

1 сен 9 просм.

Таблица маршрутизации: задача, исполнитель, процедура
Субагенты 5 мин

Скиллы и субагенты вместе: кто что знает

Скилл и субагент выглядят как две формы одного и того же и решают разные задачи. Разбираю разделение обязаннос...

27 авг 3 просм.

Короткий файл контекста из трёх разделов
С чего начать 4 мин

С чего начать, шаг 3: минимальный файл контекста

Обязательные разделы файла контекста: команды, конвенции, «чего здесь нет». Как собрать его из ошибок первой н...

13 авг 8 просм.

Короткий лист правил и отдельная толстая справочная подшивка
Скиллы 5 мин

Прогрессивное раскрытие: SKILL.md первым, references по нужде

Скилл загружается целиком, поэтому длинный справочник внутри него оплачивается на каждой задаче. Разбираю разд...

30 июл 4 просм.

Записка из переписки, переложенная в папку репозитория
Промпты 5 мин

Промпт, который живёт в репозитории

Три места, где может жить знание о проекте: сообщение, файл контекста, скилл. Признак, по которому формулировк...

30 июл 11 просм.

Короткая таблица маршрутов на шесть строк
Воркфлоу 5 мин

Маршрутизация задачи: таблица «что кому»

Таблица маршрутизации в AGENTS.md: как формулировать строки, чтобы выбор был однозначным, что делать с задачей...

25 июн 2 просм.

Карточка скилла, где подчёркнута строка описания-триггера
Скиллы 5 мин

Формат SKILL.md: фронтматтер, описание-триггер, тело

Описание скилла определяет, подключится он или нет, и его почти всегда пишут как название темы. Разбираю форма...

16 июн 4 просм.

Два файла контекста и папка с пакетом скиллов и агентов
Воркфлоу 5 мин

Карта репозитория для агента: AGENTS.md, CLAUDE.md, .ai/

Файлов контекста несколько, читают их разные инструменты, содержимое начинает расходиться. Разбираю раскладку:...

11 июн 4 просм.

Одна строка правил против отдельной папки с процедурой
Скиллы 5 мин

Скилл против строки в AGENTS.md: когда заводить

Скилл — это файл с условием срабатывания, и в этом вся разница с файлом контекста. Порог заведения, что остаёт...

2 июн 2 просм.