Post #161

Эффективные промты — примеры и план внедрения [ Разбираем пример MVP‑сервиса с нуля (REST API)] Так. Увидел, что в опросе вы бы хотели получать почаще условные шаблоны промтов и внедрять их в работу И я услышал вас 🙌 Поэтому сейчас разберем пример MVP‑сервиса с нуля (REST API) Как обычно делают 90% разработчиков с AI? Задают плохой промпт: «Сгенерируй бэкенд для таск‑менеджера на Node.js + Postgres.» И как результат: рандомный стек, фиговая структура, никакой сборки/тестов. Как тогда должен выглядеть нормальный промт? 1️⃣ Cursor «Нужно сделать минимальный REST API для таск‑менеджера. Стек: Node 18, TypeScript, Fastify, PostgreSQL через pg. Предложи структуру проекта (папки/файлы) и список эндпоинтов. Пока код не пиши. После утверждения структуры создай файлы и каркас кода: src/server.ts — запуск сервера src/routes/tasks.ts — CRUD для задач src/db.ts — подключение к БД Добавь минимальные скрипты в package.json : dev , build , start . Напиши 2–3 примера curl‑запросов к API. Соблюдай TypeScript strict, не используй any.» И вот пошаговый план реализации в Cursor 👇 1. Контекст 2. Создать пустой проект / открыть репо. 3. Включить нужные файлы (или будущие пути) в Composer (можно оздать пустые файлы заранее). 4. Задать базовые правила в .cursorrules (TS strict, code style). 5. План → структура 6. В Ask кинуть промпт на предложить структуру и список эндпоинтов, без кода. 7. Отредактировать/утвердить список. 8. Генерация каркаса 9. Включить в Composer папку src и package.json. 10. Запустить Agent/Composer с тем же промптом, но с акцентом: «Теперь создай файлы и каркас кода по согласованной структуре…». 11. Просмотреть дифы, добавить/запустить npm run dev. 2️⃣ Claude Code «Нужно спроектировать и реализовать MVP REST API для таск‑менеджера. Стек: Node 18, TypeScript, Fastify, PostgreSQL ( pg ). Сначала проанализируй файлы в репозитории (если их нет — предложи минимальную структуру). Дай план: структура папок/файлов, список эндпоинтов, как подключаем БД и конфиги. После подтверждения плана создай каркас кода, не реализуя бизнес‑логику глубоко — только: – запуск сервера – CRUD для /tasks Подключение к Postgres через env‑переменные Добавь скрипты в package.json и инструкцию, как запустить npm install,npm run dev . Все изменения оформи в виде дифов и короткого changelog.» И вот пошаговый план реализации в Claude Code 👇 1. Контекст / CLAUDE.md 2. В CLAUDE.md прописать стек, стиль, команды сборки. 3. Запустить Claude Code в репо или в пустой папке. 4. Exploration → Plan 5. Попросить только план и структуру. 6. В VS Code extension включить Plan mode, отредактировать шаги. 7. Code → Commit 8. Дать команду реализовать только каркас по плану. 9. После дифов — запустить npm install + npm run dev , при необходимости попросить поправить конфиг/скрипты. 10. Закоммитить как «chore: scaffold task manager API». ➡️Рекомендую сохранить себе в «избранное» и поставить под этим постом — 🦄, чтобы ничего не забыть и обязательно попробовать