[Feedback] O Iniciante · 2026-07-12

[caioross]

Persona: O Iniciante (§0.3) — tô aprendendo a programar e uso digitação pra pegar intimidade com a sintaxe.
Método: joguei de verdade no navegador — criei sala, digitei snippets reais em Python (Fácil), errei de propósito pra ver o feedback, terminei corridas e abri o Ranking Global. Semana ISO 28 → persona 3.

Primeira impressão (os 3 segundos)

Bonito e rápido de carregar, isso me deixou à vontade. Mas o texto todo fala de amigos: "manda o link pros amigos", "quem digita mais rápido leva", "até 12 jogadores". Meu primeiro pensamento como iniciante foi: "e se eu só quero treinar sozinho? isso aqui é pra mim?". Quase fechei a aba achando que precisava de gente. A promessa da spec ("isto é um jogo de verdade") se cumpre no visual, mas não me convida a começar sozinho — que é exatamente o meu caso.

A jornada

1. Botei um nick e cliquei em Criar sala — abriu um modal caprichado (14 linguagens, dificuldade com descrição, sala privada). Escolhi Python + Fácil.
2. No lobby apareceu "// sem outros jogadores — inicie quando quiser" 🎉 — aí sim entendi que dava pra jogar sozinho. Ufa. (Mas eu só descobri isso depois de criar a sala.)
3. Corri o snippet def soma(numeros): ... (5 linhas). Errei de propósito → a precisão caiu, o contador de Erros subiu, e o caractere errado ficou destacado em vermelho na referência. Isso me ajudou a achar o erro.
4. Terminei em 🥇 (sozinho), vi o pódio + tabela (WPM / precisão / erros / tempo) e "Jogar de novo". Repeti limpo: 23 WPM · 100% · 0 erros · 46s numa boa.
5. Abri o Ranking Global — minhas partidas apareceram lá certinho.

Funcionou de ponta a ponta. O núcleo é sólido. Minhas dores foram de descoberta e atrito de digitação, não de bug no essencial.

Top 3 fricções (o que me travou como iniciante)

1. Indentação é uma parede — e o Tab não ajuda. Em Python eu preciso digitar cada espaço da indentação na mão (4, depois 8...). Testei apertar Tab esperando indentar: não faz nada (a tecla é engolida — pelo menos não me joga pra fora do editor, mas também não insere espaço nenhum). Não há auto-indent ao apertar Enter. Pra quem tá aprendendo, digitar (8 espaços) sem errar é a parte mais difícil e menos "divertida" da corrida, e o destaque de erro em cima de um espaço em branco é quase invisível. Entendo que a contagem é char-a-char e os snippets usam espaços, não tabs (spec §0.4 e linha ~1008) — a fairness tá certa. Sugestão gentil: fazer o Tab pular/preencher exatamente a indentação esperada no ponto do cursor (auto-avança só o whitespace de início de linha). Mantém a honestíssima contagem dos tokens de código, mas tira a tortura de contar espaço. Isso conquistaria muito o Iniciante.

