Сегодня поговорим про DevLog. DevLog - то как я его вижу, это записи по мере разработки проекта. До эпохи нейросетей обычно такие вещи мы отражали во внутренней документации проекта. Сегодня можно отдать рутину по саммаризации правок ИИ агентам, и они будут сами выполнять эту важную, но монотонную работу.

Зачем вам он вообще нужен? Ну, во-первых, понять во времени как менялся проект. Вам это позволит совершенствоваться, или вспомнить позже какое-то удачное решение. Во-вторых, он нужен ИИ агентам, чтобы иметь контекст разработки в целом, и навигацию по основным этапам. Так как в конечном счете это все равно текст, он будет успешно обработан и агент будет руководстоваться логикой правок, который был описан в логе.

Ну и правило для Cursor как бонус

---
alwaysApply: true
---

# DevLog Documentation Rule

## Когда создавать DevLog файлы

При завершении работы над задачей, фиксом или значительным изменением в коде, всегда создавай файл с кратким описанием в директории [docs/devlog/](mdc:docs/devlog/).

## Формат названия файла

Название файла должно следовать формату:

XXXX-краткое-описание-изменений.md


Где:
- XXXX - четырёхзначный порядковый номер (0001, 0002, 0003, и т.д.)
- - - дефис-разделитель после номера
- краткое-описание-изменений - описание строчными буквами (lowercase), слова разделены дефисами
- .md - расширение Markdown файла

### Примеры правильных названий:
- ✅ 0001-multi-source-search-implementation.md
- ✅ 0002-fix-authentication-bug.md
- ✅ 0003-add-gitlab-integration.md
- ✅ 0123-optimize-qdrant-queries.md

### Примеры неправильных названий:
- ❌ MULTI_SOURCE_SEARCH_SUMMARY.md (нет индекса, заглавные буквы, подчёркивания)
- ❌ fix-bug.md (нет индекса)
- ❌ 1-Fix-Bug.md (индекс не 4 цифры, заглавные буквы)

## Определение следующего номера

Перед созданием нового файла:
1. Проверь содержимое директории [docs/devlog/](mdc:docs/devlog/)
2. Найди файл с максимальным индексом (например, `0042-...`)
3. Используй следующий номер (`0043`)
4. Если директория пуста, начни с 0001

## Структура DevLog файла

Файл должен содержать:

1. Заголовок - краткое название задачи/фикса
2. Проблема (🎯) - описание проблемы или задачи
3. Решение (✅) - описание реализованного решения
4. Изменённые файлы (📝) - список изменённых файлов с кратким описанием
5. Как протестировать (🚀) - инструкции для проверки изменений
6. Важные детали (⚙️) - дополнительная информация, особенности реализации
7. Итог (🎉) - краткий summary результата

### Пример структуры:


# Краткое описание задачи

## 🎯 Проблема
Описание проблемы...

## ✅ Решение
Описание решения...

## 📝 Изменённые файлы
1. путь/к/файлу.py - что изменено
2. путь/к/другому/файлу.ts - что изменено

## 🚀 Как протестировать
Инструкции для тестирования...

## ⚙️ Важные детали
Дополнительная информация...

## 🎉 Итог
Краткий summary...


## Когда НЕ создавать DevLog

Не создавай DevLog файлы для:
- Мелких опечаток или исправлений форматирования
- Обновления документации без изменений в коде
- Рефакторинга без изменения функциональности (если только это не большой рефакторинг)

## Примеры использования

### Пример 1: Исправление бага
Файл: docs/devlog/0001-fix-search-single-source-bug.md
Содержание: Описание проблемы с поиском только в одном источнике и реализованное решение

### Пример 2: Новая фича
Файл: docs/devlog/0002-add-jira-integration.md
Содержание: Описание интеграции с Jira

### Пример 3: Оптимизация
Файл: docs/devlog/0003-optimize-embedding-performance.md
Содержание: Описание оптимизации производительности embeddings

## Важно

- Всегда проверяй существующие файлы в [docs/devlog/](mdc:docs/devlog/) перед созданием нового
- Используй строчные буквы в названии (lowercase)
- Разделяй слова дефисами, не используй underscores или CamelCase
- Пиши на русском языке в содержимом файла (если это основной язык проекта)
- Используй эмодзи для визуальной структуры (🎯 ✅ 📝 🚀 ⚙️ 🎉)

