Skip to content

Instantly share code, notes, and snippets.

@OliveiraCleidson
Last active March 6, 2026 12:31
Show Gist options
  • Select an option

  • Save OliveiraCleidson/ce8d0c3ccdab0d99ce3df42e47fe7228 to your computer and use it in GitHub Desktop.

Select an option

Save OliveiraCleidson/ce8d0c3ccdab0d99ce3df42e47fe7228 to your computer and use it in GitHub Desktop.
Framework TATO, how to work with AI Code Agent
tags
mental-frameworks

Framework TATO

Tarefas Atômicas, Testadas e Organizadas

"Ir com TATO: Construir com sensibilidade, controle e precisão."


🚀 Elevator Pitch

"Para desenvolvedores que buscam produtividade com IA sem perder o controle da qualidade, o TATO é um método de execução que organiza o trabalho em Tarefas Atômicas, Testadas e Organizadas. Diferente da "geração de código" desordenada, ele garante que a IA atue como um braço técnico preciso sob arquitetura humana, eliminando alucinações críticas e retrabalho."


📖 O Contexto (SCQA)

Situação

Desenvolvedores têm hoje acesso a Agentes de IA poderosos capazes de gerar código, testes e documentação em segundos.

Complicação

Esses agentes sofrem de "alucinação", perda de contexto em tarefas grandes e falta de visão sistêmica. Delegar a eles tarefas complexas ("faça o site") resulta em código superficial, inseguro e difícil de manter, transformando o ganho de produtividade em tempo perdido com debugging.

Questão

Como utilizar a potência da IA para acelerar o desenvolvimento sem perder o controle da arquitetura e a qualidade da engenharia de software?

Resposta

Aplicando o Método TATO. Uma abordagem que inverte o papel: o humano arquiteta e valida, a IA executa apenas tarefas atômicas e testáveis.


O método TATO é uma abordagem de engenharia de software desenhada para maximizar a eficiência de Agentes de IA (LLMs) enquanto mitiga seus riscos (alucinação, código inseguro, perda de contexto).

A filosofia central é que o Humano é o Arquiteto e Juiz, enquanto a IA é o Braço Técnico e Consultor. Nunca se delega o "todo", apenas partes indivisíveis e verificáveis.


🏗️ Os 4 Pilares do TATO

1. Tarefas Atômicas (Atomicidade)

A IA nunca deve receber um projeto inteiro. O escopo deve ser quebrado até que se torne "atômico" — uma unidade indivisível de trabalho que pode ser completada e verificada isoladamente.

  • Errado: "Crie um sistema de e-commerce." (Muito amplo, propenso a erro).
  • Certo: "Crie uma migration para a tabela de produtos com os campos X, Y, Z." (Atômico, binário: funciona ou não).

2. Arquitetura Humana (Controle)

O design, a escolha de tecnologias e a estrutura das pastas são definidos pelo humano.

  • Papel da IA: Atuar como consultora ("Quais as opções de mercado?"), mas nunca como decisora final.
  • Benefício: Evita "drift" arquitetural onde o projeto vira uma colcha de retalhos de padrões diferentes trazidos pela pela IA.

3. Testados Extensivamente (Conformidade)

Se não tem teste, não existe. A IA deve ser instruída a criar códigos que "provocam" o desacoplamento.

  • Testes Unitários: Forçam design limpo e funções puras.
  • Testes de Integração: Validam bibliotecas (ex: DynamoDB, Nats) e I/O real.
  • Mocks e POCs: Apps "fake" (Svelte/Vite) criados apenas para validar contratos de API ou UX antes da implementação real.

4. Organização Auditável (Processo)

O trabalho é feito em fases rígidas com portões de qualidade (Quality Gates).

  • Faseamento: Setup -> Infra -> Domain -> API.
  • O Juiz: A IA deve ser solicitada a atuar como revisora do próprio código ("Aja como um Senior Staff Engineer e aponte falhas de segurança neste código que você acabou de gerar").

