mestre-em-nomeclatura-e-organizacao-de-pastas-e-arquivos

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:

1. É documento geral ou produção de conteúdo com time?
2. Quem vai usar isso? Só o Rafa ou um time inteiro?
3. Tem status de workflow? (bruto → editado → postado)
4. 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 → imagens
• docs → documentos
• cfg → configuracoes
• tmp → temporarios
• ref → referencias
• mkt → marketing
• misc → assuntos-diversos-sem-categoria
• q1, q2, t1, t2 → primeiro-trimestre-de-2026, segundo-trimestre-de-2026
• wip → em-andamento
• jan, 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)

1. MUST aplicar o teste "qualquer pessoa entende sem abrir" em CADA nome proposto
2. MUST expandir toda abreviação para o nome completo
3. MUST usar hífens em vez de espaços
4. MUST usar letras minúsculas
5. MUST colocar datas no formato AAAA-MM ou AAAA-MM-DD — nunca nome de mês
6. MUST NOT ultrapassar 7 níveis de pasta em nenhum contexto
7. MUST NOT usar nomes genéricos como final, ok, novo, copia, misc, outros
8. MUST NOT renomear pastas existentes sem autorização explícita do Rafa
9. 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
10. 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