#cursor #coding #keylearning #insights

Предыстория

Вчера в очередной раз делал gpt-телеграмм бота и столкнулся с достаточно длительным циклом траблшутинга, который за 15 итераций деплоя на railway.app не привел к рабочему результату.

в секции Project Overview технического задания было записано

gpt telegram bot which  works with text, images and voice for input/output and supports threads and streaming mode

также я в этот раз решил добавить в Core functionalities информацию о том, как бот будет работать с "голосом" - чтобы Cursor сделал мульти-модального gpt-бота "за один присест".
И пара часов траблшутинга пролетели незаметно :)

Поскольку в AI-кодинге, как и в трейдинге, мы работаем с вероятностями, то здесь важно вовремя "зафиксировать убыток" и перестать вязнуть в "петле AI диагностики"

Как только я убрал из Core functionalities всякое упоминание о том, что мне нужны STT/TTS функции и запустил абсолютно такой же процесс генерации кода в отдельной сессии Cursor Agent Composer - первая рабочая версия бота у меня получилась за 20 минут.
Далее пошел приятный процесс проверки работы отдельных опций и исправления неточностей.

После того как все по ТЗ было сделано, я решил вместо STT/TTS добавить проверку валидности пользователей, групп и админские команды для обслуживания бота.
На это ушло примерно полтора часа, и на каждом шаге я видел улучшение результата работы.
Финальный результат по набору доступных функций можно наблюдать на скриншоте.

Выводы
1) Для получения первых видимых результатов не стоит в ТЗ на AI-разработку добавлять сразу весь набор возможных функций.
2) Лучше сразу выделить основные и дополнительные функции. В моем случае STT/TTS - был реально не нужен, т.к. телеграм premium и так данную задачу решает.
3) На дополнительные функции можно написать отдельное ТЗ. Далее воспользоваться Composer агентом и в итеративном режиме постепенно добавлять новые функции и сразу проверять как они работают.
Именно так я поступил во втором подходе к задаче и получил удовольствие от процесса.

#cursor #ai #dev #insights #bestpractice #tracking

С недавних пор при работе над проектами в Cursor я стал использовать методику автоматического трекинга изменений в специализированных md-файлах. Очень сильно экономит время. Ниже моя заметка по теме.

📝 Как правила трекинга делают разработку эффективнее

Двойная система документации: оперативная и стратегическая

• progress.md — это ваш ежедневный дневник разработки
• project-status.md — стратегическая карта проекта
• Вместе они создают полную картину развития проекта

Почему это работает:

• 🎯 Мгновенная фиксация прогресса после каждой задачи
• 🔍 Детальное документирование ошибок и их решений
• 📊 Структурированный подход к управлению проектом
• 🚀 Четкое понимание следующих шагов

Ключевые преимущества:

1️⃣ Предотвращение потери важной информации
2️⃣ Быстрый доступ к решениям прошлых проблем
3️⃣ Прозрачность процесса разработки
4️⃣ Упрощение коммуникации в команде

💡 Интересный факт:

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

🎁 Практический эффект:

• Экономия времени на поиск решений
• Снижение стресса при работе над сложными задачами
• Улучшение качества кода через анализ ошибок
• Повышение продуктивности команды


🔍 P.S. Некоторые внимательные читатели заметили, что в нескольких вариантах реализации "Генератора мемов" (см. заметку выше) я использовал данный подход и стали задавать ❓ вопросы

- "Зачем это нужно?"
- "Как это настроить?"

✨ Что ж, надеюсь, этот пост прояснил вопрос "зачем".
А для тех, кто жаждет узнать "как" - файл .cursorrules уже ждет вас на моём GitHub!

🔗 Загляните в предыдущий пост для контекста: https://t.me/llm_notes/58

#cursor #extension #specstory #history #tracking

🚀 SpecStory: Все AI-чаты c Cursor агентом теперь сохраняются автоматически!

Привет, друзья! 👋

Сегодня хочу поделиться находкой, которая поможет улучшить ваш рабочий процесс в Cursor Editor.

Я думаю, что у многих периодически возникала необходимость сохранить весь диалог с Cursor агентом в текстовый файл (для формирования истории классных идей, работающих промптов, чтобы поделиться с другом, собрать свою базу знаний и т.д.)

🧠 Что такое SpecStory?

SpecStory — это расширение для Cursor, которое автоматически сохраняет все ваши чаты с Cursor AI-агентом. Представьте: больше никаких потерянных гениальных решений или забытых подсказок!

Это может стать отличным дополнением к трекингу изменений проекта в качестве оригинальной первичной информации.

✨ Главные возможности:

• 🪄 Автосохранение чатов — вся история чата сохраняется локально в папке .specstory/history

Далее идут фичи, которые есть в интерфейсе, но мне не удалось заставить их работать (если кому-то удастся, напишите, пожалуйста, в комментариях!):

