Добавлено описание проекта, структура и требования к текстам в README.md; создан файл AGENTS.md с правилами работы и стандартами для агентов.
This commit is contained in:
ВяткинАртём
@@ -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.
|
||||||
@@ -1,2 +1,68 @@
|
|||||||
# sell-home
|
# 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. Первый файл задает краткие правила по репозиторию, второй содержит более детальные требования к тону, фактам и формату вывода.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user