Наконец-то появился Plan-Mode в Cursor.

Кто не в курсе, обычный эффективный цикл работы с агентами - создаем MD-план на проект, описываем в директории docs/ все этапы разработки, и идем по чеклисту, скрамливая по файлику за раз агенту, и тот реализует требования. Просто и понятно.

Кто был ленивый - использовал MCP TaskMaster. Но проблема его была в том, что он генерил тонну не нужных реализаций и надо было вычищать.

Посмотрим что можно сделать в реализации от Cursor

https://cursor.com/blog/plan-mode

Неплохая статья подумать о том куда все идет. У самого есть пара идей, выложу на medium.com как допишу и соберу все мысли во едино. https://www.ibm.com/think/insights/artificial-intelligence-future

Накидал статью по мотивам - https://medium.com/@vinogradoff/effective-ai-87325da67a38

В Cursor завезли Debug-режим. Раньше тоже самое можно было сделать через режим планирования, где ты описываешь проблему, и просишь ее исследовать. Теперь флоу упростился - скидываешь логи, контекст и ждешь решения. Работает не с первого раза, много пишет отладочных логов, надо за этим следить. Но в целом направление верное. Давно такого не хватало. https://cursor.com/blog/debug-mode

Моя ачивка за год от Cursor.com xD

На днях стало известно что в сеть утекла сборка Claude Code. Среди версий которые распространяли были и просто CLI Rust утилиты, но вот тот самый агент - https://gitverse.ru/anarchic/claude-code. Качаем, пока юристы Антропика не добрались. Кто не успел, забираем архив из ТГ

Кто устал от Dify/Langflow/n8n и прочих Apache NiFi узловых интерфейсов, тому предлагаю посмотреть в сторону нормального человеческого кода и затестить Eino AI Framework https://www.cloudwego.io/docs/eino/overview/bytedance_eino_practice/. Попутно предлагаю таки поставить neovim со всеми нужными плагинами, и подетоксится от нейро-кодинга в течение выходных. Я так и сделал.

Cursor прислал рефералку. Скида в 50% первый месяц, а мне всякие бонусы) У кого еще не стоит или кто задумался приобретать платную версию вот вам рефка - https://cursor.com/referral?code=MANDFM4SBMQB

Коллеги подкинули на изучение multica.ai, на выходных ставлю его в свой пет-проект и на следующей неделе скину результаты в канал. Пока смотрим обзор-сравнение. Есть еще в планах это подружить с Hermes, но это надо разобраться с OpenRouter-моделями, пока не до этого. Смотреть тут - https://youtu.be/gh9DAo1uKy4?si=DDe06pDOwEjxuBH6

Работая с multica пришел к выводу, что не достаточно настроить процессы, тулинг и окружение. Я упустил одну важную, первостепенную вещь, при работе в распределенной агентной сети - это Память. Мусоля эту идею, накидал несколько подходов для решения задач по параллельной разработке - когда в единицу времени приходят не связанные между собой, но влияющие на конечный результат, требования. Оказалось, что проблема гораздо шире - и это долгосрочная память агентов и когнитивные способности. На практике, чтобы вы могли просто поставить кучу тикетов оркестратору, и потом ждать результата в течение недели, вам надо организовать не просто процесс координации, а инженерную систему памяти, с которой будут работать все агенты, на постоянной основе. Они должны пополнять артефактами эту базу данных. К сожалению, это не простая задача. Вам придется строить некий слой работы с памятью за пределами сессий агентов, и это нечто гораздо более сложное чем RAG - это система доступа и обновления долгосрочной памяти проекта. Наткнулся на статью на medium, которая хорошо описывает данную задачу (доступна только для тех у кого там есть подписка, к сожалению) - https://richmondalake.medium.com/ushering-in-the-era-of-agent-memory-engineering-c03cde2e1962. Из проектов, которые могут помочь разобраться в тематике, наверное стоит посмотреть на MemGPT (https://research.memgpt.ai/). Продолжение следует