skills/pt-br/tao-onboarding/SKILL.md
Guia novos usuários pelo setup do TAO, conceitos e primeira execução. Use quando alguém perguntar sobre o TAO, como começar, ou precisar de ajuda com o workflow.
npx skillsauth add andretauan/tao tao-onboardingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use quando alguém é novo no TAO, pergunta como funciona, ou precisa configurar seu primeiro projeto.
TAO (Trace · Align · Operate) é um framework de desenvolvimento AI-nativo que organiza a codificação com agentes de IA em três camadas:
| Arquivo | Propósito |
|---------|-----------|
| CLAUDE.md | Identidade do projeto + padrões de código (raiz) |
| .github/tao/tao.config.json | Fonte única de verdade para config |
| .github/tao/CONTEXT.md | Estado atual — fase ativa, decisões |
| .github/tao/CHANGELOG.md | Histórico — o que mudou, quando, por quem |
| .github/tao/RULES.md | Regras do framework (R0-R7) |
| .github/skills/INDEX.md | Catálogo de skills (se existir) |
| .github/agents/*.agent.md | Definições dos agentes |
.github/tao/tao.config.json — personalize modelos, caminhos, lintCLAUDE.md — adicione regras e padrões de código do projeto.github/tao/CONTEXT.mdchat.useCustomAgentHooks nas Configurações do VS Code@Executar-Tao e diga "executar"@Executar-Tao → lê CONTEXT.md → encontra fase ativa
→ lê PLAN.md → pega próxima tarefa
→ roteia para modelo certo (Sonnet/Opus/GPT-4.1)
→ executa tarefa → roda lint → atualiza CONTEXT.md
→ commita → pega próxima tarefa → repete
| Agente | Quando usar |
|--------|-------------|
| @Executar-Tao | Loop de execução autônomo completo |
| @Brainstorm-Wu | Planejamento, ideação, análise de trade-offs |
| @Investigar-Shen | Debug complexo, decisões de arquitetura, auditorias de segurança |
testing
Estratégia de pirâmide de testes com análise de cobertura, identificação de edge cases e planejamento de testes. Use ao planejar testes, melhorar cobertura, identificar edge cases ou escrever especificações de teste.
development
Auditoria de segurança alinhada ao OWASP Top 10 com checklist para injection, XSS, autenticação, autorização, gestão de secrets e vulnerabilidades comuns. Use ao auditar segurança, revisar código de auth ou hardening de aplicação.
development
Metodologia de refatoração segura com detecção de code smells, transformação passo-a-passo e prevenção de regressão. Use ao refatorar código, reduzir dívida técnica ou melhorar estrutura.
testing
Decomposição expert de tarefas para criar PLAN.md no TAO. Quebra features em fases e tarefas com critérios de aceite, estimativas e dependências. Use ao planejar trabalho, criar fases ou decompor features.