Задание 2. Заложи основу проекта

Прежде чем строить функции платформы, нужна основа, на которой их удобно строить и проверять: каркас приложения, проверки и CI. В этом задании ты впервые пройдёшь весь пайплайн разработки на понятной работе. Сначала идёт проектирование: вместе с агентом ты определишься с основными решениями по проекту, соберёшь их в одну спецификацию и разделишь её на задачи. Затем ты запишешь правила процесса, и каждая задача пройдёт реализацию, ревью и pull request до слияния. В главе 2 ты применишь тот же пайплайн к MVP (minimum viable product), первой версии платформы. Основа должна быть небольшой.

Что нужно сделать

1. Определись с основой проекта

С этого пункта начинается проектирование. Запусти grill-with-docs и пройди с агентом по списку:

• стек: язык, фреймворки бэкенда и фронтенда, база данных;

• архитектура: монолит, модульный монолит или отдельные сервисы; как модули будут обращаться друг к другу; как устроен код внутри модуля: по фичам (vertical slice), по слоям (clean architecture) или их сочетание;

• тесты: какие виды тестов будут и что покрываем обязательно;

• проверки: что ещё проверяем, например линтер и типы, и как запускаем проверки локально и в CI;

• секреты: как держать значения вне Git и подготовить пример настройки без секретов;

• запуск: как поднимаются проект и база, например через Docker Compose или локально;

• процесс: путь задачи до слияния и что агент согласует с тобой.

Принимай решения вместе с агентом: сравнивайте варианты и проверяйте свежие данные о технологиях.

Держи границы. На каждый вопрос списка хватит короткого ответа. Если агент уводит в детали будущих функций или предлагает сразу разделить платформу на модули, попроси отложить это до главы 2. В спецификации для этого есть раздел Out of Scope («вне рамок»). У каждого решения должна быть причина из брифа, из условий проекта или из твоего опыта, например бюджет, бесплатный тариф или язык, который ты знаешь. «Популярно» и «агент хорошо знает» причиной не считаются.

2. Собери решения в спецификацию основы и раздели её на задачи

Следующие шаги проектирования включают спецификацию и задачи. На всю основу нужна одна спецификация. Спецификацию собирает скилл to-spec из текущего разговора, поэтому запускай его в той же сессии, сразу после вопросов. В новой сессии разговора уже нет, и решения, которые не попали в файлы, потеряются. В шаблоне спецификации есть раздел историй пользователей. Для основы таких историй будет немного. Проверь, что в разделах Implementation Decisions и Testing Decisions есть все пункты списка, и попроси дописать, если чего-то нет. Затем to-tickets предложит, как разрезать работу на задачи. У каждой задачи должен быть результат, который можно проверить. Размер задачи зависит от её результата. Функции MVP в основу не входят. Одобри разбиение, и скилл опубликует задачи в Issues.

3. Запиши правила процесса

Проектирование закончено, дальше идёт реализация задач. Запиши в короткий файл путь задачи до слияния, правило отдельной рабочей копии и ветки от свежего main, коммит до ревью, исправление замечаний, повторное ревью и запись исходов в pull request. Назови, что агент делает только с твоего подтверждения. Пример правил показывает, как дополнить готовые скиллы. Пиши только то, о чём набор молчит, скиллы не пересказывай. Правило рабочих копий действует с первой задачи: в основной папке на main агент только читает, обсуждает и планирует. Документы проектирования, которые появились до первой задачи, можно закоммитить в main; способ выбери с агентом. В AGENTS.md оставь указатель на правила. Правила кода лежат отдельно.

4. Реализуй основу по задачам

Последние шаги пайплайна включают реализацию, ревью и pull request. Веди задачи по одной, каждую в новой сессии и своей рабочей копии. Запусти скилл implement, назови задачу и попроси провести её по правилам процесса до pull request. Скилл implement в конце сам запускает ревью скиллом code-review. Оно идёт с двух сторон: два отдельных агента с чистым контекстом сверяют код с правилами проекта и со спецификацией. Посмотри результат, слей pull request и только потом бери следующую задачу. Когда все задачи слиты, должно работать следующее:

• каркас: приложение, в котором есть все выбранные технологии: интерфейс, сервер и база, но ещё нет функций для пользователя; один запрос проходит интерфейс, сервер и базу, а схему базы создают миграции; код разложен по архитектуре из спецификации;

• проверки: тесты и другие проверки, о которых вы договорились, падают при ошибке; агент знает, как их запустить, а CI запускает те же проверки на каждый pull request; после появления файла CI pull request сливается только с зелёным CI; удобнее собрать выбранные проверки в одну команду;

• секреты: значения находятся вне Git, а в репозитории есть пример настройки без секретных значений, например .env.example;

• запись прогона: агент запустил каркас с нуля по инструкции из репозитория и записал в pull request коммит, действие и что увидел.

5. Проверь, что новая сессия знает, как работать дальше

Новая сессия должна без подсказок из чата найти, как запустить и проверить проект, правила процесса и следующий шаг. Заведи с агентом задачу на следующий шаг, проектирование аккаунтов сотрудников. Потом открой новую сессию и спроси, как запустить проект, как его проверить и что делать дальше.

6. Закрепи правило процесса механизмом · по желанию

Закрепи правило рабочих копий или зелёный CI механизмом: git-хуком, защитой ветки или hook агента. Назови механизм в правилах процесса. Хук можно обойти, а защиту выключить, если у агента есть такие права.

7. Сделай ревью другой моделью · по желанию

Другая модель может заметить ошибки, которые пропустил исполнитель. Выбери для ревью модель, отличную от модели исполнителя. Можно открыть другого агента, если в нём выбрана другая модель. Запиши в ревью обе модели.

Что решаешь сам

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

Сдать

Когда всё готово, нажми «Сдать» на этой странице и передай своему агенту фразу с кодом задания aie-ch1-foundation. Агент проверит проект по пунктам выше и покажет отчёт до отправки.

• Как устроен пайплайн разработки с агентом

• Какие файлы нужны агенту

• Как устроено приложение

• Команда проверки и CI

• Ревью и завершение задачи

• Бриф заказчика