[Feedback] O Iniciante · 2026-07-08

[caioross]

Sou o Iniciante: tô aprendendo a programar e uso jogo de digitação pra pegar
velocidade e me acostumar com a sintaxe. Cheguei sem saber nada do CodeRacer.
Método: joguei o app de verdade (rodei local com pnpm dev e joguei pelo browser) —
criei sala, corri um snippet inteiro até o fim, vi o resultado e o ranking global.
Fui honesto onde a máquina atrapalhou o teste (ver métricas no fim).

Primeira impressão (os 3 segundos)

Bateu logo que é coisa séria: visual de terminal, "14 LINGUAGENS", "200+ trechos de código
de verdade". Gostei do tom leve — o input pede o nick com "Ex.: caio_dev" e quando esqueci o
nome ele me xingou de leve ("Coloca um nome aí, fera"). Isso me deixou à vontade, que é raro
pra quem tá começando e tem medo de fazer errado.

Mas bateu uma dúvida de cara: o texto diz "sem cadastro, sem firula" e no topo tem um
botão "entrar com Google". Fiquei na dúvida se eu precisava logar pra jogar. (Não
precisa — mas eu não sabia disso nos primeiros segundos.)

A jornada

1. Botei o nick novato_dev e cliquei Criar sala.
2. Abriu um modal de config (linguagem / dificuldade / máx jogadores). Achei bonito os
   descritivos de cada dificuldade ("Snippets curtos, sintaxe básica"). Cliquei criar.
3. Caí no lobby como líder. Vi "sem outros jogadores — inicie quando quiser" e mandei
   Iniciar partida.
4. Countdown → corri um snippet de JavaScript (uma função recursiva de achatar array).
5. Terminei em 1º 🥇, vi 26 wpm · 100%, a tabela completa (WPM/precisão/erros/tempo) e
   já aparecí no ranking global na hora (6º). Isso me deu um gás enorme.

Funcionou de ponta a ponta, sem travar. Pra quem tá começando, chegar do zero até "meu nome
no ranking mundial" em 2 minutos é muito bom.

Top 3 fricções

1. Caí no "Médio" sem querer — e Médio é pesado pra quem tá começando.
A dificuldade já vem marcada em Médio por padrão (confirmei: é o default). Quem tá
começando (como eu) clica em criar sem mexer e cai num snippet de ~10 linhas com recursão e
reduce — longe do "sintaxe básica" que o próprio jogo promete no card do Fácil. A spec
docs/UI-AAA-OVERHAUL.md §0.3 diz que o que conquista o Iniciante é "dificuldade fácil
generosa". Sugestão: primeira sala / sala solo já nascer no Fácil, ou um empurrãozinho
tipo "primeira vez? começa no Fácil".

2. Cheguei sozinho e não sabia se dava pra jogar.
A home inteira fala em "manda o link pros amigos", "quem digita mais rápido que seus
amigos", e as salas públicas estavam vazias ("nenhuma sala pública aberta agora"). Deu a
sensação de que eu precisava de gente pra jogar. Só descobri que dá pra treinar sozinho
depois de criar a sala e ver o texto no lobby. E aí bate uma mensagem meio contraditória: o
lobby diz "você só inicia quando todos marcarem pronto" logo acima de "inicie quando
quiser". A §0.3 lista "Practice/solo, modo treino" como o que conquista o Iniciante —
hoje isso existe escondido. Sugestão: um botão "treinar sozinho" na home, explícito.

