describe-bug

Анализирует контекст чата, определяет что было предпринято для исправления бага, объясняет почему это не сработало, и создает детальное описание проблемы с указанием всех связанных файлов и элементов.

by bogomolovf(0) 0 installs

Prompt file imported from bogomolovf/workyy (.cursor/commands/tasks/describe-bug.md). Copyright stays with the author.

Describe Bug

Name: describe-bug
Author: bogomolovf

Prompt

Проанализируй историю этого чата и создай детальное описание бага/проблемы/дефектного поведения.

КРИТИЧЕСКИ ВАЖНО:

Изучи ВСЮ историю чата от начала до текущего момента
Определи что было предпринято для исправления
Объясни почему попытки исправления не сработали
Найди ВСЕ файлы и элементы, связанные с багом (даже косвенно)
Создай структурированное описание для последующей обработки командой fix-bug

Контекст проекта (кратко)

Workyy — браузерная платформа аналитики на бесконечном холсте с SQL/Python узлами и реалтайм коллаборацией.

Архитектура:

apps/web - Next.js 14+ (App Router), React, ReactFlow, Zustand
apps/realtime-server - Fastify, y-websocket, Prisma, PostgreSQL
packages/core-domain - Доменные схемы
packages/dag-executor - Исполнитель DAG

Ключевые особенности:

Реалтайм синхронизация через Yjs (автоматическая)
Выполнение узлов: SQL (DuckDB-WASM), Python (Pyodide) в браузере
Execution Store (Zustand) для результатов выполнения узлов
DAG (Directed Acyclic Graph) для зависимостей узлов

Подробнее: См. .cursor/commands/agents/developer-agent.md для полного контекста.

Процесс анализа бага

Шаг 1: Анализ истории чата

Изучи всю историю чата:

Первоначальное описание проблемы:
- Что было описано пользователем?
- Какое дефектное поведение наблюдалось?
- Какие шаги воспроизведения были указаны?
- Какой был ожидаемый результат?
Предпринятые попытки исправления:
- Какие изменения были внесены?
- Какие файлы были модифицированы?
- Какие подходы были опробованы?
- Что было добавлено/удалено/изменено?
Результаты попыток:
- Сработало ли исправление?
- Если нет - почему?
- Какие ошибки появились?
- Что изменилось в поведении?
Контекст обсуждения:
- Какие гипотезы выдвигались?
- Какие вопросы задавались?
- Какая дополнительная информация была получена?

Шаг 2: Поиск связанных файлов и элементов

Найди ВСЕ связанные компоненты:

Прямо связанные файлы:
- Файлы, которые были изменены
- Файлы, упомянутые в чате
- Файлы с ошибками в консоли/логах
Косвенно связанные файлы:
- Импорты измененных файлов
- Файлы, импортирующие измененные компоненты
- Сервисы/утилиты, используемые проблемным кодом
- Типы и схемы, связанные с проблемой
Связанные элементы системы:
- API endpoints (если проблема в backend)
- React компоненты (если проблема в frontend)
- Store состояния (Zustand stores)
- Сервисы и утилиты
- Типы и интерфейсы
- Конфигурация (env, схемы БД)

Используй codebase_search для поиска:

codebase_search: "How does [проблемная функциональность] work?"
codebase_search: "Where is [затронутый компонент] used?"
codebase_search: "What files import [измененный файл]?"

Используй grep для точного поиска:

grep: найти все использования измененных функций/компонентов
grep: найти все импорты измененных модулей
grep: найти все места, где используются затронутые типы

Шаг 3: Анализ причин неудачи

Определи почему исправление не сработало:

Корневая причина:
- Была ли устранена настоящая причина бага?
- Или исправлялись только симптомы?
- Есть ли более глубокие проблемы в архитектуре?
Побочные эффекты:
- Появились ли новые проблемы?
- Нарушилась ли другая функциональность?
- Есть ли конфликты с существующим кодом?
Недостающая информация:
- Что не было учтено?
- Какие зависимости не были проанализированы?
- Какие edge cases не были покрыты?
Специфика Workyy:
- Проблема с Yjs синхронизацией?
- Проблема с executionStore?
- Проблема с DAG зависимостями?
- Проблема с выполнением узлов?

