Как агент превращает выезд на участок в память проекта

После первого выезда на участок обычно привозишь не проект. Привозишь папку с жизнью участка.

Фотографии с телефона. Несколько ракурсов дома. Забор. Въезд. Хозблок. Деревья. Мокрые места. Места, где пока просто земля после стройки. Фото с угла, который потом никто не вспомнит. Замеры. Схему от руки. Анкету владельца. Пожелания. Сомнения. Фразу у забора: "Вот тут бы хорошо отдыхать." И всё это легко потерять. Не физически: файлы останутся. Теряется связь между ними.

На одной фотографии видно старый фундамент. В анкете владелец пишет, что хочет там зону отдыха. В замерах видно, что проход узкий. В первой AI-визуализации на этом месте уже появляется красивая площадка, но модель не знает, что рядом сыро и от дома туда неудобно ходить.

Вот для этого мы начали использовать агентов внутри папки проекта: не вместо проектировщика, не вместо выезда на участок, не вместо нормальных замеров. Как рабочую память объекта.

Начинаем с папки проекта

Когда появляется новый объект, мы не начинаем с красивых картинок. Сначала раскладываем материалы в структуру. Мы используем эту структуру как шаблон, который копируется под каждый новый проект. Это пока первая рабочая версия, мы её постоянно дорабатываем. Но уже сейчас она выглядит так:

project-name/
  00_project_admin/
  01_site_survey/
    01_photos_raw/
    02_photos_selected/
    03_video/
    04_measurement_notes/
  02_base_plan/
  03_client_context/
  04_ai_concepts/
  05_client_approval/
  06_design_documentation/
  07_estimate_and_phasing/
  08_final_visualization/
  09_delivery/
  90_prompt_library/
  99_project_logs/
  skills/

Статья про начало проекта, поэтому здесь важны только несколько первых стадий.

01_site_survey хранит сырой материал с выезда: фото, видео, заметки по замерам. Сырые фото лежат в 01_photos_raw как есть. Отобранные идут в 02_photos_selected. Файл PHOTO_INDEX.md описывает, что видно на каждом кадре.

02_base_plan — обмерный план: исходник из CAD, чистые экспорты, подложка для работы с AI.

03_client_context — бриф и анализ участка: как люди живут, чего хотят, чего не хотят, солнце, тень, влажность, уклон, соседи, видовые точки, проблемные места.

04_ai_concepts — первые AI-визуализации. Это не итоговый результат. Это стартовая проверка: входные данные уже есть, и мы пробуем увидеть несколько возможных направлений.

Дальнейшие стадии, от 05_client_approval до 09_delivery, отвечают за остальной рабочий процесс: согласование, документация, смета, финальные визуализации, сдача. Они часть того же шаблона, но за рамками этой статьи.

99_project_logs — рабочая память сессий: что сделано, что решено, что нужно знать тому, кто откроет папку следующим.

skills/ — локальные инструкции для агента. Каждый скилл — текстовый файл, который объясняет агенту, как работать с конкретной задачей: разбор фото, запуск проекта, генерация концепций и так далее.

На бумаге это выглядит как обычный порядок в папках. На практике это меняет начало проекта.

Фотографии перестают быть просто фотографиями

Сырые фото с участка полезны, пока кто-то ещё помнит, что на них снято. Через неделю один ракурс начинает путаться с другим. Через месяц открываешь папку и видишь "двор", "забор", "деревья", "дом". Деталь, которая на участке была очевидной, перестаёт быть очевидной.

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

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

Это ещё не финальная инвентаризация. Это первый индекс участка. В шаблоне он становится файлом 01_site_survey/PHOTO_INDEX.md. Проектировщик в любом случае проверяет всё своими глазами. Агент просто снимает часть механической работы: не надо каждый раз заново открывать двадцать фото и вспоминать, где что было.

Ценность — в сравнении слоёв

Полезно не то, что агент описывает фотографии. Полезно, когда он начинает сравнивать слои проекта между собой: фотографии говорят одно, замеры добавляют другое, анкета владельца — третье, первые AI-визуализации предлагают четвёртое.

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

Но на фото видно, что проход там и так узкий, а на схеме написано, что нужен техзаезд. Идея с посадкой, может, и хороша, но принимать её без проверки нельзя.

Другой пример: владелец хочет бассейн. На AI-визуализации он стоит аккуратно посередине участка. Выглядит убедительно. Но агент находит фото, на которых видно, что эта зона — главный маршрут от дома к хозблоку, а замеры показывают, что вокруг почти не остаётся места.

