Пишем промпт. Наконец-то!

Пишем промпт. Наконец-то!

(Продолжение, начало тут).

Базовое правило: чем подробнее промпт — тем точнее результат.

По сути именно здесь и происходит вся ваша работа, с остальным нейронки справятся самостоятельно.

Создаем спеку

Когда вы только начинаете проект, не стесняйтесь привлекать нейронку в помощь для написания промпта. Время, потраченное на этом этапе, сэкономит вам часы в перспективе.

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

Вообще агент в состоянии критиковать вас и самого себя, если его об этом попросить. Это важно явно указать в промпте, иначе он беспрекословно будет делать любую дичь или додумывать поведение (впрочем, нередко додумывает вполне даже удачно).

Рабочий вариант — добавить в конце промпта «Задай мне уточняющие вопросы до того, как перейдешь к реализации». Если вдруг нейронка задает вопрос, на который я сходу не могу ответить, иду сначала разбираться в Perplexity.

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

Добавляем фичи

После того как архитектура проекта создана и вы переходите к фичам, есть смысл их максимально декомпозировать.

На этом этапе отлично работают добавки в духе:
* Проверь сам себя, используй браузер
* Проведи подробный аудит безопасности
* Исправь ошибки линтера
* Актуализируй документацию и автотесты

А чтобы не писать это все руками каждый раз, есть rules — еще один близкий родственник скиллов.

Rules
Исторически рулы появились первыми и в дикой природе встречаются в разных вариациях от специфичных для конкретного агента (`CLAUDE.md` / `GEMINI.md`) и до целого стандарта https://agents.md/.

В них можно сформулировать ваши предпочтения и добавлять уточнения по мере того, как вы сталкиваетесь с косяками в работе агента.

У меня глобально написано такое:

* Если необходимо — задавай уточняющие вопросы
* По умолчанию используй Node.js и TypeScript. Если пользователь явно не попросил, не добавляй TS в зависимости — используй нативную возможность Node.js
* Используй ESLint
* Для написания стилей используй CSS по БЭМ-методологии
* Никогда не используй Tailwind
* Обязательно добавляй логи в релевантных местах, используй адекватный уровень логирования
* После правок актуализируй тесты и документацию
* После каждой задачи запускай линтеры и автотесты

Когда-то была практика создания «банков памяти», но они практически потеряли смысл с увеличением контекстного окна. Пусть агент пишет удобную для человека документацию и сам же ее читает при необходимости.

Поделитесь, для каких задач у вас так и не получилось добиться нужного результата от нейронок?

#vibe

@devspotting