faf-expert
Faz seu agente trabalhar com um formato especial chamado .faf. Ele é usado para configurar sistemas de IA e garantir que tudo funcione bem junto. É útil para gerenciar configurações complexas de IA.
O que ela faz
Esta ferramenta ajuda a organizar informações sobre seus projetos de programação para que inteligências artificiais (IA) possam entendê-los melhor. Ela cria um formato especial (.faf) que funciona como um mapa detalhado do seu projeto, permitindo que a IA ajude de forma mais eficiente.
Quando usar
- ✓Ao iniciar um projeto complexo que precisa de muita organização.
- ✓Quando você quer que a IA entenda rapidamente a estrutura do seu código.
- ✓Para garantir que diferentes ferramentas de IA possam trabalhar juntas no mesmo projeto.
Exemplo do que pedir para a IA
“Organize as informações do meu projeto de software para que a IA possa entendê-lo melhor.”
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
Ela transforma os detalhes do seu projeto, como as linguagens usadas, o objetivo e onde ele roda, em um formato padronizado (.faf). Esse formato funciona como um 'DNA' do projeto, que a IA pode ler e usar para dar conselhos mais precisos.
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-expertOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/faf-expert/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 Expert - Arquitetura de Contexto Avançada de IA
Domine o formato registrado na IANA que faz a IA entender seus projetos.
Transforme qualquer base de código em um projeto inteligente para IA com contexto persistente que sobrevive entre sessões, ferramentas e plataformas de IA. Controle de nível especialista na camada fundamental que impulsiona fluxos de trabalho de desenvolvimento de IA modernos.
Quando Usar Esta Habilidade
Use o FAF Expert quando precisar de:
| Cenário | O que o FAF Expert Oferece |
|---|---|
| Configuração de projeto complexo | Configuração especializada de arquivos .faf e servidores MCP |
| Pontuação de campeonato | Alcance pontuações de prontidão para IA de 85%+ para projetos de produção |
| Fluxos de trabalho multi-IA | Contexto universal que funciona entre Claude, Cursor, Gemini, Windsurf |
| Revitalização de base de código legado | Transforme arqueologia em DNA de projeto legível por IA |
| Colaboração em equipe | Formato de contexto padronizado para assistência de IA consistente |
| Implantação empresarial | Configuração e gerenciamento profissional de servidores MCP |
Exemplos do Mundo Real
Exemplo 1: Sistema Java Corporativo Legado
# Achieved: 92% Gold tier with FAF Expert
project:
name: enterprise-payment-api
goal: Mission-critical payment processing system
stack:
backend: java-spring
database: oracle
runtime: java-11
deployment: kubernetes
human_context:
where: AWS EKS production cluster
when: Legacy system from 2018, modernizing 2026
how: Spring Boot 2.7, Oracle 19c, Docker containerization
Exemplo 2: Painel Moderno em React
# Achieved: 97% Gold tier performance
project:
name: analytics-dashboard
goal: Real-time analytics for SaaS platform
stack:
frontend: react-18
css_framework: tailwind
state: zustand
build: vite
testing: vitest
deployment: vercel
Capacidades Principais
🏆 Sistema de Pontuação de Campeonato
- Nível Ouro (95%+): Contexto de IA pronto para produção
- Nível Prata (85%+): Padrão de desenvolvimento profissional
- Nível Bronze (70%+): Base sólida para assistência de IA
🔧 Configuração do Servidor MCP
Configuração especializada do claude-faf-mcp com 33 ferramentas:
{
"mcpServers": {
"faf": {
"command": "npx",
"args": ["-y", "claude-faf-mcp@latest"]
}
}
}
🔄 Sincronização Bidirecional
Mantenha o contexto sincronizado entre plataformas:
.faf↔CLAUDE.md.faf↔.cursorrules.faf↔GEMINI.md.faf↔AGENTS.md
📊 Framework de Arquitetura Mk4
Formato IANA de 33 slots para contexto abrangente do projeto:
- Identidade e objetivos do projeto
- Detecção de pilha técnica
- Contexto humano (quem/o quê/por quê/onde/quando/como)
- Padrões de arquitetura
- Configuração de implantação
Primeiros Passos
Instalação Rápida
# Install FAF CLI
npm install -g faf-cli
# Initialize your project
faf init
# Score AI-readiness
faf score --details
# Set up MCP server
faf mcp install
Comandos de Especialista
# Advanced scoring with breakdown
faf score --championship --verbose
# Multi-platform sync
faf bi-sync --target all
# Validate format compliance
faf validate --strict
# Enhanced AI optimization
faf enhance --model claude --focus completeness
Métricas de Sucesso
Dados de Desempenho Reais:
- Mais de 52 mil downloads em todo o ecossistema FAF
- Mais de 800 testes abrangentes (CLI + MCP)
- Formato registrado na IANA (application/vnd.faf+yaml)
- Mais de 153 formatos validados suportados
- Desempenho de nível de campeonato (<50ms de execução)
Compatibilidade de Plataforma
Ferramentas de IA Suportadas
- ✅ Claude Code - Integração nativa com MCP
- ✅ Cursor - Sincronização .cursorrules
- ✅ Gemini CLI - Sincronização GEMINI.md
- ✅ Windsurf - Suporte a .windsurfrules
- ✅ Universal - Funciona com qualquer IA que leia YAML
Servidores MCP Disponíveis
claude-faf-mcp- 33 ferramentas, 391 testesgrok-faf-mcp- Otimizado para xAI/Grokrust-faf-mcp- Desempenho nativo (binário de 4,3 MB)gemini-faf-mcp- Integração com Google Gemini
Padrões Avançados
Configuração Corporativa
faf_version: "3.0"
project:
name: enterprise-platform
tier: production
human_context:
team_size: 50+
compliance: SOC2, HIPAA
deployment: multi-region
stack:
architecture: microservices
orchestration: kubernetes
monitoring: datadog
security: vault
Revitalização de Sistema Legado
# Transform 10-year-old codebase to AI-ready
project:
archaeology: true
modernization_target: 2026
stack:
legacy: php-5.6
migration_path: laravel-11
database_upgrade: mysql-8
Recursos de Especialista
…
Perguntas frequentes
O que é o formato .faf?
É um jeito padronizado de descrever seu projeto para que a IA entenda todos os detalhes importantes.
Para que serve o 'Championship Scoring System'?
É um sistema que avalia o quão bem o seu projeto está organizado para a IA, dando notas como 'Ouro' ou 'Prata'.
O que são 'MCP Servers'?
São servidores especiais que ajudam a IA a se conectar e entender o formato .faf do seu projeto.
Detalhes
Descrição original do autor
Advanced .faf (Foundational AI-context Format) specialist. IANA-registered format, MCP server config, championship scoring, bi-directional sync.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #2972
- 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