FAF Context — Dê à IA o que ela precisa

Quando Usar

Use esta habilidade quando precisar que seu projeto atinja 100% ✪ de "prontidão para IA", rapidamente — a IA detecta automaticamente sua stack e pede apenas o que ela não pode saber (seu objetivo e o "porquê" humano). Mínimo de digitação, máximo de contexto. Para construtores com pouco tempo; alimenta o faf-expert para profundidade.

A IA escreve seu melhor código quando tem o contexto do seu projeto. Esta habilidade ajuda você a entregá-lo — rápido e a 100%.

.faf é um formato de contexto registrado na IANA (application/vnd.faf+yaml) — um arquivo tipado e portátil que você possui, legível por qualquer IA (sem manifesto personalizado, sem bloqueio de fornecedor). O objetivo principal é um número: prontidão para IA, 0–100%. Em 100% ✪, a IA começa cada sessão já sabendo seu projeto — sem reexplicações, sem adivinhações. Esta habilidade é o caminho do construtor para esse número: digitação mínima, contexto máximo.

Para o caminho "feito para você" de um clique, use faf-wizard. Para dominar o formato, use faf-expert. Esta habilidade é o quickstart entre eles.

Como funciona: tipo de app → IA preenche o máximo → você responde às lacunas

faf-cli tem 21 slots. Funciona em três etapas — e apenas a última precisa de você:

1. O tipo do seu app define quais slots são obrigatórios. Um CLI precisa de slots diferentes de um aplicativo web full-stack — faf-cli ajusta o conjunto e slotignored os demais (nunca contados contra você).
2. A IA preenche o máximo que pode. faf auto detecta sua stack + linguagem, e uma frase de objetivo clara define quem/o quê/onde. Quanto melhor seu objetivo, mais a IA preenche para você.
3. O que sobrar vazio, a IA pergunta a você. Essas são as partes que só você sabe — geralmente um par dos 6 Ws (frequentemente porquê e quando). Responda-os → 100% ✪.

Portanto, seu trabalho não é "preencher 21 caixas". É: escrever um bom objetivo, depois responder às poucas perguntas que a IA não conseguiu preencher sozinha.

*(Os planos para equipes / corporativos adicionam mais slots — monorepos, caching, versionamento — mas esses não são faf-cli. faf-cli são os 21.)*

Raramente você digita todos os 6 Ws — eis o porquê

Os 6 Ws são "a metade não derivável" — mas você quase nunca escreve todos os seis do zero:

• quem / o quê / onde → definido a partir da sua frase de objetivo (a IA extrai os fatos que seu objetivo declara literalmente)
• como → obtido da sua stack (a detecção sabe como é construído)
• porquê / quando → os únicos dois que são puramente seus

Portanto, o caminho rápido é: escreva um objetivo claro, confirme os dados iniciais, preencha why + when. → 100%.

"Às vezes, 3 Ws são suficientes. Às vezes, o objetivo sozinho é suficiente." Uma ótima frase de objetivo + detecção automática podem definir quem/o quê/onde/como por si só — deixando você com duas pequenas respostas. Quanto melhor seu objetivo, menos você digita.

O caminho mais rápido para 100% ✪

faf auto      # 1. AI detects your whole stack + seeds context from your README
faf score     # 2. See the number + exactly which slots are still empty
faf go        # 3. Guided fill: confirm the seeded Ws, answer the 1–2 left
faf score     # 4. 100% ✪
faf sync      # 5. Push context into CLAUDE.md / AGENTS.md (optional)

A maioria dos projetos está a 1 bom objetivo + 2 respostas de um Troféu.

Escreva a ÚNICA frase de objetivo (isso faz o trabalho pesado)

O objetivo é a entrada generativa — ele define quem/o quê/onde automaticamente. Faça uma frase real e específica (é também seu caso de uso):

• ✅ "Um CLI que pontua a prontidão de IA de qualquer repositório e sincroniza o contexto para Claude, Cursor e Gemini — para desenvolvedores solo." → define o quê (um CLI que pontua a prontidão de IA), onde (Claude, Cursor, Gemini), quem (desenvolvedores solo). Você só adicionaria porquê + quando.
• ❌ "Uma ferramenta para melhorar o desenvolvimento." → genérico; não define nada. (Frases genéricas são ignoradas de propósito — vazio é melhor que errado.)

Os 6 Ws — rótulos concisos, não prosa

Cada W é um rótulo de 3–4 palavras (limite máximo < 6) — um cartão de especificação escaneável, não um parágrafo:

Slots que não se aplicam → slotignored

…