Шаг 4: Создание детального описания

Создай структурированное описание в следующем формате:

Описание бага

Краткое резюме

[1-2 предложения о сути проблемы]

Дефектное поведение

Что происходит:

[Конкретное описание наблюдаемого поведения]
[Шаги воспроизведения]
[Условия, при которых возникает]

Ожидаемое поведение:

[Как должно работать]

Фактическое поведение:

[Что происходит на самом деле]

Воспроизведение

Шаги для воспроизведения:

[Шаг 1]
[Шаг 2]
[Шаг 3]

Условия воспроизведения:

Окружение: [dev/prod/staging]
Браузер: [если применимо]
Версия: [если применимо]
Предварительные условия: [если есть]

Анализ попыток исправления

Попытка 1: [описание]

Что было сделано: [конкретные изменения]
Файлы: [список файлов]
Почему не сработало: [анализ причин]
Результат: [что изменилось/не изменилось]

Попытка 2: [описание]

[аналогично]

Попытка N: [описание]

[аналогично]

Связанные файлы и элементы

Прямо связанные:

path/to/file1.ts - [описание связи]
path/to/file2.tsx - [описание связи]

Косвенно связанные:

path/to/file3.ts - [описание связи]
path/to/file4.ts - [описание связи]

Связанные компоненты системы:

API endpoints: /api/... - [если применимо]
React компоненты: ComponentName - [если применимо]
Stores: storeName - [если применимо]
Сервисы: serviceName - [если применимо]
Типы: TypeName - [если применимо]

Корневая причина

Гипотезы о корневой причине:

[Гипотеза 1] - [обоснование]
[Гипотеза 2] - [обоснование]
[Гипотеза 3] - [обоснование]

Наиболее вероятная причина:

[Описание наиболее вероятной корневой причины]
[Почему она наиболее вероятна]

Специфика Workyy

Связано ли с:

Yjs реалтайм синхронизацией
Execution Store (Zustand)
DAG зависимостями узлов
Выполнением узлов (SQL/Python)
WebSocket соединением
Prisma/PostgreSQL
Next.js App Router
Другое: [описание]

Дополнительный контекст

Логи/ошибки:

[Здесь цитаты ошибок из консоли/логов]

Скриншоты/примеры: [Если были упомянуты в чате]

Связанные issues/PR: [Если были упомянуты]

Формат использования

Пользователь применяет команду в чате, где уже была попытка исправления:

/describe-bug

Команда автоматически анализирует всю историю чата и создает описание выше.

Или с дополнительным контекстом:

/describe-bug

Дополнительный контекст:
- Проблема возникла после последнего коммита
- Воспроизводится только в Chrome
- Связана с выполнением Python узлов

Пример вывода

После анализа чата команда выводит детальное описание в формате выше, которое затем можно использовать с командой /fix-bug:

/fix-bug

[Вставь сюда описание бага, созданное командой describe-bug]

Готов к анализу

Проанализирую историю чата и создам детальное описание бага со всеми связанными файлами и элементами для последующего исправления.

