Добавлено описание проекта, структура и требования к текстам в README.md; создан файл AGENTS.md с правилами работы и стандартами для агентов.

README.md

@@ -1,2 +1,68 @@
 # sell-home
 
+Репозиторий для подготовки и улучшения объявлений о продаже загородной недвижимости на основе разрозненных заметок собственника.
+
+Проект превращает факты из папки draft в готовые тексты для публикации в Avito и CIAN, а также хранит финальные варианты в папке result.
+
+## Что делает проект
+
+- собирает исходные заметки о доме, участке, коммуникациях, окружении и условиях сделки;
+- консолидирует их в единое описание объекта;
+- создает несколько стилистических вариантов продающего текста;
+- позволяет выбрать лучший вариант и подготовить усиленную финальную версию.
+
+## Структура
+
+- draft/ — исходные заметки и черновые факты об объекте;
+- result/ — готовые тексты объявлений;
+- .github/copilot-instructions.md — правила работы агента в этом репозитории;
+- .github/agents/ — специализированные режимы для генерации и ревью объявлений;
+- .github/skills/ — прикладные навыки для консолидации фактов, написания текста и экспорта результата.
+
+## Текущий workflow
+
+1. Прочитать все релевантные материалы в draft/.
+2. Собрать проверенные факты в целостную картину объекта.
+3. Отделить подтвержденные сведения от мягких маркетинговых интерпретаций.
+4. Подготовить три версии объявления:
+	- aggressive;
+	- calm;
+	- classic.
+5. При необходимости сравнить варианты, выбрать лучший базовый текст и сделать усиленную версию best.
+6. Сохранить итоговые файлы в result/ в обычном текстовом формате.
+
+## Требования к текстам
+
+- язык публикации — русский;
+- голос — от лица собственника, а не агентства;
+- подача — конкретная, теплая, честная, без пустых брокерских штампов;
+- допускаются только те преимущества, которые опираются на исходные заметки;
+- нельзя придумывать характеристики, расстояния, юридические детали или состояние объекта.
+
+## Именование файлов
+
+Рекомендуемый формат имени:
+
+location-object-type-variant.txt
+
+Пример:
+
+plaskinino-snt-utenok-house-best.txt
+
+Если файл с нужным именем уже существует, следует создавать версию с новым суффиксом, а не перезаписывать результат молча.
+
+## Что уже есть в репозитории
+
+В result/ уже лежат четыре варианта объявления по одному объекту:
+
+- aggressive;
+- calm;
+- classic;
+- best.
+
+Это удобно использовать как образец структуры, тона и степени конкретики для следующих объектов.
+
+## Для работы с AI-агентами
+
+Если вы используете Copilot или другого агента внутри редактора, ориентируйтесь на инструкции из AGENTS.md и .github/copilot-instructions.md. Первый файл задает краткие правила по репозиторию, второй содержит более детальные требования к тону, фактам и формату вывода.
+