Crie seu primeiro caso

Esta página é a espinha da criação de casos. Nove passos levam você de uma pasta vazia até um caso que alguém pode abrir, e cada um é curto aqui e tem uma página própria quando você quiser o detalhe.

Reserve mais de uma sentada. Os passos 1 a 5 são uma sessão de trabalho; o passo 6 é você escrevendo código de verdade, e leva o tempo que o código levar.

Duas coisas para saber antes de começar. O Fito não escreve o código do seu caso — ele escreve o contrato em volta dele, e o plano a partir do qual você constrói o código. E o caso vive no seu repositório, não no Fito.

Antes de começar

• Fito instalado, conforme Instalação e pré-requisitos.
• Um servidor Fito que você consiga acessar.
• Um provedor de LLM configurado no pi, e o pacote pi-subagents instalado. Todos os passos abaixo rodam na sua assinatura.
• gh, autenticado — rode gh auth login. O passo 8 cria um repositório.

Também ajuda ter jogado um caso antes. Criar um fica bem mais fácil quando você sabe como é o outro lado: Jogue seu primeiro caso.

1. Prepare um diretório de trabalho

Trabalhe num diretório seu, não dentro do pacote do Fito. Vários passos escrevem pastas de saída, e o Fito recusa que escrevam dentro dele.

→ Preparar um diretório de trabalho

2. Garanta que o conhecimento existe

Um caso só pode referenciar componentes de conhecimento (knowledge components) que o Fito já guarda. Antes de desenhar qualquer coisa, confira que a tecnologia, a linha principal dela e os componentes que você tem em mente estão todos lá.

Se não estiverem, isso é outro trabalho e ele vem primeiro — o pipeline de conhecimento, do provisionamento de uma tecnologia até o envio dos componentes.

→ Navegar pela área de conhecimento · Provisionar uma tecnologia

3. Desenhe o caso

/fito-case-design "diagnosticar um endpoint JSON quebrado" --technology javalin@7

Um diálogo fecha o escopo, o tipo do caso, a duração e a toolchain, e depois fundamenta cada referência de conhecimento contra o vocabulário vivo. Ele escreve ./case-proposal.md e nada mais.

Tome seu tempo nas referências. Elas são a única coisa que você não consegue mudar depois sem começar um caso novo.

→ Desenhar um caso

4. Gere a pasta .case/

/fito-case-generate --dir ~/code/my-case

Isso transforma a proposta no contrato: os quatorze arquivos obrigatórios, mais um quiz se você desenhou um. Ele roda o validador estrutural até a árvore passar, mostra um resumo e comita.

Leia o resumo direito, inclusive os campos opcionais que ele relata como vazios. Aquela lista é a única vez em que eles são mencionados.

→ Gerar a pasta .case/ · Validar a pasta .case/

5. Planeje o código

/fito-case-plan-source ~/code/my-case

Você recebe dois documentos sob .authoring/: o que o código precisa ser, e passos ordenados para chegar lá. Eles cobrem tanto o estado inicial que quem aprende recebe quanto a solução exemplar.

→ Planejar o código do caso

6. Construa o código, fora do Fito

Este passo não é um comando do Fito. Percorra .authoring/source-plan.md no seu próprio harness, com as ferramentas que você quiser.

Você terminou quando duas coisas forem verdade:

• O ramo case/solution-v1.0.0 existe localmente e todo gate da rubrica passa nele.
• O ramo inicial corresponde ao que starter_state/known_state.yaml prometeu — os testes certos falhando, os erros certos aparecendo.

Comite tudo.

7. Revalide a árvore terminada

/fito-case-generate --dir ~/code/my-case

O mesmo comando, e ele toma outro caminho porque .case/ já está lá. Ele finaliza artifacts.yaml contra a árvore agora real e ganha o atestado novo que a publicação leva.

8. Publique

/fito-publish-case ~/code/my-case --repo my-case

Você confirma o repositório, aprova a descrição de vitrine que quem aprende lê antes de se inscrever, e o comando faz o resto: ele envia main, o ramo e a tag congelados v1.0.0 e o ramo da solução, e depois registra e publica o caso.

Você recebe de volta um id de caso e a URL onde ele agora está listado.

→ Publicar um caso

9. Abra como quem aprende

/fito-case-open <case-id>

Faça isso. É a única forma de ver o que você de fato entregou — o briefing que quem aprende recebe, na ordem em que recebe, com a solução fora de alcance.

Depois rode /fito-evaluate <case-id> contra uma tentativa propositalmente errada e veja se a sua rubrica diz algo útil.

→ Abrir e trabalhar um caso

Você tem um caso publicado

Ele é encontrável, ele avalia, e os refs dele estão congelados. As correções daqui em diante seguem um de dois caminhos, e qual deles depende de a correção tocar ou não as referências de conhecimento.

O que vem a seguir

• Corrigir ou aposentar um caso publicado — os dois caminhos, e como escolher.
• O que é um caso — o contrato que você acabou de construir, num lugar só.
• Como um caso é avaliado — no que a sua rubrica se transformou.