VIOLETTA — padrão de tarefas na era dos agentes de IA
Mnemônico: a tarefa deve ser verificável, integrada, observável, viva, executável, transferível, treinável e consciente — V I O L E T T A.
Materiais: vc.ru (RU) · Medium (EN)
Onde o skill é especialmente útil
Onde a tarefa não é um simples CRUD:
- Painéis administrativos / back-office — permissões, entidades, operações em massa, auditoria → Observable, Verifiable
- Processos de negócio, aprovações — cadeias, escalonamentos, mudança de contexto → Living, Transferable
- B2B, portais do cliente — integrações, SLA, contexto contratual → Integrated, Aware
- Sistemas internos (CRM, faturamento, suporte, dados) — handoff pessoas/agentes, incidentes → Transferable, Trainable, Executable
Uma tarefa para um agente é uma unidade de trabalho autônoma viva, não um ticket estático. Sem as propriedades abaixo, é mais uma nota do que uma tarefa nativa de IA.
Oito propriedades
| Letra | Propriedade | Essência |
|---|---|---|
| V | Verifiable (Verificável) | Critério de sucesso mensurável; pode ser verificado programaticamente ou por checklist |
| I | Integrated (Integrada) | Dados, API, ferramentas, formato de resultado — especificados explicitamente |
| O | Observable (Observável) | Status em tempo real + histórico de decisões (trilha de auditoria) |
| L | Living (Viva) | Atualizada conforme o contexto muda ou contexto estável explicitamente fixado |
| E | Executable (Executável) | Agente executa sem esclarecimentos; HITL apenas em pontos acordados |
| T | Transferable (Transferível) | Transferência para outro agente/pessoa sem perda de histórico e artefatos |
| T | Trainable (Treinável) | Falha → causa e lição registradas; próxima execução mais inteligente |
| A | Aware (Consciente) | Por que a tarefa, restrições, o que já foi tentado — dentro da tarefa |
Living e Trainable, por concepção da metodologia, dependem das capacidades de IA.
Checklist (ordem A → … → segundo T)
- A — Entenderá sem uma série de perguntas esclarecedoras?
- E — Pode executar automaticamente (com HITL acordado)?
- V — Está claro quando parar e o que é sucesso?
- O — O progresso e o rastro de ações estão visíveis?
- L — Como se atualiza com a mudança de contexto (ou o contexto é estável)?
- I — Sistemas, dados, ferramentas, formato de resultado?
- T Transferable — Outro executor assume sem briefing?
- T Trainable — Há algo a registrar após uma falha?
≥3 respostas "não" → melhorar a formulação ou marcar como spike/nota, não como tarefa de produção para agente.
Como responder (estrutura obrigatória)
- Formulação / revisão — tabela ou lista: para cada letra VIOLETTA, uma linha: "atendido / o que falta".
- Revisão de tarefa alheia — lacunas nas propriedades + correções específicas (critério, links, artefatos).
- Decomposição — cada subtarefa no mínimo E + V; contexto geral no pai (A).
Modelo de tarefa (copiar e colar)
## Tarefa (VIOLETTA)
**Aware — por que / contexto:**
**Verifiable — critério de prontidão:**
**Integrated — dados, sistemas, formato:**
**Observable — como o progresso e histórico são visíveis:**
**Executable — gatilho; HITL apenas se:**
**Living — o que fazer ao mudar prioridades/dados:**
**Transferable — o que transmitir ao próximo executor:**
**Trainable — o que registrar em caso de falha:**
Frases de gatilho
- "Check this task against VIOLETTA"
- "Formulate a VIOLETTA-compliant ticket"
- "Review this ticket for agent readiness"
- "Is this task AI-native?"
- "Проверь задачу по VIOLETTA"
- "Сформулируй тикет в стиле AI-native"
Exemplos de contraste
-
Fraco: "Melhore o onboarding."
-
Mais forte: "Conversão cadastro → primeira ação: 23% → 35% em 30 dias; funil em X; não mexer em pagamentos."
-
Fraco: "Prepare o relatório trimestral."
-
Mais forte: "Dados de [BI], template Y, enviar para Z até [data]; sem acesso → registrar na tarefa e parar (HITL)."
Exemplos avançados (painel admin, B2B, pipelines): examples.md no repositório (ao instalar apenas via curl o arquivo não está localmente — abra o link ou clone o repositório).
Antipadrões
- Um único verbo abstrato sem critério ("melhore", "otimize", "corrija").
- Referência a "documentação" sem caminho, versão ou seção específica.
- "Faça como o concorrente" sem artefato ou métrica de comparação.
- Sem limite de escopo (o que não está incluso na tarefa).
Limitações
- VIOLETTA é sobre qualidade da formulação, não substitui revisão de segurança, acessos e aprovação de riscos.
- Alterações massivas ou destrutivas em produção — apenas com permissão explícita e escopo conforme as regras do repositório.