violetta-ai-tasks

VIOLETTA — стандарт задачи в эпоху AI-агентов

Мнемоника: задача должна быть проверяемой, встроенной в системы, прозрачной, живой, исполнимой, передаваемой, обучаемой и осмысленной — V I O L E T T A.

Материалы: vc.ru (RU) · Medium (EN)

Где скилл особенно полезен

Там, где задача — не простой CRUD:

• Админки / back-office — права, сущности, массовые операции, аудит → Observable, Verifiable
• Бизнес-процессы, согласования — цепочки, эскалации, смена контекста → Living, Transferable
• B2B, кабинеты клиентов — интеграции, SLA, контрактный контекст → Integrated, Aware
• Внутренние системы (CRM, биллинг, поддержка, data) — handoff люди/агенты, инциденты → Transferable, Trainable, Executable

Задача для агента — живая автономная единица работы, а не статичный тикет. Без свойств ниже это скорее заметка, чем AI-native задача.

Восемь свойств

Буква	Свойство	Суть
V	Verifiable	Измеримый критерий успеха; можно проверить программно или по чек-листу
I	Integrated	Данные, API, инструменты, формат результата — указаны явно
O	Observable	Статус в реальном времени + история решений (audit trail)
L	Living	Обновляется при смене контекста или зафиксирован стабильный контекст явно
E	Executable	Агент выполняет без уточнений; HITL только в оговорённых точках
T	Transferable	Передача другому агенту/человеку без потери истории и артефактов
T	Trainable	Провал → зафиксированы причина и урок; следующий прогон умнее
A	Aware	Зачем задача, ограничения, что уже пробовали — внутри задачи

Living и Trainable по задумке методологии опираются на возможности AI.

Чеклист (порядок A → … → второй T)

• A — Поймёт без серии уточняющих вопросов?
• E — Может выполнить автоматически (с оговорённым HITL)?
• V — Ясно, когда остановиться и что успех?
• O — Виден прогресс и след действий?
• L — Как актуализируется при смене контекста (или контекст стабилен)?
• I — Системы, данные, инструменты, формат результата?
• T Transferable — Подхватит другой исполнитель без брифинга?
• T Trainable — Есть что записать после неудачи?

≥3 ответа «нет» → доработать формулировку или пометить как spike/заметку, не как production-задачу для агента.

Как отвечать (обязательная структура)

1. Постановка / ревью — таблица или список: по каждой букве VIOLETTA одна строка: «закрыто / чего не хватает».
2. Ревью чужой задачи — пробелы по свойствам + конкретные правки (критерий, ссылки, артефакты).
3. Декомпозиция — каждая подзадача минимум E + V; общий контекст в родителе (A).

Шаблон задачи (копипаст)

## Задача (VIOLETTA)
**Aware — зачем / контекст:**
**Verifiable — критерий готовности:**
**Integrated — данные, системы, формат:**
**Observable — как виден прогресс и история:**
**Executable — триггер; HITL только если:**
**Living — что делать при смене приоритетов/данных:**
**Transferable — что передать следующему исполнителю:**
**Trainable — что зафиксировать при неудаче:**

Trigger phrases

• "Check this task against VIOLETTA"
• "Formulate a VIOLETTA-compliant ticket"
• "Review this ticket for agent readiness"
• "Is this task AI-native?"
• "Проверь задачу по VIOLETTA"
• "Сформулируй тикет в стиле AI-native"

Примеры контраста

• Слабо: «Улучши онбординг».

• Сильнее: «Конверсия регистрация → первое действие: 23% → 35% за 30 дней; воронка в X; не трогать платежи».

• Слабо: «Подготовь квартальный отчёт».

• Сильнее: «Данные из [BI], шаблон Y, отправить на Z до [дата]; нет доступа → записать в задачу и стоп (HITL)».

Расширенные примеры (админка, B2B, пайплайны): examples.md в репозитории (при установке только через curl файла локально нет — откройте ссылку или клонируйте репозиторий).

Антипаттерны

• Один абстрактный глагол без критерия («улучши», «оптимизируй», «почини»).
• Ссылка на «доку» без пути, версии или конкретного раздела.
• «Сделай как у конкурента» без артефакта или метрики сравнения.
• Нет границы scope (что не входит в задачу).

Ограничения

• VIOLETTA про качество постановки, не заменяет security review, доступы и согласование рисков.
• Массовые или деструктивные изменения в прод — только с явным разрешением и scope по правилам репозитория.