faf-wizard
Cria automaticamente um arquivo .faf para seu projeto. Ele detecta as tecnologias, avalia a prontidão para IA e funciona em qualquer projeto. É uma forma rápida de preparar seu projeto para IA.
O que ela faz
O FAF Wizard ajuda a inteligência artificial a entender seus projetos de programação. Ele analisa seu código e cria um "resumo" especial para a IA, tornando mais fácil para ela te ajudar a construir ou consertar o projeto.
Quando usar
- ✓Ao começar um novo projeto e querer que a IA ajude desde o início.
- ✓Ao trabalhar em um projeto antigo e a IA ter dificuldade em entender.
- ✓Ao compartilhar um projeto com outras pessoas ou ferramentas de IA.
Exemplo do que pedir para a IA
“Transforme meu projeto de código em um contexto inteligente para IA.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Ele escaneia seu projeto, identifica as tecnologias usadas e cria um arquivo de configuração. Esse arquivo é como um mapa para a IA entender a estrutura e o objetivo do seu código.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill faf-wizardOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/faf-wizard/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
FAF Wizard - Inteligência de IA com Um Clique
A equipe de apoio para seus projetos. Aponte para qualquer base de código e obtenha contexto pontuado e pronto para IA em 60 segundos.
Transforme qualquer projeto - novo, legado, OSS famoso ou projetos paralelos esquecidos - em um espaço de trabalho inteligente para IA com contexto persistente que funciona em todas as ferramentas de IA.
O Problema Que Ele Resolve
Até o React.js pontua 0% de prontidão para IA. Repositórios famosos não têm contexto de IA.
| O Que Existe | O Que Diz à IA |
|---|---|
| README.md | "O que isso faz" (para humanos) |
| docs/ | "Como usar" (para humanos) |
| project.faf | "Como ajudar a construir isso" (para IA) |
A documentação diz aos humanos como usar seu código. O contexto de IA diz à IA como ajudar você a construí-lo. São coisas completamente diferentes.
Funciona em QUALQUER Projeto
| Tipo de Projeto | O Que o FAF Wizard Faz |
|---|---|
| Novíssimo | Contexto de IA perfeito desde a primeira linha |
| Pesadelo legado | A IA finalmente entende a arqueologia |
| OSS Famoso | Nem o React tem isso |
| Projetos Paralelos | Pare de reexplicar a cada sessão |
| Entregas para Clientes | Contexto portátil para qualquer ferramenta de IA |
| Projetos em Equipe | Contexto compartilhado que todos podem usar |
Histórias de Sucesso Reais
Antes/Depois: Plataforma de E-commerce Legada
Before: "This 50k-line PHP codebase from 2015..."
AI: "I don't understand this architecture"
After: 60 seconds with FAF Wizard
AI: "I see this is a Laravel-based e-commerce system with
payment processing, inventory management, and multi-tenant
architecture. Here's how I can help..."
Antes/Depois: Aplicativo React Moderno
Before: Every AI session starts with context explanation
Time lost: 5-10 minutes per session
After: project.faf exists
AI: Instant understanding, productive from message one
Time saved: 2+ hours per day
O Fluxo de Trabalho de 60 Segundos
Etapa 1: Detecção (10 segundos)
faf auto
# Scans manifest files, directory structure, dependencies
# Detects: React + TypeScript + Tailwind + Vercel
Etapa 2: Geração (30 segundos)
# Auto-generated project.faf
project:
name: my-saas-dashboard
goal: Customer analytics platform
stack:
frontend: react-18
css: tailwind
deployment: vercel
human_context:
who: Solo founder
what: SaaS analytics dashboard
why: Customer insights for small businesses
Etapa 3: Pontuação e Relatório (20 segundos)
✅ Generated: project.faf
🏆 AI-Readiness: 87% Bronze - Production ready
Filled: 9/11 active slots
Ignored: 22 slots (not applicable)
To reach Silver (95%):
+ Add API documentation (+5%)
+ Define deployment details (+3%)
Dados de Desempenho (Números Reais)
Analisados mais de 8.400 Projetos:
- ✅ 99,2% de precisão na detecção em mais de 153 formatos
- ✅ Tempo médio de geração: 12,3 segundos
- ✅ Nível Bronze ou superior: 94% dos projetos
- ✅ Zero configuração manual: Funciona direto da caixa
Suporte a Formatos
Detecta e configura automaticamente:
- JavaScript: React, Vue, Angular, Svelte, Next.js, Nuxt
- Python: Django, Flask, FastAPI, Jupyter, Poetry
- TypeScript: Todos os frameworks JS + projetos TS nativos
- Rust: Projetos Cargo, ferramentas CLI, servidores web
- Go: Módulos, Docker, microsserviços
- Java: Maven, Gradle, Spring Boot
- +147 formatos adicionais
Compatibilidade Universal
Funciona Com Todas as Ferramentas de IA
- ✅ Claude Code - Lê .faf nativamente
- ✅ Cursor - Sincroniza automaticamente com .cursorrules
- ✅ Gemini CLI - Converte para GEMINI.md
- ✅ Windsurf - Sincroniza com .windsurfrules
- ✅ ChatGPT - Formato YAML legível
- ✅ Qualquer IA - Suporte a formato universal
Suporte à Migração
Já possui arquivos de contexto de IA?
# Migrates existing context
faf migrate --from .cursorrules
faf migrate --from CLAUDE.md
faf migrate --from README.md
# One format, works everywhere
faf sync --target all
Opções de Instalação
Opção 1: CLI (Recomendado)
npm install -g faf-cli
cd your-project
faf auto
Opção 2: Servidor MCP (Claude Code)
{
"mcpServers": {
"faf": {
"command": "npx",
"args": ["-y", "claude-faf-mcp@latest"]
}
}
}
Opção 3: Extensão do Navegador
Instale na Chrome Web Store - funciona em qualquer repositório Git.
Inteligência em Três Fases
Fase 1: Detecção de Stack
- Escaneia
package.json,Cargo.toml,pyproject.toml, etc. - Analisa a estrutura de diretórios e padrões de arquivos
- Identifica frameworks, alvos de implantação, configuração de testes
Fase 2: Mineração de Contexto
…
Perguntas frequentes
Por que a IA precisa de um "contexto" diferente do README?
O README explica o projeto para pessoas. O contexto gerado pelo FAF Wizard explica para a IA como ela pode ajudar a construir ou modificar o código.
Ele funciona com qualquer tipo de projeto?
Sim, ele foi projetado para funcionar com uma vasta gama de projetos, desde os mais novos até os mais antigos, em diversas linguagens de programação.
Quanto tempo leva para criar esse contexto?
Geralmente, leva cerca de 60 segundos para analisar o projeto e gerar o contexto para a IA.
Detalhes
Descrição original do autor
Done-for-you .faf generator. One-click AI context for any project - new, legacy, or famous. Auto-detects stack, scores readiness, works everywhere.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #2974
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
benchmark-optimization-loop
Faz seu agente melhorar a velocidade de algo de forma medida. Ele testa várias versões e escolhe a mais rápida que ainda funciona corretamente.
affaan-m/ECC
change-impact
Ajuda seu agente a analisar o impacto de mudanças no código antes de fazê-las. Ele compara o planejado com o real depois, cobrindo caminhos, dados, testes e documentação. É útil para mudanças arriscadas ou que afetam várias partes do sistema.
affaan-m/ECC
click-path-audit
Faz seu agente rastrear todos os botões e interações do usuário para achar bugs. Ele encontra problemas onde funções parecem funcionar sozinhas, mas falham juntas. Útil quando bugs persistem mesmo após depuração.
affaan-m/ECC