| name | mestre-em-nomeclatura-e-organizacao-de-pastas-e-arquivos |
| description | Ativar quando o usuário precisar: nomear uma pasta ou arquivo novo, criar estrutura de pastas para um projeto ou sistema, revisar nomes existentes que estão confusos ou com abreviações, organizar produção de conteúdo (reels, fotos, vídeos, eventos, cursos). Aplica sistema validado: nomes completamente descritivos sem abreviações, hierarquia de 3 a 7 níveis conforme contexto, datas em formato AAAA-MM no nome do arquivo (nunca nome de mês), fluxo Brutos/Editados/Postados para produção. Teste obrigatório: 'uma pessoa sem contexto entende o que tem dentro sem abrir?' Triggers: 'nome para essa pasta', 'como organizar', 'estrutura de pastas', 'nomeclatura', 'que nome coloco', 'cria as pastas', 'organiza isso'. |
| author | Rafa Marks - Criador do Marketing De Vantagem |
| created | "2026-06-19T00:00:00.000Z" |
Ativação Visual
Execute antes de qualquer resposta:
python3 ~/.claude/skills/ascii-art-terminal/splash.py --skill "Mestre em Nomeclatura" --theme cosmos 2>/dev/null || true
Mestre em Nomeclatura e Organização de Pastas e Arquivos
Visão Geral
Sistema de regras validadas para nomear pastas e arquivos de modo que qualquer pessoa — sem contexto, sem ajuda — entenda o que tem dentro sem precisar abrir. Cobre dois contextos: documentos gerais e produção de conteúdo com times.
Referência Rápida — Qual Sistema Usar
| Contexto | Máximo de Níveis | Onde vai a data |
|---|
| Documentos gerais, projetos pessoais | 3 níveis | No nome do arquivo |
| Produção de conteúdo com time (reels, fotos, eventos, cursos) | 5 níveis | No nome do arquivo |
| Casos específicos fora do padrão acima | 7 níveis (máximo absoluto) | No nome do arquivo |
| Projetos de código (apps, sites) — pastas do framework | Sem limite (padrão do framework) | — |
A hierarquia serve para navegar quando não sabe o que procura. O nome do arquivo serve para buscar quando sabe o que quer. Os dois trabalham juntos.
Passo 1 — Entender o Contexto
Antes de propor qualquer nome ou estrutura, perguntar internamente:
- É documento geral ou produção de conteúdo com time?
- Quem vai usar isso? Só o Rafa ou um time inteiro?
- Tem status de workflow? (bruto → editado → postado)
- Qual idioma do projeto? (PT para projetos em português, EN só se o repositório for internacional)
Passo 2 — Aplicar as Regras de Nomenclatura
Proibições absolutas — sem exceção
Abreviações proibidas (exemplos — a regra vale para qualquer abreviação):
img → imagensdocs → documentoscfg → configuracoestmp → temporariosref → referenciasmkt → marketingmisc → assuntos-diversos-sem-categoriaq1, q2, t1, t2 → primeiro-trimestre-de-2026, segundo-trimestre-de-2026wip → em-andamentojan, fev, mar → usar data numérica no nome do arquivo: 2026-01, 2026-02
Nomes genéricos proibidos:
pasta1, arquivo2, novo, nova-pasta, copia, final, final-v2, versao-nova, aprovado, ok, misc, outros, geral, stuff, untitled
Formato obrigatório
- Letras minúsculas sempre
- Espaços substituídos por hífens:
relatorio-de-vendas-2026-06.pdf
- Datas no nome do arquivo em formato
AAAA-MM ou AAAA-MM-DD — nunca nome do mês por extenso nem abreviado (junho, jun, JUN)
- Por quê:
abril, agosto, dezembro, fevereiro... ordena alfabeticamente no Finder, não cronologicamente. 2026-04, 2026-08, 2026-12 ordena certo.
Teste obrigatório antes de finalizar qualquer nome
Fazer esta pergunta: "Uma pessoa que nunca viu este projeto, ao ver só este nome, entende exatamente o que tem dentro sem abrir?"
- Resposta NÃO → reformular o nome
- Resposta SIM → pode usar
Passo 3 — Aplicar a Hierarquia Correta
Para documentos gerais (3 níveis)
projetos-em-andamento/
lancamento-do-curso-de-copywriting/
documentos-e-contratos/
contrato-com-fornecedor-de-plataforma-2026-06.pdf
briefing-do-curso-versao-final-2026-05.docx
Para produção de conteúdo com time (até 5 níveis)
Hierarquia padrão:
Nível 1: Área → conteudo/ ou eventos/ ou produtos/
Nível 2: Sub-área ou projeto → reels/ ou cupula-2026/ ou funil-1/
Nível 3: Tipo de mídia → videos/ ou fotos/ ou textos/
Nível 4: Sub-tipo (se necessário)→ depoimentos/ ou palestras/ ou bastidores/
Nível 5: Status do arquivo → brutos/ ou editados/ ou postados/
Exemplo real:
conteudo/
reels/
videos/
brutos/
reel-lancamento-cupula-2026-dia-01-manha.mp4
editados/
reel-lancamento-cupula-2026-dia-01-manha-versao-final.mp4
postados/
reel-lancamento-cupula-2026-dia-01-manha-postado-2026-06-15.mp4
eventos/
cupula-2026/
videos/
brutos/
cupula-2026-dia-01-manha-palestra-abertura.mp4
cupula-2026-dia-01-tarde-painel-de-especialistas.mp4
editados/
postados/
fotos/
brutas/
editadas/
depoimentos/
brutos/
editados/
A data (dia 01, manhã, tarde) vai no nome do arquivo, não na pasta. Isso mantém a hierarquia navegável e os arquivos pesquisáveis.
Para casos fora do padrão (até 7 níveis — máximo absoluto)
Usar apenas quando existe necessidade comprovada que ultrapassa os 5 níveis. Justificar mentalmente por que cada nível extra é necessário antes de adicionar.
Passo 4 — Fluxo de Status (Brutos → Editados → Postados)
Para produção de conteúdo, o fluxo de trabalho funciona por pastas de status dentro do tipo de mídia:
videos/
brutos/ ← arquivo chega aqui da gravação
editados/ ← editor arrasta pra cá quando termina
postados/ ← social media arrasta pra cá quando publica
Isso permite que, olhando a pasta editados/, você veja tudo que está pronto mas ainda não foi postado. E em brutos/, tudo que ainda precisa de edição.
Passo 5 — Pastas Existentes com Nomes Errados
MUST NOT renomear silenciosamente pastas existentes com nomes errados. Renomear sem avisar quebra scripts, links salvos e fluxos de trabalho de outras pessoas.
O que fazer:
- Trabalhar normalmente com o nome errado que existe
- Na primeira conversa em que o Rafa trabalhar com aquela pasta: mencionar o nome problemático e perguntar "Quer que eu corrija agora?"
- Se disser sim → renomear na hora
- Se disser depois → não insistir, mencionar na próxima vez
Regras Invioláveis (MUST)
- MUST aplicar o teste "qualquer pessoa entende sem abrir" em CADA nome proposto
- MUST expandir toda abreviação para o nome completo
- MUST usar hífens em vez de espaços
- MUST usar letras minúsculas
- MUST colocar datas no formato AAAA-MM ou AAAA-MM-DD — nunca nome de mês
- MUST NOT ultrapassar 7 níveis de pasta em nenhum contexto
- MUST NOT usar nomes genéricos como final, ok, novo, copia, misc, outros
- MUST NOT renomear pastas existentes sem autorização explícita do Rafa
- MUST respeitar nomes de pastas obrigatórios do framework em projetos de código (src/, node_modules/, public/) — aplicar regras apenas nas pastas criadas pelo Rafa
- MUST usar português para projetos em português; inglês apenas se o projeto exige repositório internacional
Exemplos Comparativos
Errado vs. Certo — documentos:
ERRADO: /docs/mkt/Q2/final-v2.pptx
CERTO: /documentos-de-marketing/apresentacoes-para-clientes/proposta-comercial-cliente-acme-2026-06.pptx
Errado vs. Certo — versões:
ERRADO: relatorio-junho.pdf, relatorio-final.pdf, relatorio-ESSE.pdf
CERTO: relatorio-de-resultados-de-marketing-2026-06.pdf
Errado vs. Certo — produção de conteúdo:
ERRADO: /videos/edit/ok/reel-v3-APROVADO.mp4
CERTO: /reels/videos/editados/reel-lancamento-produto-x-2026-06-15-versao-final.mp4
