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

AGENTS.md

@@ -0,0 +1,83 @@
+# AGENTS
+
+## Purpose
+
+This repository is used to turn fragmented owner notes about a residential property into publication-ready Russian sale listings.
+
+Agents working here should optimize for factual accuracy, clear buyer appeal, owner-like tone, and fast export of final texts into result/.
+
+## Source Of Truth
+
+- draft/ contains the primary property facts;
+- result/ contains generated and reviewed listing variants;
+- .github/copilot-instructions.md contains the detailed workspace rules;
+- .github/agents/ contains specialized agent modes for drafting and reviewing listings;
+- .github/skills/ contains reusable workflow instructions.
+
+If there is any conflict, prefer explicit facts from draft/ over marketing wording from generated files.
+
+## Core Workflow
+
+1. Read all relevant files in draft/ before writing or reviewing anything.
+2. Consolidate the property into one coherent object unless the notes clearly describe multiple different properties.
+3. Separate information into three buckets:
+   - verified facts;
+   - soft interpretations grounded in facts;
+   - open questions or contradictions.
+4. Write or improve listing text only from supported information.
+5. Save publication-ready plain text outputs in result/.
+
+## Writing Rules
+
+- Write final listing outputs in Russian.
+- Use the owner's perspective, not an agency voice.
+- Favor concrete specifics over generic praise.
+- Keep the copy readable on Avito and CIAN without special formatting.
+- Avoid inventing distances, legal claims, renovation details, infrastructure, or technical specs.
+- Avoid stale real-estate cliches unless the wording is strongly justified by the object.
+
+## Expected Outputs
+
+For a normal generation task, create three versions:
+
+- aggressive;
+- calm;
+- classic.
+
+For a review-and-optimization task, compare variants, choose the strongest one, and create an improved best version if the task requires it.
+
+## Review Standard
+
+When reviewing listing quality, evaluate:
+
+- opening hook;
+- clarity of the offer;
+- specificity;
+- buyer lifestyle appeal;
+- trust and honesty;
+- differentiation;
+- objection handling;
+- scanability;
+- call to action;
+- expected response potential.
+
+## File Naming
+
+Use Latin slug filenames based on location and object type.
+
+Recommended pattern:
+
+location-object-type-variant.txt
+
+If a target filename already exists, create a versioned alternative instead of overwriting it silently.
+
+## Editing Policy
+
+- Keep edits minimal and task-focused.
+- Do not rewrite strong source material without a reason.
+- Do not remove factual caveats that improve trust.
+- Distinguish copy problems from source-information gaps.
+
+## Practical Rule
+
+The best listing in this repository is not the most emotional one. It is the one that makes a buyer quickly understand the object, trust the owner, imagine living there, and feel ready to message or call.

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