Это не значит, что бассейн невозможен. Это значит, что решение требует разговора, а не влюблённости в красивую картинку.

Почему мы не просим агента проектировать участок

Потому что он это сделает. И в этом проблема. Если дать агенту папку с фотографиями и попросить "предложить ландшафтное решение", он выдаст уверенный ответ. Иногда очень убедительный. Но уверенная формулировка не означает, что решение проверено.

Он может ошибиться в масштабе, принять строительный мусор за постоянный объект, не заметить важное дерево, не увидеть, что красивая дорожка на визуализации ломает реальный маршрут. Может предложить посадки там, где нужен проезд техники, люк, дренаж, заезд или просто нормальный проход.

Поэтому мы не запускаем агента как "проектировщика участка". Мы используем его как архивариуса, аналитика и внимательного помощника.

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

Первые AI-визуализации тоже становятся частью памяти

Ранние AI-визуализации не должны жить в отдельной вселенной. Это важно. Если визуализации в одной папке, фото участка в другой, замеры в третьей, а анкета владельца где-то в переписке, путаница начинается быстро.

Красивая картинка начинает восприниматься как реальность. Но читать её можно только вместе с исходным материалом. Поэтому мы складываем первые визуализации в 04_ai_concepts и просим агента оценить не "красиво или нет", а что в них сохранилось, что сломалось и что стоит использовать:

• что осталось близко к реальному участку;
• что изменилось случайно;
• какие идеи стоит развивать;
• какие идеи конфликтуют с замерами;
• какие идеи конфликтуют с анкетой владельца;
• где модель придумала лишнего;
• где всё-таки есть полезное направление.

Иногда вся картинка никуда не годится, но одна идея в ней ценная: дорожка, посадка вдоль забора, более открытый газон, зона отдыха, определённая плотность зелени. Это нормально. Мы не выбираем картинку как готовый проект. Мы вытаскиваем рабочие гипотезы и проверяем их на реальном участке.

Что должно появиться после первого прохода

После первого прохода агента папка проекта перестаёт ощущаться как куча разрозненных файлов. У неё появляется память. На старте у агента простая роль: собрать правильные вопросы, а не готовые ответы. Он может подготовить:

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

Хороший результат — это не "мы всё поняли". Скорее так: "Вот что уже известно. Вот что видно на фото. Вот чего хочет владелец. Вот где конфликт. Вот где не хватает данных. Вот решения, которые пока принимать рано."

В нашем шаблоне эти документы не складываются в одну отдельную папку. Они живут внутри тех стадий, к которым относятся:

01_site_survey/
  PHOTO_INDEX.md
03_client_context/
  BRIEF.md
  SITE_ANALYSIS.md
04_ai_concepts/
  GENERATION_LOG.md
  SHORTLIST.md
00_project_admin/
  PROJECT_CARD.md
  DECISIONS.md
99_project_logs/
  HANDOFF.md
  WORK_LOG.md
PROJECT_INDEX.md

PHOTO_INDEX.md помогает команде быстро найти нужный ракурс.

BRIEF.md превращает анкету в рабочие требования. SITE_ANALYSIS.md записывает то, что видно на участке: солнце, тень, маршруты, проблемные места.

GENERATION_LOG.md и SHORTLIST.md разбирают первые AI-визуализации и отслеживают, какие идеи выжили.

DECISIONS.md собирает подтверждённые решения. HANDOFF.md и WORK_LOG.md хранят контекст сессий, чтобы следующий человек или агент мог продолжить работу без пересборки всего с нуля.

PROJECT_INDEX.md показывает, на каком этапе сейчас проект.

Это пока не проектная документация. Это только стартовый слой. Но именно этот слой часто решает, начнётся ли следующий шаг с работы или с разговора, который открывается фразой: "А где было то фото дальнего угла участка?"

Как попробовать

Мы оформили этот рабочий процесс как публичный шаблон: landkit.

Это рабочий шаблон, а не отполированная система. Мы продолжаем его менять по мере того, как реальные проекты показывают, чего не хватает.

Начать можно с малого. Скопируйте шаблон. Положите туда материалы одного реального выезда: фото, замеры, анкету владельца, заметки, референсы, первые AI-визуализации, если они уже есть. Откройте папку в агенте, который умеет читать и редактировать файлы — Claude Code, Codex или другом инструменте того же класса.

Скажите агенту:

Мы начинаем новый ландшафтный проект. Прочитай START_HERE.md и помоги мне разобраться.