3. Errei e quase não percebi (+ "100% precisão" com "1 erro" me confundiu).
Digitei um caractere errado e o destaque do erro é um rosa bem clarinho num caractere de
espaço/indentação — pra quem tá começando e ainda olha o teclado, passou quase batido. (Isso
já está mapeado na issue #10, então só confirmo que o iniciante sente na pele.) No fim, o
card de resultado mostrou Precisão 100% e Erros 1 ao mesmo tempo — como assim 100% se
eu errei? Corrigi o erro no meio, então imagino que a precisão olha o estado final; mas pra
iniciante isso parece contradição. Sugestão: alinhar a mensagem (ou "1 erro corrigido").

1 encantamento

Entrar no ranking global na hora, mesmo jogando sozinho. Terminei minha única partida e
já vi novato_dev listado entre gente de verdade (fiquei em 6º de 18). Pra quem tá
começando, isso é sensação de progresso pura — me deu vontade de jogar de novo pra subir.
Não mexam nisso. Os descritivos de dificuldade no modal também são ótimos de claros.

Métricas do Iniciante

• Minha corrida: 26 wpm · 100% · 1 erro · 1m 44,8s — snippet JS de 230 chars (recursivo).
  (WPM baixo é culpa minha/da forma como testei, não julguem por isso.)
• Honestidade do teste: eu quis jogar no Fácil, mas por um detalhe de automação acabei
  criando a sala no Médio (o default). Ou seja: não cheguei a experimentar o pool do
  Fácil de verdade — o que reforça a fricção Add animated home effects, spotlight UI & snippets #1 (é fácil demais cair no Médio sem querer).
• Ranking: o nº1 do ranking global tá com 3596 WPM (100%). Isso é humanamente
  impossível — pra mim, iniciante, dá a sensação de "nunca vou competir / isso tá quebrado".
  É prova viva da issue Segurança: finish aceita results não validados → leaderboard global forjável (anti-cheat) #7 (leaderboard forjável / anti-cheat). Não abri issue nova por
  já existir a Segurança: finish aceita results não validados → leaderboard global forjável (anti-cheat) #7.

---

// feedback do jogador da semana — persona O Iniciante

[caioross]

Relato de ouro — jogado de verdade em produção, do zero ao ranking. Fechando o loop item a item (ICE aplicado; chapéu do dia = UI/UX AAA):

Viraram issue agora:

• Fricção 1 — caiu no Médio sem querer → Onboarding: dificuldade nasce em "Médio" e atropela o Iniciante — primeira sala deveria nascer no Fácil (§0.3) #16 (P2). Confirmado: HomeView.tsx:49 nasce em "medium", contra o "dificuldade fácil generosa" da §0.3. Primeira sala deveria nascer no Fácil.
• Primeira impressão — "sem cadastro" x botão "entrar com Google" → Onboarding: botão "entrar com Google" contradiz "sem cadastro" — deixar login explicitamente opcional #17 (P3). Ambiguidade de conversão nos 3 primeiros segundos; vamos deixar o login explicitamente opcional.

Registradas, não convertidas hoje (teto de 2 issues/dia já usado):

• Fricção 2 — cheguei sozinho / modo treino escondido: é o epic §V.5 (Practice/Solo) já mapeado no loop do #9 — segue como modo inteiro a fatiar, não issue solta. A mensagem contraditória do lobby ("todos marcarem pronto" x "inicie quando quiser") entra junto quando essa fatia sair.
• Fricção 3 — "Precisão 100%" com "Erros 1" ao mesmo tempo: contradição real de honestidade de métrica; fica na fila para o chapéu de Engine (sexta), como clareza de rótulo ("1 erro corrigido") — não hoje.
• Erro quase invisível: já é a UX/Feel: erro de digitação é invisível onde o olho está (feedback de erro no card do editor · §779) #10 (P1), você confirmou na pele.

Não mexer (encantamento): ranking global na hora, mesmo solo, e os descritivos do modal de dificuldade — anotados como intocáveis.

Ranking nº1 com 3596 WPM: prova viva da #7 (leaderboard forjável); PR #8 já em revisão. Obrigado por não abrir duplicata.

[caioross]

Fechando o loop pré-prometido: chegou a sexta (chapéu de Engine & Conteúdo) e a Fricção 3 — "Precisão 100%" junto com "Erros 1" virou a #20 (P2, area:engine).

Causa-raiz confirmada no código: errors é contador vitalício (não subtrai ao corrigir) e accuracy arredonda 0.995 → 100% (Race.tsx:56-57,88). A correção é de honestidade: precisão nunca mostra 100% com erro > 0 + rótulo de "Erros" explícito. Obrigado de novo pelo relato jogado de verdade.

[caioross]

Fechando o loop pré-prometido (chapéu de sábado = Produto & Crescimento): a Fricção 2 — "cheguei sozinho / modo treino escondido", que eu havia registrado como "epic a fatiar numa rodada futura", virou issue agora.

• Epic Practice/Solo mode (§V.5): treinar sem sala — modo inteiro a fatiar #24 — Practice/Solo mode (§V.5): o modo inteiro (treino livre + ghost/PB + bots), com plano de fatias.
• 1ª fatia Practice — rota /practice com Treino Livre (sem sala), reusando Race #25 — rota /practice com Treino Livre sem sala, reusando o Race. É o menor valor entregável: o visitante solitário passa a ter o que jogar em um clique, sem criar sala.

Ambas na fila do Quadro (#30) como Todo. Obrigado de novo pelo relato jogado de verdade — foi ele que priorizou isto.