From 6e601fe994774c4bb283d93d8d7d120f487fe147 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=92=D1=8F=D1=82=D0=BA=D0=B8=D0=BD=D0=90=D1=80=D1=82?= =?UTF-8?q?=D1=91=D0=BC?= Date: Tue, 19 May 2026 17:45:21 +0300 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?= =?UTF-8?q?=D0=BD=D0=BE=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D0=B5?= =?UTF-8?q?=20=D0=BF=D1=80=D0=BE=D0=B5=D0=BA=D1=82=D0=B0,=20=D1=81=D1=82?= =?UTF-8?q?=D1=80=D1=83=D0=BA=D1=82=D1=83=D1=80=D0=B0=20=D0=B8=20=D1=82?= =?UTF-8?q?=D1=80=D0=B5=D0=B1=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F=20=D0=BA?= =?UTF-8?q?=20=D1=82=D0=B5=D0=BA=D1=81=D1=82=D0=B0=D0=BC=20=D0=B2=20README?= =?UTF-8?q?.md;=20=D1=81=D0=BE=D0=B7=D0=B4=D0=B0=D0=BD=20=D1=84=D0=B0?= =?UTF-8?q?=D0=B9=D0=BB=20AGENTS.md=20=D1=81=20=D0=BF=D1=80=D0=B0=D0=B2?= =?UTF-8?q?=D0=B8=D0=BB=D0=B0=D0=BC=D0=B8=20=D1=80=D0=B0=D0=B1=D0=BE=D1=82?= =?UTF-8?q?=D1=8B=20=D0=B8=20=D1=81=D1=82=D0=B0=D0=BD=D0=B4=D0=B0=D1=80?= =?UTF-8?q?=D1=82=D0=B0=D0=BC=D0=B8=20=D0=B4=D0=BB=D1=8F=20=D0=B0=D0=B3?= =?UTF-8?q?=D0=B5=D0=BD=D1=82=D0=BE=D0=B2.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 83 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 66 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 149 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..ff592e9 --- /dev/null +++ b/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. \ No newline at end of file diff --git a/README.md b/README.md index af4fabc..7d7ca2d 100644 --- a/README.md +++ b/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. Первый файл задает краткие правила по репозиторию, второй содержит более детальные требования к тону, фактам и формату вывода. +