# Describe Bug Анализирует контекст чата, определяет что было предпринято для исправления бага, объясняет почему это не сработало, и создает детальное описание проблемы с указанием всех связанных файлов и элементов. ## Prompt Проанализируй историю этого чата и создай детальное описание бага/проблемы/дефектного поведения. **КРИТИЧЕСКИ ВАЖНО:** - Изучи ВСЮ историю чата от начала до текущего момента - Определи что было предпринято для исправления - Объясни почему попытки исправления не сработали - Найди ВСЕ файлы и элементы, связанные с багом (даже косвенно) - Создай структурированное описание для последующей обработки командой `fix-bug` ## Контекст проекта (кратко) **Workyy** — браузерная платформа аналитики на бесконечном холсте с SQL/Python узлами и реалтайм коллаборацией. **Архитектура:** - `apps/web` - Next.js 14+ (App Router), React, ReactFlow, Zustand - `apps/realtime-server` - Fastify, y-websocket, Prisma, PostgreSQL - `packages/core-domain` - Доменные схемы - `packages/dag-executor` - Исполнитель DAG **Ключевые особенности:** - Реалтайм синхронизация через Yjs (автоматическая) - Выполнение узлов: SQL (DuckDB-WASM), Python (Pyodide) в браузере - Execution Store (Zustand) для результатов выполнения узлов - DAG (Directed Acyclic Graph) для зависимостей узлов **Подробнее:** См. `.cursor/commands/agents/developer-agent.md` для полного контекста. ## Процесс анализа бага ### Шаг 1: Анализ истории чата **Изучи всю историю чата:** 1. **Первоначальное описание проблемы:** - Что было описано пользователем? - Какое дефектное поведение наблюдалось? - Какие шаги воспроизведения были указаны? - Какой был ожидаемый результат? 2. **Предпринятые попытки исправления:** - Какие изменения были внесены? - Какие файлы были модифицированы? - Какие подходы были опробованы? - Что было добавлено/удалено/изменено? 3. **Результаты попыток:** - Сработало ли исправление? - Если нет - почему? - Какие ошибки появились? - Что изменилось в поведении? 4. **Контекст обсуждения:** - Какие гипотезы выдвигались? - Какие вопросы задавались? - Какая дополнительная информация была получена? ### Шаг 2: Поиск связанных файлов и элементов **Найди ВСЕ связанные компоненты:** 1. **Прямо связанные файлы:** - Файлы, которые были изменены - Файлы, упомянутые в чате - Файлы с ошибками в консоли/логах 2. **Косвенно связанные файлы:** - Импорты измененных файлов - Файлы, импортирующие измененные компоненты - Сервисы/утилиты, используемые проблемным кодом - Типы и схемы, связанные с проблемой 3. **Связанные элементы системы:** - API endpoints (если проблема в backend) - React компоненты (если проблема в frontend) - Store состояния (Zustand stores) - Сервисы и утилиты - Типы и интерфейсы - Конфигурация (env, схемы БД) **Используй codebase_search для поиска:** ``` codebase_search: "How does [проблемная функциональность] work?" codebase_search: "Where is [затронутый компонент] used?" codebase_search: "What files import [измененный файл]?" ``` **Используй grep для точного поиска:** ``` grep: найти все использования измененных функций/компонентов grep: найти все импорты измененных модулей grep: найти все места, где используются затронутые типы ``` ### Шаг 3: Анализ причин неудачи **Определи почему исправление не сработало:** 1. **Корневая причина:** - Была ли устранена настоящая причина бага? - Или исправлялись только симптомы? - Есть ли более глубокие проблемы в архитектуре? 2. **Побочные эффекты:** - Появились ли новые проблемы? - Нарушилась ли другая функциональность? - Есть ли конфликты с существующим кодом? 3. **Недостающая информация:** - Что не было учтено? - Какие зависимости не были проанализированы? - Какие edge cases не были покрыты? 4. **Специфика Workyy:** - Проблема с Yjs синхронизацией? - Проблема с executionStore? - Проблема с DAG зависимостями? - Проблема с выполнением узлов? ### Шаг 4: Создание детального описания **Создай структурированное описание в следующем формате:** ## Описание бага ### Краткое резюме [1-2 предложения о сути проблемы] ### Дефектное поведение **Что происходит:** - [Конкретное описание наблюдаемого поведения] - [Шаги воспроизведения] - [Условия, при которых возникает] **Ожидаемое поведение:** - [Как должно работать] **Фактическое поведение:** - [Что происходит на самом деле] ### Воспроизведение **Шаги для воспроизведения:** 1. [Шаг 1] 2. [Шаг 2] 3. [Шаг 3] **Условия воспроизведения:** - Окружение: [dev/prod/staging] - Браузер: [если применимо] - Версия: [если применимо] - Предварительные условия: [если есть] ### Анализ попыток исправления **Попытка 1: [описание]** - Что было сделано: [конкретные изменения] - Файлы: [список файлов] - Почему не сработало: [анализ причин] - Результат: [что изменилось/не изменилось] **Попытка 2: [описание]** - [аналогично] **Попытка N: [описание]** - [аналогично] ### Связанные файлы и элементы **Прямо связанные:** - `path/to/file1.ts` - [описание связи] - `path/to/file2.tsx` - [описание связи] **Косвенно связанные:** - `path/to/file3.ts` - [описание связи] - `path/to/file4.ts` - [описание связи] **Связанные компоненты системы:** - API endpoints: `/api/...` - [если применимо] - React компоненты: `ComponentName` - [если применимо] - Stores: `storeName` - [если применимо] - Сервисы: `serviceName` - [если применимо] - Типы: `TypeName` - [если применимо] ### Корневая причина **Гипотезы о корневой причине:** 1. [Гипотеза 1] - [обоснование] 2. [Гипотеза 2] - [обоснование] 3. [Гипотеза 3] - [обоснование] **Наиболее вероятная причина:** - [Описание наиболее вероятной корневой причины] - [Почему она наиболее вероятна] ### Специфика Workyy **Связано ли с:** - [ ] Yjs реалтайм синхронизацией - [ ] Execution Store (Zustand) - [ ] DAG зависимостями узлов - [ ] Выполнением узлов (SQL/Python) - [ ] WebSocket соединением - [ ] Prisma/PostgreSQL - [ ] Next.js App Router - [ ] Другое: [описание] ### Дополнительный контекст **Логи/ошибки:** ``` [Здесь цитаты ошибок из консоли/логов] ``` **Скриншоты/примеры:** [Если были упомянуты в чате] **Связанные issues/PR:** [Если были упомянуты] ### Рекомендации для исправления **Предполагаемый подход:** - [Какой подход, вероятно, должен сработать] - [Что нужно учесть] - [Какие файлы нужно изменить] **Важные замечания:** - [Что нельзя упустить] - [Потенциальные побочные эффекты] - [Риски исправления] ## Формат использования **Пользователь применяет команду в чате, где уже была попытка исправления:** ``` /describe-bug ``` Команда автоматически анализирует всю историю чата и создает описание выше. **Или с дополнительным контекстом:** ``` /describe-bug Дополнительный контекст: - Проблема возникла после последнего коммита - Воспроизводится только в Chrome - Связана с выполнением Python узлов ``` ## Пример вывода После анализа чата команда выводит детальное описание в формате выше, которое затем можно использовать с командой `/fix-bug`: ``` /fix-bug [Вставь сюда описание бага, созданное командой describe-bug] ``` ## Готов к анализу Проанализирую историю чата и создам детальное описание бага со всеми связанными файлами и элементами для последующего исправления.

