# 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. Первый файл задает краткие правила по репозиторию, второй содержит более детальные требования к тону, фактам и формату вывода.