# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Propósito deste diretório

Este NÃO é um repositório de código. É a base de conhecimento (base de dados em Markdown) do projeto **Atleta do Vôlei**: regras, dicas, funcionamento, condições, planos futuros e qualquer outra informação relevante sobre o projeto.

O objetivo final é que este diretório sirva como fonte única de verdade para responder perguntas sobre o Atleta do Vôlei — inclusive, no futuro, sendo consultado por outros chats/canais para responder dúvidas de terceiros com base apenas no que estiver aqui dentro.

## Regras obrigatórias

1. **Tudo fica dentro deste diretório.** Nenhum conteúdo, arquivo ou informação referente ao Atleta do Vôlei deve ser criado, movido ou salvo fora daqui (nem em `/tmp`, nem em outros diretórios do sistema, nem em memória externa do Claude Code).
2. **Tudo em Markdown.** Todo conteúdo novo deve ser escrito em arquivos `.md`, redigidos como se fossem "arquivos de memória" — um assunto por arquivo, título claro, linguagem direta.
3. **Sempre em português do Brasil**, já que é o idioma do projeto e do público final.
4. **Sem invenção.** Nunca preencher lacunas com suposições. Se uma informação não estiver disponível ou confirmada pelo usuário, deixar marcado como pendente (`TODO` ou `[a confirmar]`) em vez de inventar.
5. **Organização por tema**, não por data. Ao adicionar conteúdo novo, verificar primeiro se já existe um arquivo sobre o assunto e atualizá-lo, em vez de duplicar informação em arquivos diferentes.

## Estrutura sugerida

Ainda não há conteúdo. Conforme as informações forem chegando, organizar em subpastas temáticas, por exemplo:

- `regras/` — regras e regulamentos do projeto/modalidade
- `dicas/` — dicas técnicas, de treino, de jogo etc.
- `funcionamento/` — como o projeto/produto funciona na prática
- `planos/` — condições e planos futuros
- `geral/` — informações que não se encaixam nas categorias acima

Criar essas pastas conforme o conteúdo real for surgindo — não criar estrutura vazia antecipadamente além do necessário.