organizar
Skill0 starsChanged 3 months agoMITView on GitHub
Reorganiza uma pasta de estudos do vault agrupando as notas POR ASSUNTO, e cria subpastas temáticas quando o agrupamento justifica. Sempre propõe antes de mover. Use quando o Dantas rodar /organizar, ou disser "organiza minhas anotações", "essa pasta está bagunçada", "agrupa isso por assunto", "cria pastas pros capítulos", "tá tudo solto aí".
In this repository8 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- aulaSkill
- moverSkill
- planejarSkill
- processar-filaSkill
- proximaSkill
- revisar-semanaSkill
- setupSkill
The file
Files
/organizar — agrupar notas por assunto
Todos os comandos desta skill assumem que você está na raiz do projeto (
~/Documents/AGENTES/ATIVOS/escriba). O cwd pode resetar entre chamadas de shell — segrep '^vault:' config.mdfalhar, é isso. Façacdpara a raiz antes, ou use caminho absoluto.
O Dantas organiza o segundo cérebro por conteúdo, nunca por aula ou data. Duas notas do mesmo tema ficam juntas mesmo que tenham sido dadas em semanas diferentes; duas notas da mesma aula se separam se tratam de temas distintos.
O princípio, com o exemplo que prova
Polinômio de Lagrange e Interpolação e Ajuste de Curva (AULA 13) são o
mesmo assunto — Lagrange é um método de interpolação. Agrupando por aula,
ficariam separadas. Por conteúdo, ficam juntas. É esse o critério.
O Network+ dele já segue isso: as pastas são as seções temáticas do exame
(Section 1 (Networking Concepts)), não a ordem em que assistiu.
Passo 0 — A pasta é sua para mexer?
# caminho RELATIVO ao vault, sem o prefixo — passar absoluto dá "fora do mapa"
scripts/posso-escrever.sh "02 - Areas/Estudos/<curso>" # 0 = pode · 1 = nãoBloqueado → pare imediatamente e diga por quê. Reorganizar pasta de outro agente quebra o fluxo dele sem ele saber; reorganizar pasta fora do mapa mexe em coisa que não é sua.
Hoje: 02 - Areas/Estudos/Network+/ é do tutor-cybersec.
Exceção: ele apontar a pasta explicitamente. Aí vale, e você diz que está saindo do escopo padrão.
Passo 0b — Escopo
Curso seu (no mapa do config.md, fora da lista de outros agentes) → todas
as notas da pasta entram, inclusive as que o Dantas escreveu. É o que permite
respeitar o "tudo ou nada": mover só metade criaria a mistura que ele recusa.
scripts/nota-e-minha.sh serve para o relatório distinguir o que era dele do
que era seu — não para excluir notas do agrupamento.
Passo 0c — Criar estrutura, ou REVISAR a que existe?
Os dois casos usam esta skill. O segundo é o mais esquecido e o mais valioso.
Uma organização escolhida com 3 notas raramente serve com 20. O curso revela o próprio recorte só depois de andar — e a estrutura inicial foi um palpite feito com pouca informação. Revisar não é admitir erro; é usar informação que não existia antes.
Sinais de que a estrutura envelheceu
| Sinal | O que significa |
| Um grupo com mais de 60% das notas | O critério parou de discriminar — aquele grupo virou "o resto" |
| Grupo com 1 nota enquanto outros têm muitas | Recorte fino demais para o material que apareceu |
| Mais de 15 notas sem subpasta nenhuma | Passou da hora de agrupar |
| Notas novas caindo sempre na raiz | Nenhum grupo existente as acolhe — falta um tema |
| Dois grupos que você sempre abre juntos | Deviam ser um só |
Como medir, sem achismo
Rode a partir da raiz do projeto (~/Documents/AGENTES/ATIVOS/escriba):
VAULT="$(grep '^vault:' config.md | sed 's/^vault: //')"
CURSO="<pasta do curso>" # relativa ao vault
scripts/medir-pasta.sh "$VAULT/$CURSO"Saída: total de notas, quantas na raiz, e a distribuição por subpasta com percentual — os números dos sinais da tabela acima.
Ao propor uma revisão
Mostre por que a estrutura atual não serve mais, com os números, antes de mostrar a nova. E diga o que permanece — revisão não é recomeçar do zero, e grupo que está funcionando fica como está.
Passo 1 — Ler antes de propor
Nunca agrupe por título. Abra cada nota e leia pelo menos:
- o
tituloe adisciplinado frontmatter - a seção
## Conceitos-Chave— é ali que o assunto real aparece - os
[[links]]existentes — notas que já se citam costumam ser do mesmo tema
Título engana. Comandos SQL (DML & DQL) parece um assunto só e são dois.
Nota sem frontmatter e sem ## Conceitos-Chave — um despejo de anexos, uma
lista de links — não se classifica pelo que ela é, e sim pelo que ela
referencia. Se referencia material de vários temas, ela é ponte de todos os
grupos: caso 3 da subseção abaixo, e sinal de que o recorte precisa mudar (ou
de que o curso fica plano).
Nota que atravessa dois assuntos
Acontece, e a skill não pode fingir que não. Comandos SQL (DML & DQL) cobre
dois temas de uma vez.
Não divida a nota — isso é editar conteúdo, não organizar, e exige pedido separado. Não duplique. Escolha assim, nesta ordem:
- O assunto dominante, medido pelos
## Conceitos-Chave: se 7 dos 9 são de DQL, vai para DQL - Empate real → vai para o grupo do tema que vem primeiro no curso (a nota é a ponte, e é lida na ordem da trilha)
- A nota é ponte entre TODOS os grupos → é sinal de que o recorte está errado. Reveja o agrupamento, não a nota
Se em qualquer caso a alocação parecer arbitrária, registre isso na proposta — é informação para o Dantas decidir, não detalhe a esconder.
Passo 2 — Decidir se vale reorganizar
Criar pasta é opcional, nunca obrigatório. A pergunta não é "como divido isto?" — é "dividir isto melhora alguma coisa?". Se a resposta for não, a resposta certa é não mexer, e dizer isso com clareza. Estrutura imposta a material que não pede é pior que nenhuma estrutura: espalha as notas, quebra o hábito de saber onde as coisas estão, e não devolve nada.
Dentro de um curso: ou tudo em pasta, ou nada em pasta. Nunca deixe metade das notas em subpastas e metade solta na raiz — é a pior das três saídas, porque some com o critério: você deixa de saber se uma nota não está agrupada por não ter grupo ou por ninguém ter organizado ainda.
Consequência prática: se algum tema fica com uma nota só e não há como juntá-lo honestamente a outro, o curso não deve ser subdividido agora. Deixe plano e espere ter massa. Pasta de uma nota é artefato, não organização.
Cada curso tem o padrão que a necessidade dele pede. Network+ usa as seções do exame; Claude Code usa numeração sequencial; outro pode ficar plano. Não uniformize entre cursos — uniformize dentro de cada um.
Não reorganize por reorganizar. Sinais de que NÃO vale:
- Menos de 6 notas na pasta — subpasta com 2 notas atrapalha mais que ajuda
- Entre 6 e 15 notas o número não decide nada. Não é "vale" nem "não vale"; é a faixa em que só o conteúdo responde. Pergunte: os temas se separam sozinhos, ou você está inventando o recorte? Se precisou forçar, não vale
- A pasta já tem subpastas temáticas funcionando
- As notas são numeradas em sequência de conteúdo (
01 -,02 -, …) e há um00 - Índice.md. Aí a numeração já É a organização, e mover quebra o índice. Caso real:Maestros da IA/Claude Code/— não mexer - Algum tema ficaria com uma nota só. Não crie pasta de uma nota, e não deixe essa nota solta enquanto as outras vão pra pasta — as duas saídas são ruins. Ou você junta esse tema a outro honestamente, ou o curso inteiro fica plano. É a consequência direta do "tudo ou nada" acima
Se não vale, diga isso e pare. Explique por quê. Não invente estrutura.
Passo 3 — Propor, com o diff inteiro à vista
Mostre a estrutura atual e a proposta, lado a lado, e espere o ok:
📁 Modelagem computacional — 11 notas soltas
Proposta de agrupamento por assunto (as 11 entram — nenhuma fica solta):
📁 Sistemas Lineares e Otimização/
• Solução de Sistemas Lineares (AULA 10)
• Método de Gauss Seidel (AULA 12) ← método iterativo p/ sistemas
• Matriz inversa e Resposta à Estímulos (AULA 11)
• Otimização Unidimensional Irrestrita (AULA 9) ← busca de raiz adaptada;
a Lista 4 do professor
já junta os dois temas
📁 Aproximação de Funções/
• Polinômio de Lagrange ← é um método de interpolação
• Interpolação e Ajuste de Curva (AULA 13)
• Integração numérica (AULA 15) ← Simpson usa grau 2 de Lagrange
• Equações Diferenciais Ordinárias ← RK4 é quadratura ponderada
📁 Listas e Provas/
• Exercicios para a AP2
• Lista 5 — Ajuste de Curva e Integração
• Lista 6 — Equações Diferenciais
Movo as 11 notas em 3 pastas. Nenhuma nota é editada, só realocada
(o conteúdo, inclusive a Anotação Pessoal, fica intacto).
Confirma?Repare que nenhuma nota fica na raiz — é o "tudo ou nada" aplicado. Foi preciso juntar Otimização a Sistemas Lineares e agrupar as listas em
Listas e Provas— que só existe porque são três. Se fosse uma só, criar a pasta seria artefato: aí a resposta correta é deixar o curso inteiro plano, nunca deixar a nota solta enquanto as outras vão pra pasta.
Sempre inclua, para cada nota que muda de lugar, por que ela vai ali — uma frase, quando não for óbvio pelo título.
Passo 4 — Executar
Só depois do ok. Para cada nota:
VAULT="$(grep '^vault:' config.md | sed 's/^vault: //')"
mkdir -p "$VAULT/<pasta da disciplina>/<Grupo>"
git -C "$VAULT" mv "<origem>" "<destino>"Depois, sem exceção:
Revisando estrutura que já existe? O Passo 4 acima cobre criar grupo novo. Revisar tem três movimentos a mais:
- Mover entre grupos existentes:
git mv "<Grupo A>/nota.md" "<Grupo B>/nota.md" - Fundir dois grupos: mova tudo para o que fica, e apague o que esvaziou
- Apagar pasta que esvaziou: o git não versiona diretório, então a
pasta vazia sobra no disco e continua aparecendo no Obsidian — a
reorganização parece feita pela metade. Remova explicitamente:
Só depois de mover tudo.# confira primeiro find "$VAULT/<pasta do curso>" -mindepth 1 -type d -empty -print # duas passadas: o find avalia -empty ANTES de apagar os filhos, então # uma pasta que só continha subpastas vazias sobrevive à primeira find "$VAULT/<pasta do curso>" -mindepth 1 -type d -empty -delete find "$VAULT/<pasta do curso>" -mindepth 1 -type d -empty -delete
- Mover entre grupos existentes:
- Não renomeie os arquivos. Mover já é suficiente, e renomear quebraria
todos os
[[links]]do vault de uma vez. Se um nome estiver ruim, aponte isso separado, depois. ## Links para Outras Notas: os[[links]]do Obsidian são por nome, não por caminho — mover não quebra nenhum. Não há nada a corrigir por causa da movimentação em si. Só ajuste se, ao ler as notas no Passo 1, você notou vizinhança temática que a seção não registrava; e nesse caso diga na proposta que vai fazer isso, porque é edição de conteúdo, não realocação.- Atualize o
00 - Índice.mdse existir, refletindo a estrutura nova. - Não há links a conferir. Você não renomeou nada (passo 1), e o
[[link]]do Obsidian resolve por nome, não por caminho. Mover não pode quebrar link — não gaste passo com isso. (Se um dia a skill permitir renomear, aí sim: e o padrão de busca terá que cobrir[[Nome|alias]]e[[Nome#seção]], que um grep por[[Nome]]não pega.)
Passo 5 — Commitar
Um commit só para a reorganização inteira, com pathspec na pasta:
O git mv do Passo 4 já deixa cada movimentação staged. Não use add -A
na pasta — ela é justamente onde o Dantas pode estar digitando, e varreria a
edição em voo dele para dentro do seu commit.
git -C "$VAULT" commit -m "escriba: organiza <disciplina> por assunto (N notas, M grupos)" \
-- "<pasta da disciplina>"Editou índice ou frontmatter? Adicione só esses arquivos, por caminho:
git -C "$VAULT" add -- "<caminho do índice>".git/index.lock ocupado é esperado, não erro — o plugin Obsidian Git
commita a cada 15 min, e uma reorganização são dezenas de git mv seguidos.
Repita com backoff:
for i in 1 2 3 4 5; do
git -C "$VAULT" mv "<origem>" "<destino>" 2>/dev/null && break
sleep 2
doneSe o commit disser nothing to commit, o plugin ganhou a corrida e já levou as
movimentações. Confirme com git -C "$VAULT" log -1 --stat e reporte, não
falhe.
Nunca push.
Passo 6 — Ensinar o mapa
Este passo é o que faz a organização durar. Atualize o config.md para
que as aulas futuras já caiam na subpasta certa:
| Modelagem computacional | modelagem, mod comp | `02 - Areas/Estudos/IBMEC/{período}/Modelagem computacional/{Grupo}/` | `{Tópico}.md` |
**Grupos de Modelagem computacional:** Sistemas Lineares e Otimização ·
Aproximação de Funções · Listas e Provas.
Nota que não encaixa em nenhum grupo **não vai para a raiz** — isso recria a
mistura. É sinal de que falta um grupo: pare, proponha o grupo novo, e só então
escreva.Sem isso, a próxima aula volta a cair solta na raiz e a bagunça recomeça.
Se a resposta for "não vale mexer"
É desfecho legítimo e provavelmente o mais comum. Tem bloco próprio:
📁 <curso> — <N> notas, <M> subpastas
Recomendação: NÃO subdividir agora.
Por quê:
· <razão concreta, com número>
· <razão concreta, com número>
Tentei estes recortes e nenhum funcionou:
· <recorte> → <o que quebrou>
· <recorte> → <o que quebrou>
Nada movido, nada criado, nada commitado.
Posso registrar essa decisão no config.md (com o motivo e a data), para o
próximo /organizar não refazer a análise do zero? [aguardando ok]Repare no tempo verbal: peça, não anuncie. Gravar no config.md é a única
escrita que este desfecho produz, e a skill inteira é construída sobre propor
antes de mexer — não abra exceção justamente aqui.
Não há sha nem o-que-mudei.sh aqui — não houve commit no vault. Mas grave a
decisão na tabela "Subpastas temáticas por curso" do config.md, com o
motivo e o número de notas da época. Sem isso, o próximo /organizar refaz a
análise inteira do zero.
Se o curso já estiver marcado como plano nessa tabela: re-verifique mesmo
assim (o volume pode ter mudado) e diga se a decisão anterior continua
valendo.
Relatório
Sempre termine com o inventário derivado do git:
scripts/o-que-mudei.sh <sha do commit>Cole a saída — é onde ele confere arquivo por arquivo o que você mexeu.
✅ Pasta organizada
📁 02 - Areas/Estudos/IBMEC/4º periodo/Modelagem computacional/
Grupos criados: 3 (Sistemas Lineares e Otimização, Aproximação de
Funções, Listas e Provas)
Notas movidas: 11 · nenhuma na raiz
Links: nenhum quebrado (nomes de arquivo preservados)
config.md: mapa atualizado — aulas novas já caem no grupo certo
Commit: escriba: organiza Modelagem computacional por assunto [não enviado]
Desfazer tudo: git -C "$VAULT" revert <sha>Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

