Comece seu primeiro caso

Esta página é a espinha. Seis passos levam você do zero a um caso aberto na sua máquina, com um tutor restrito a ele e uma nota que você pode rodar quantas vezes quiser. Cada passo é curto aqui e tem uma página própria quando você quiser o detalhe.

Nada nesta página sobe código, abre pull request nem registra qualquer coisa no seu perfil. Entregar o caso é um comando além do fim daqui, e também tem a sua própria página.

Antes de começar

• O Fito instalado na sua máquina, conforme Instalação e pré-requisitos.
• Um servidor Fito ao seu alcance, com a aplicação web rodando.
• Um provedor de LLM configurado no pi. O tutor e a avaliação rodam na sua assinatura.

Reserve um tempo para o caso em si. Os dois casos de exemplo são estimados em 35 e 40 minutos.

1. Criar uma conta

Abra a aplicação web e cadastre-se em /auth/signup, ou entre se você já tiver conta.

Já que está lá, vincule o GitHub com Continue with GitHub. Você não precisa dele para esta página, e vai precisar no momento em que for enviar.

→ Criar uma conta e entrar

2. Escolher um caso e copiar o id

Abra /cases e escolha um. A capa dele traz os objetivos de aprendizagem, os pré-requisitos, os critérios de rubrica e — quando você está logado — quais pré-requisitos você já tem.

Copie o id da URL, o <id> em /cases/<id>. Os casos não têm nome curto, então você cola esse id em todo comando abaixo.

→ Encontrar um caso para trabalhar

3. Entrar pelo terminal

Inicie uma sessão do pi em qualquer pasta e rode:

/fito-login

O seu navegador abre, você entra com a mesma conta, e os seus tokens caem em ~/.fito/credentials. O navegador manda você voltar ao terminal.

→ Entrar pelo terminal

4. Abrir o caso

/fito-case-open <case-id>

Isso faz o fork do caso para o seu GitHub, clona em ~/.fito/cases/<case-id>/, faz checkout da versão publicada, cria a sua branch de trabalho e então explica o caso para você: a situação, a tarefa, as restrições, as entregas e os componentes de conhecimento (knowledge components) que ele desenvolve. Ele nunca mostra a solução.

→ Abrir e trabalhar um caso

5. Trabalhar, e perguntar quando travar

Abra ~/.fito/cases/<case-id>/ no seu editor e resolva. Commite na branch de trabalho.

Quando travar, pergunte ao tutor:

/fito-tutor como devo abordar isso?

Ele consegue ler este caso e o conhecimento por trás dele, e mais nada.

→ Pergunte ao tutor

6. Ver a prévia da sua nota

/fito-evaluate <case-id>

Um ensaio contra o seu checkout local. Sem pull request, sem envio, nada registrado. Ele roda as verificações automatizadas da rubrica, avalia cada critério de 0 a 3 com a justificativa e mostra a proficiência que cada nota registraria. Se o caso tiver um quiz, você o responde aqui como treino.

Repita até ficar satisfeito.

→ Como um caso é avaliado

Você chegou ao fim da preparação

Agora você tem um caso real com um checkout de trabalho, um tutor e um ciclo de avaliação local. Daqui em diante é o caso em si.

Quando estiver pronto para entregar, o comando é /fito-submit <case-id> — e ele precisa do vínculo com o GitHub do passo 1.

O que vem a seguir

• Enviar e ler o seu resultado — entregue o caso e veja o que fica no seu perfil.
• Níveis de Bloom e proficiência — o que uma nota registrada quer dizer.
• Navegar pela área de conhecimento — o vocabulário contra o qual um caso é avaliado.