2. "Cadê o treino?" — o solo existe mas fica escondido. O modo solo só se revela dentro da sala. Como iniciante eu queria um botão claro tipo "Treinar sozinho / Practice" já na home, sem passar por "Criar sala" (que soa social). A spec já prevê isso (§V.5 Practice/Solo 🟠) e há issues em andamento (#24, #25) — só reforço que, pra minha persona, isso não é "nice to have", é a porta de entrada. Enquanto não sai, um microcopy no botão ("Criar sala — dá pra jogar sozinho também") já reduziria a fricção quase de graça.

3. O Ranking Global tem um recorde impossível e isso me desanima. O #1 é hackerman com 3596 WPM, enquanto o #2 tem 44. 3596 WPM não existe (recorde humano ~200). Como iniciante, ver isso no topo me passou duas mensagens ruins: "eu nunca vou chegar perto" e "esse ranking não é confiável". É uma métrica claramente errada poluindo o placar público — o anti-cheat/persistência não está barrando WPM implausível. Abri a issue P1 com isso (repro: é só abrir /leaderboard).

Observação de apoio (já mapeada, não conto como fricção nova): quando errei, apareceu "Precisão 95%" junto de "Erros 1" de boa, mas a issue #20 já trata do caso "100% + Erros 1" que confunde — pra quem tá aprendendo, o rótulo de erro importa muito. 👍 por já estar na fila.

1 encantamento (não mexam nisso!)

"backspace não pontua". Isso é ouro pro iniciante. Eu erro muito, e saber que posso voltar e corrigir sem levar penalidade extra tirou o pânico da corrida — dá pra aprender sem me sentir punido a cada tropeço. Junto com o syntax highlighting ao vivo (ver def roxo, o nome da função verde) e o snippet Fácil realmente curto e legível (soma), a corrida virou um exercício acolhedor, não uma prova. É exatamente o "dificuldade fácil generosa + feedback gentil" que a §0.3 promete pra mim.

Métricas da persona (Iniciante)

• Corrida limpa em Python/Fácil: 23 WPM · 100% precisão · 0 erros · 46s — achei totalmente alcançável, senti progresso ao repetir.
• Curva de entrada: carregou rápido, criar sala foi intuitivo; o único "onde clico pra treinar?" foi o solo escondido.
• Sensação de progresso: boa dentro da sala (pódio + "jogar de novo"), mas quebrada no ranking global pelo recorde impossível.

[caioross]

Obrigado pelo relato de ponta a ponta, Iniciante — é exatamente o tipo de feedback que move a fila. Fechando o loop nas 3 fricções:

1. Tab não indenta (a parede da indentação). Ideia nova e legítima — dá pra fazer o Tab pular/preencher só o whitespace de início de linha, preservando a contagem char-a-char dos tokens (fairness intacta). ICE ≈ 36 (P3): impacto alto pra sua persona, mas mexe na área sagrada (latência de input) e exige cuidado. Hoje é domingo (dia de poda + [Plano], sem abrir issues novas), então não converto agora — fica como candidata forte da rodada de Engine (sexta) e entra citada no [Plano] da semana. Toca num princípio delicado, então quero que nasça com acceptance criteria à prova de regressão.

2. "Cadê o treino?" — solo escondido. Já mapeado: #24 (epic Practice/Solo) + #25 (rota /practice, a porta de entrada). Seu relato reforça que isso é a porta pra sua persona, não "nice to have" — por isso o #25 sobe no [Plano]. A microcopy que você sugeriu ("Criar sala — dá pra jogar sozinho também") é barata e de alto impacto; anexei como nota ao #25 pra sair junto ou antes.

3. Recorde impossível (3596 WPM) no ranking. Você mesmo abriu a #28 (P1) — obrigado. É o #1 do [Plano] desta semana: sem teto de plausibilidade, o placar público perde a confiança, e isso desanima justamente quem tá começando.

O encantamento do "backspace não pontua" está anotado como restrição de design — ninguém encosta. 🙏

[caioross]

Fechando o loop pré-prometido (chapéu de sexta = Engine & Conteúdo): a Fricção 1 — "o Tab não indenta" virou issue.

Surpresa da investigação: o Tab-para-indentar já existe e está em produção (CodeEditor.tsx:95–115, ligado no Race.tsx:112). Logo, não é feature nova — é bug em código já shipado: o handler roda mas não insere a indentação que você esperava. Por isso nasceu como bug/P2 (affordance quebrado é pior que ausente), com repro, diagnóstico provável (dessincronia de caret na textarea controlada) e acceptance criteria à prova de regressão — inclusive teste e a garantia de não tocar na área sagrada da latência de input.

→ #41. Valeu por ter apertado o Tab "esperando indentar" e relatado — foi isso que expôs o bug. 🙏