🧰 ai-toolkit
Ferramentas, skills e prompts para desenvolvimento de software com IA — construídos para uso real em projetos de produção.
O que é este repositório
Repositório público onde centralizo as ferramentas de IA que crio e uso no dia a dia como engenheira de software. O foco é tornar o desenvolvimento com agentes de IA mais confiável, estruturado e reproduzível — não apenas mais rápido.
Cada ferramenta aqui nasceu de um problema real: como garantir que um agente de IA produza software que realmente funcione em produção, com arquitetura limpa, testes, documentação e processo de entrega rastreável?
📁 Conteúdo
skills/ — AI Agent Skills
Skills no padrão agentskills.io, compatíveis com Claude Code, GitHub Copilot CLI, Codex, Gemini CLI, Cursor e outros agentes.
| Skill | Descrição |
|---|
| harness-engineering | Pipeline completo de desenvolvimento com IA em 10 etapas (orquestrador + sub-skills), incluindo interface/design system quando houver UI |
→ Documentação completa das skills em skills/README.md
💡 Filosofia
"O gargalo nunca foi a capacidade do agente de escrever código — foi a falta de estrutura, ferramentas e mecanismos de feedback ao seu redor."
— OpenAI Engineering Blog, 2026
Acredito que o maior ganho com IA no desenvolvimento não vem de substituir o engenheiro, mas de amplificar boas práticas de engenharia com automação inteligente. As ferramentas aqui refletem isso:
- Guias (feedforward): contexto certo antes de agir — PRD, arquitetura, interface/design system, convenções codificadas
- Sensores (feedback): detecção automática de problemas — testes, linters, type check, code review por IA
- Rastreabilidade:
RF-01 → US-01 → CA-01 → T-01 → teste — nada cai entre as rachaduras
- Steering loop: cada erro recorrente vira uma regra no harness — o sistema melhora a cada ciclo
- Interface antes das tasks: quando há UI,
harness-interface define design system, logo, mockups e assets; se o UX mudar contratos, a arquitetura é revista antes do breakdown
🔄 Sincronizar skills instaladas
Após puxar atualizações deste repo, publique as skills no diretório do agente:
./scripts/sync-agents-skills.sh
# destino padrão: ~/.agents/skills/
# Windows: C:\Users\thaif\.agents\skills\ → .\scripts\sync-agents-skills.ps1
Se precisar publicar no GitHub thaifurforo/ai-toolkit a partir dos artefatos desta sessão, veja sync-artifacts/PUSH_AND_SYNC.md (patch + bundle da branch cursor/harness-interface-58ef).
🛠️ Stack de referência
As skills e ferramentas são projetadas para funcionar com qualquer stack, mas a autora usa principalmente:
TypeScript · .NET/C# · React · PostgreSQL · GitHub Actions · Docker · Google Cloud Run
🤝 Contribuições
Este é um repositório pessoal, mas PRs com melhorias, correções ou novas skills são bem-vindos. Abra uma issue descrevendo o que você quer adicionar antes de implementar.
👤 Autora
Thainara Furforo — Engenheira de Software com foco em backend (.NET/C#, TypeScript) e arquitetura de sistemas.
MIT License · Feito com 🍫 e muito git commit
