Из чего состоит production-ready промпт для Codex

Хороший prompt для Codex — это не просьба «сделай фичу». Это короткий контракт между человеком и агентом. В нем должно быть достаточно контекста, чтобы агент принял правильные инженерные решения, и достаточно ограничений, чтобы он не изменил полпроекта. Особенно это важно в Grand Service, где рядом живут Funding, Points, Scanner, Polymarket surfaces и Academy.

Плохой пример выглядит так: «Сделай AI Academy». Агент может понять это как задачу на LMS, MDX engine, database schema, админку, AI Tutor, поиск и визуальный редизайн. Улучшенный вариант звучит иначе: «Сделай Phase 1 MVP AI Academy как feature-модуль в текущем Next.js app: один курс, локальный typed content, страницы overview/course/lesson, progress action, Continue Learning; не трогать Scanner, Docker, auth и persistence infrastructure».

Структура сильного задания

1. 1
   Context

   Опиши проект и место feature внутри него. Например: Grand Service — единый Next.js App Router проект с feature-модулями в `src/features/*`.

2. 2
   Goal

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

3. 3
   Scope и out of scope

   Напиши, какие файлы можно менять, а какие нельзя. Отдельно укажи соседние modules, Docker и auth.

4. 4
   Quality bar

   Определи, что считается готовностью: typecheck, lint, tests, build, HTTP smoke, mutation smoke.

5. 5
   Final report

   Попроси агента перечислить решения, файлы, проверки, ограничения и production gaps.

# Context
Grand Service is one Next.js App Router project.

# Goal
Build one vertical slice of AI Academy.

# Scope
src/features/ai-academy
src/app/academy

# Out of scope
Scanner, Docker, auth, database stack.

# Validation
tsc, lint, tests, build, route smoke, mutation smoke.

Обрати внимание: хороший prompt не обязан быть огромным. Он обязан быть точным. Если в нем есть контекст, границы и проверка, Codex может сам изучить код и выбрать локальные паттерны. Если этого нет, агент начинает компенсировать неизвестность фантазией.