• 📝 Ручное сохранение избранных моментов — выбирайте только нужные диалоги (функция заявлена, но, по-моему, еще не работает, и гранулярность настройки — с точностью до чата, выбрать конкретный "эпизод" общения с Cursor агентом внутри чата не получится)

• 🌟 Простое создание ссылок для шеринга — делитесь историей AI-чата с Cursor анонимно (функция заявлена, но пока не работает, ссылка генерируется, но не открывается, даже если добавить сайт share.specstory.com в Trusted Domain внутри Cursor)

🛠 Как установить:
• Убедитесь, что у вас последняя версия Cursor
• Скачайте файл расширения: specstory-vscode-latest.vsix
• Откройте Command Palette (Ctrl/CMD-Shift-P) и выберите Extensions: Install from VSIX…
• Выберите скачанный файл
• Готово! 🎉
(Источник здесь)

💡 Как использовать:

• Автосохранение работает сразу после установки

• Для ручного сохранения: Command Palette → SpecStory: Save Composer and Chat History (непонятно зачем, так как любой новый чат будет сохранен автоматически, даже если вы его удалите — он все равно заново появится в папке .specstory/history)

• Для шеринга: Command Palette → SpecStory: Share Composer and Chat History (как уже писал выше, мне не удалось заставить эту фичу работать)

• Можно в новом чате при желании ссылаться на контент предыдущих чатов: используйте @ упоминания в новых сессиях, чтобы Cursor AI-агент мог обращаться к вашим предыдущим чатам как к базе знаний!

🤔 Почему это круто?

• Представьте, что вы можете вернуться к любому чату с Cursor AI-агентом многомесячной давности и найти то гениальное решение, которое уже забыли, или поделиться своим процессом решения сложной задачи с коллегой.

• Можно пойти еще дальше и начать строить на базе своих сессий общения с Cursor агентом персонального ИИ-ассистента, который будет "знать" про все лайфхаки, которые вы обнаружили за все время работы с Cursor, и использовать его при написании кода.

#CursorEditor #AITools #SpecStory #Программирование

Источники:
https://docs.specstory.com/introduction
https://docs.specstory.com/features
https://docs.specstory.com/quickstart

Memory Bank: как сделать ИИ-кодера умнее и дешевле 🧠💰

Всем добрый вечер!

Хотел бы рассказать про крутую фишку для работы с ИИ-кодерами — Memory Bank.
Это система, которая делает Cline, RooCode, Cursor и другие ИИ-инструменты в разы эффективнее.
По сути, это развитие подхода авто-трекинга изменений проекта, о котором писал еще в начале года.

Что такое Memory Bank? 📁
Это набор markdown-файлов, которые ИИ-кодер автоматически создаёт и обновляет, чтобы "помнить" всё о вашем проекте между сессиями. Все это для того, чтобы у вашего ИИ-кодера появилась долговременная память!

Какие файлы создаются? 📋
Memory Bank состоит из 6 основных файлов:

• projectbrief.md — основа проекта, цели и требования
• productContext.md — для чего нужен продукт, какие проблемы решает
• activeContext.md — над чем работаем сейчас, текущие задачи
• systemPatterns.md — архитектура, технические решения
• techContext.md — используемые технологии и зависимости
• progress.md — что сделано, что осталось, известные проблемы

Зачем это нужно? 🤔

1️⃣ Экономия денег — не нужно держать огромные дорогие треды, где повторяется контекст

2️⃣ Экономия времени — не нужно каждый раз объяснять ИИ, что вы делаете

3️⃣ Лучшее качество кода — ИИ помнит все паттерны и решения проекта

4️⃣ Документация на автомате — получаете структурированную документацию как побочный эффект

Как настроить? ⚙️
1) Создайте папку memory-bank/ в корне проекта
2) Добавьте специальные инструкции в настройках ИИ-кодера:

• В Cline: Settings → Custom Instructions → вставьте инструкции
• В Cursor: создайте .cursor/rules/memory-bank.mdc

3) Напишите ИИ-кодеру: initialize memory bank

И всё! Теперь ваш ИИ будет автоматически поддерживать актуальную "память" о проекте.

Как использовать? 🚀
• Начинайте новые чаты с фразы follow your custom instructions
• Когда нужно обновить память, пишите update memory bank
• Используйте режимы Plan (планирование) и Act (реализация)

Особенно круто, что можно переключаться между разными ИИ-инструментами — они будут читать одни и те же файлы Memory Bank!

Мой опыт 💡
Я заметил, что с Memory Bank:
• Расход токенов снизился, примерно на треть
• ИИ стал делать меньше ошибок
• Не нужно постоянно напоминать контекст
• Появилась хорошая документация проекта

Попробуйте сами — это улучшает подход к работе с ИИ-кодерами!

Источники
• Cline Memory Bank | Cline
• Cline Memory Bank - Custom Instructions (GitHub)
• How to add Cline Memory Bank feature to your cursor (Cursor Community Forum)
• Roo Code Memory Bank (Github)

#ИИ #разработка #Cline #RooCode #Cursor #MemoryBank