{ "prompt": "# Describe Bug\n\nАнализирует контекст чата, определяет что было предпринято для исправления бага, объясняет почему это не сработало, и создает детальное описание проблемы с указанием всех связанных файлов и элементов.\n\n## Prompt\n\nПроанализируй историю этого чата и создай детальное описание бага/проблемы/дефектного поведения.\n\n**КРИТИЧЕСКИ ВАЖНО:**\n\n- Изучи ВСЮ историю чата от начала до текущего момента\n- Определи что было предпринято для исправления\n- Объясни почему попытки исправления не сработали\n- Найди ВСЕ файлы и элементы, связанные с багом (даже косвенно)\n- Создай структурированное описание для последующей обработки командой `fix-bug`\n\n## Контекст проекта (кратко)\n\n**Workyy** — браузерная платформа аналитики на бесконечном холсте с SQL/Python узлами и реалтайм коллаборацией.\n\n**Архитектура:**\n\n- `apps/web` - Next.js 14+ (App Router), React, ReactFlow, Zustand\n- `apps/realtime-server` - Fastify, y-websocket, Prisma, PostgreSQL\n- `packages/core-domain` - Доменные схемы\n- `packages/dag-executor` - Исполнитель DAG\n\n**Ключевые особенности:**\n\n- Реалтайм синхронизация через Yjs (автоматическая)\n- Выполнение узлов: SQL (DuckDB-WASM), Python (Pyodide) в браузере\n- Execution Store (Zustand) для результатов выполнения узлов\n- DAG (Directed Acyclic Graph) для зависимостей узлов\n\n**Подробнее:** См. `.cursor/commands/agents/developer-agent.md` для полного контекста.\n\n## Процесс анализа бага\n\n### Шаг 1: Анализ истории чата\n\n**Изучи всю историю чата:**\n\n1. **Первоначальное описание проблемы:**\n - Что было описано пользователем?\n - Какое дефектное поведение наблюдалось?\n - Какие шаги воспроизведения были указаны?\n - Какой был ожидаемый результат?\n\n2. **Предпринятые попытки исправления:**\n - Какие изменения были внесены?\n - Какие файлы были модифицированы?\n - Какие подходы были опробованы?\n - Что было добавлено/удалено/изменено?\n\n3. **Результаты попыток:**\n - Сработало ли исправление?\n - Если нет - почему?\n - Какие ошибки появились?\n - Что изменилось в поведении?\n\n4. **Контекст обсуждения:**\n - Какие гипотезы выдвигались?\n - Какие вопросы задавались?\n - Какая дополнительная информация была получена?\n\n### Шаг 2: Поиск связанных файлов и элементов\n\n**Найди ВСЕ связанные компоненты:**\n\n1. **Прямо связанные файлы:**\n - Файлы, которые были изменены\n - Файлы, упомянутые в чате\n - Файлы с ошибками в консоли/логах\n\n2. **Косвенно связанные файлы:**\n - Импорты измененных файлов\n - Файлы, импортирующие измененные компоненты\n - Сервисы/утилиты, используемые проблемным кодом\n - Типы и схемы, связанные с проблемой\n\n3. **Связанные элементы системы:**\n - API endpoints (если проблема в backend)\n - React компоненты (если проблема в frontend)\n - Store состояния (Zustand stores)\n - Сервисы и утилиты\n - Типы и интерфейсы\n - Конфигурация (env, схемы БД)\n\n**Используй codebase_search для поиска:**\n\n```\ncodebase_search: \"How does [проблемная функциональность] work?\"\ncodebase_search: \"Where is [затронутый компонент] used?\"\ncodebase_search: \"What files import [измененный файл]?\"\n```\n\n**Используй grep для точного поиска:**\n\n```\ngrep: найти все использования измененных функций/компонентов\ngrep: найти все импорты измененных модулей\ngrep: найти все места, где используются затронутые типы\n```\n\n### Шаг 3: Анализ причин неудачи\n\n**Определи почему исправление не сработало:**\n\n1. **Корневая причина:**\n - Была ли устранена настоящая причина бага?\n - Или исправлялись только симптомы?\n - Есть ли более глубокие проблемы в архитектуре?\n\n2. **Побочные эффекты:**\n - Появились ли новые проблемы?\n - Нарушилась ли другая функциональность?\n - Есть ли конфликты с существующим кодом?\n\n3. **Недостающая информация:**\n - Что не было учтено?\n - Какие зависимости не были проанализированы?\n - Какие edge cases не были покрыты?\n\n4. **Специфика Workyy:**\n - Проблема с Yjs синхронизацией?\n - Проблема с executionStore?\n - Проблема с DAG зависимостями?\n - Проблема с выполнением узлов?\n\n### Шаг 4: Создание детального описания\n\n**Создай структурированное описание в следующем формате:**\n\n## Описание бага\n\n### Краткое резюме\n\n[1-2 предложения о сути проблемы]\n\n### Дефектное поведение\n\n**Что происходит:**\n\n- [Конкретное описание наблюдаемого поведения]\n- [Шаги воспроизведения]\n- [Условия, при которых возникает]\n\n**Ожидаемое поведение:**\n\n- [Как должно работать]\n\n**Фактическое поведение:**\n\n- [Что происходит на самом деле]\n\n### Воспроизведение\n\n**Шаги для воспроизведения:**\n\n1. [Шаг 1]\n2. [Шаг 2]\n3. [Шаг 3]\n\n**Условия воспроизведения:**\n\n- Окружение: [dev/prod/staging]\n- Браузер: [если применимо]\n- Версия: [если применимо]\n- Предварительные условия: [если есть]\n\n### Анализ попыток исправления\n\n**Попытка 1: [описание]**\n\n- Что было сделано: [конкретные изменения]\n- Файлы: [список файлов]\n- Почему не сработало: [анализ причин]\n- Результат: [что изменилось/не изменилось]\n\n**Попытка 2: [описание]**\n\n- [аналогично]\n\n**Попытка N: [описание]**\n\n- [аналогично]\n\n### Связанные файлы и элементы\n\n**Прямо связанные:**\n\n- `path/to/file1.ts` - [описание связи]\n- `path/to/file2.tsx` - [описание связи]\n\n**Косвенно связанные:**\n\n- `path/to/file3.ts` - [описание связи]\n- `path/to/file4.ts` - [описание связи]\n\n**Связанные компоненты системы:**\n\n- API endpoints: `/api/...` - [если применимо]\n- React компоненты: `ComponentName` - [если применимо]\n- Stores: `storeName` - [если применимо]\n- Сервисы: `serviceName` - [если применимо]\n- Типы: `TypeName` - [если применимо]\n\n### Корневая причина\n\n**Гипотезы о корневой причине:**\n\n1. [Гипотеза 1] - [обоснование]\n2. [Гипотеза 2] - [обоснование]\n3. [Гипотеза 3] - [обоснование]\n\n**Наиболее вероятная причина:**\n\n- [Описание наиболее вероятной корневой причины]\n- [Почему она наиболее вероятна]\n\n### Специфика Workyy\n\n**Связано ли с:**\n\n- [ ] Yjs реалтайм синхронизацией\n- [ ] Execution Store (Zustand)\n- [ ] DAG зависимостями узлов\n- [ ] Выполнением узлов (SQL/Python)\n- [ ] WebSocket соединением\n- [ ] Prisma/PostgreSQL\n- [ ] Next.js App Router\n- [ ] Другое: [описание]\n\n### Дополнительный контекст\n\n**Логи/ошибки:**\n\n```\n[Здесь цитаты ошибок из консоли/логов]\n```\n\n**Скриншоты/примеры:**\n[Если были упомянуты в чате]\n\n**Связанные issues/PR:**\n[Если были упомянуты]\n\n### Рекомендации для исправления\n\n**Предполагаемый подход:**\n\n- [Какой подход, вероятно, должен сработать]\n- [Что нужно учесть]\n- [Какие файлы нужно изменить]\n\n**Важные замечания:**\n\n- [Что нельзя упустить]\n- [Потенциальные побочные эффекты]\n- [Риски исправления]\n\n## Формат использования\n\n**Пользователь применяет команду в чате, где уже была попытка исправления:**\n\n```\n/describe-bug\n```\n\nКоманда автоматически анализирует всю историю чата и создает описание выше.\n\n**Или с дополнительным контекстом:**\n\n```\n/describe-bug\n\nДополнительный контекст:\n- Проблема возникла после последнего коммита\n- Воспроизводится только в Chrome\n- Связана с выполнением Python узлов\n```\n\n## Пример вывода\n\nПосле анализа чата команда выводит детальное описание в формате выше, которое затем можно использовать с командой `/fix-bug`:\n\n```\n/fix-bug\n\n[Вставь сюда описание бага, созданное командой describe-bug]\n```\n\n## Готов к анализу\n\nПроанализирую историю чата и создам детальное описание бага со всеми связанными файлами и элементами для последующего исправления.", "variables": [], "notes": "Анализирует контекст чата, определяет что было предпринято для исправления бага, объясняет почему это не сработало, и создает детальное описание проблемы с указанием всех связанных файлов и элементов.", "metadata": { "source": { "provider": "github-cursor-commands", "repository": "https://github.com/bogomolovf/workyy", "path": ".cursor/commands/tasks/describe-bug.md", "ref": "98a63d13177b70ac53857ed829cdc088d2014548", "url": "https://github.com/bogomolovf/workyy/blob/98a63d13177b70ac53857ed829cdc088d2014548/.cursor/commands/tasks/describe-bug.md", "key": "bogomolovf/workyy/.cursor/commands/tasks/describe-bug.md" } } }