🔄 O Ciclo de Vida TATO

  1. Definição (Humano): Você define o objetivo da Task Atômica.
  2. Estratégia (Humano + IA Consultora): Você pede opções, a IA sugere, você decide.
  3. Execução (IA Braço Técnico): A IA implementa o código isolado.
  4. Verificação (IA Juiz + Testes):
    • Testes automatizados rodam.
    • IA faz auto-crítica.
    • Humano audita visualmente.
  5. Integração (Humano): O código aprovado é commitado e o ciclo reinicia.

💡 Exemplos de Aplicação

Contexto Abordagem Tradicional (Arriscada) Abordagem TATO (Segura)
Banco de Dados "Faça o banco do app." Task 1: Setup Docker. Task 2: Migration Tabela Users. Task 3: Teste de Conexão.
Frontend "Faça a dashboard." Task 1: Configurar Vite+Tailwind. Task 2: Componente Card isolado. Task 3: Teste visual no Storybook.
Integração "Integre com a API do Stripe." Task 1: Criar Interface/Contrato. Task 2: Criar Mock Server. Task 3: Teste de Integração contra o Mock.

Veja Também

  • [[TATO - Checklists|Checklists Práticos do TATO]]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
tags
mental-frameworks

✅ TATO: Guia Rápido & Checklists

Ferramenta de apoio para aplicação prática do Framework.

Use estes checklists para garantir conformidade em cada etapa do seu ciclo de desenvolvimento com IA.


0. 🏗️ Pré-requisitos (Health Check)

O Framework TATO funciona melhor se a "casa estiver arrumada". Garanta isso antes de começar:

  • Linter & Formatter Instalados?
    • Ex: Eslint/Prettier (JS), Ruff (Python), GoFmt (Go).
    • Por que: Evita que você gaste tempo discutindo estilo de código com a IA.
  • Ambiente Local Reprodutível?
    • Ex: Docker configurado ou gerenciador de versão (asdf/nvm).
    • Por que: Se você não consegue rodar, não consegue validar as entregas da IA.
  • Framework de Testes Configurado?
    • Ex: Jest, Pytest, Go testing.
    • Por que: Sem runner de teste, o pilar "Testado" do TATO é impossível.
  • Gestão de Dependências e Secrets?
    • Ex: package-lock.json, .gitignore e .env.example.
    • Por que: Garante que a IA não quebre versões ou vaze segredos.

1. 🚦 Checklist de Definição (Human Only)

Antes de abrir o chat com a IA:

  • A tarefa é Atômica?
    • Pergunta: Se eu falhar, perdi apenas minutos ou horas?
    • Meta: O escopo deve ser completável em uma única interação ou arquivo.
  • O Output é Binário?
    • Meta: Devo conseguir dizer "Funciona" ou "Não Funciona" sem ambiguidade.
  • A Arquitetura está definida?
    • Meta: Eu já sei quais bibliotecas e estrutura de pastas desejo usar.

2. 🤖 Checklist de Execução (AI Interaction)

Durante o prompt e geração de código:

  • Pedi Opções antes de Código?
    • Ação: "Liste 3 estratégias para resolver isso antes de implementar."
  • Restringi o Escopo no Prompt?
    • Ação: "Implemente APENAS a função de conexão, sem a lógica de negócio ainda."
  • Solicitei "Testabilidade"?
    • Ação: "Crie o código de forma desacoplada para facilitar testes unitários."

3. ⚖️ Checklist de Auditoria (The Judge)

Antes de aceitar e commitar:

  • O código foi "Julgado"?
    • Ação: Peça à IA: "Atue como Senior Staff e critique este código procurando bugs ou falhas de segurança."
  • Existe um Teste "Prova de Vida"?
    • Meta: Pelo menos um teste unitário ou de integração que falha se a lógica quebrar.
  • A UX/Contrato foi validada?
    • Meta: Se for visual ou API, rodei localmente (Mock/POC) e vi funcionando?
  • Limpeza: Removi comentários desnecessários ou código morto gerado pela IA?
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment