FAF Go — Caminho Guiado para 100% ✪

"Basta digitar /faf-go, responder às perguntas até terminar. Meta de 100%."

.faf é um formato de contexto registrado na IANA (application/vnd.faf+yaml) — um arquivo portátil e tipado que você possui, legível por qualquer IA. faf-cli pontua em 21 campos; seu app_type seleciona quais estão ativos, e 100% ✪ = cada campo ativo preenchido. Essa habilidade é a entrevista guiada que leva você até lá: a IA preenche o que consegue detectar e, em seguida, pergunta a você — via AskUserQuestion do Claude Code — apenas pelas lacunas que não consegue obter.

Quando Usar Esta Habilidade

Ative quando:

• O usuário quiser melhorar sua pontuação .faf
• O usuário mencionar "Código Dourado" ou "100%"
• O usuário tiver contexto incompleto do projeto
• Após faf init para preencher campos ausentes
• O usuário disser "me ajude com meu .faf"

Integração com Claude Code

FAF Go é construído PARA Claude Code:

• AskUserQuestion - Interface nativa do Claude Code para perguntas
• multiSelect: true - Permite múltiplas respostas (ex: "pytest + WJTTC")
• TodoWrite - Acompanha o progresso da entrevista
• Saída estruturada - JSON que o Claude Code entende
• Bi-sincronização - Respostas fluem para .faf E CLAUDE.md

Suporte a MultiSelect

Algumas perguntas permitem múltiplas seleções:

• stack.testing → "pytest + WJTTC"
• stack.cicd → "GitHub Actions + Cloud Build"
• stack.frontend → "React + Tailwind"
• human_context.who → "Developers + AI agents"

Quando multiSelect: true, o usuário pode escolher 2+ opções. Os resultados são unidos com " + ".

Fluxo de Trabalho

Etapa 1: Verificar Estado Atual

Execute faf score para entender a posição atual:

faf score --verbose

Ou obtenha como dados estruturados para uso programático:

faf score --json

--json retorna a pontuação + detalhamento por campo — os campos vazios são aqueles sobre os quais você entrevista (a ordem de prioridade está na Etapa 2).

Etapa 2: Fazer Perguntas Usando AskUserQuestion

Para cada campo ausente, use a ferramenta AskUserQuestion do Claude Code:

Ordem de Prioridade (mais impactante primeiro):

1. project.goal - O que este projeto faz?
2. human_context.why - Por que isso existe?
3. human_context.who - Quem usa isso?
4. human_context.what - Que problema ele resolve?
5. project.main_language - Linguagem principal
6. stack.database - Escolha do banco de dados
7. stack.hosting - Onde é implantado?
8. stack.frontend - Framework frontend
9. stack.backend - Framework backend
10. human_context.where - Ambiente
11. human_context.when - Cronograma/fase
12. human_context.how - Como o projeto é construído (obtido da stack)

Etapa 3: Aplicar Respostas

Após coletar as respostas, atualize o arquivo .faf:

# Read current .faf
cat project.faf

# Update fields (use Edit tool)
# Then verify:
faf score

Etapa 4: Celebrar ou Continuar

Se pontuação >= 100: Celebre a conquista do Código Dourado Se pontuação < 100: Continue com as perguntas restantes

Modelos de Perguntas para AskUserQuestion

Perguntas de Seleção Única (escolha uma)

project.goal

{
  "question": "What does this project do? (one clear sentence)",
  "header": "Goal",
  "multiSelect": false,
  "options": [
    {"label": "Let me type it", "description": "I'll describe it myself"},
    {"label": "Help me write it", "description": "Guide me through it"}
  ]
}

human_context.why

{
  "question": "Why does this project exist?",
  "header": "Why",
  "multiSelect": false,
  "options": [
    {"label": "Business need", "description": "Solving a business problem"},
    {"label": "Personal project", "description": "Learning or hobby"},
    {"label": "Open source", "description": "Community contribution"},
    {"label": "Let me explain", "description": "Custom reason"}
  ]
}

stack.database

{
  "question": "What database do you use?",
  "header": "Database",
  "multiSelect": false,
  "options": [
    {"label": "PostgreSQL", "description": "Relational database"},
    {"label": "MongoDB", "description": "Document database"},
    {"label": "SQLite", "description": "File-based database"},
    {"label": "None", "description": "No database"}
  ]
}

stack.hosting

{
  "question": "Where is this deployed?",
  "header": "Hosting",
  "multiSelect": false,
  "options": [
    {"label": "Vercel", "description": "Frontend/serverless"},
    {"label": "AWS", "description": "Amazon Web Services"},
    {"label": "Local only", "description": "Not deployed"},
    {"label": "Other", "description": "Different platform"}
  ]
}

Perguntas de Seleção Múltipla (escolha várias, unidas por " + ")

…