agentleFS
dantas6773dantas6773/escriba/.claude/skills/planejar/SKILL.md

planejar

Skill0 starsChanged 3 months agoMITView on GitHub

Lê o material completo de um curso (slide de 200+ páginas, apostila) e cria o plano de conteúdo — unidades temáticas com faixa de páginas e a organização em pastas, decidida uma vez no começo. Use quando o Dantas rodar /planejar, ou disser "o professor postou o material do semestre", "planeja esse curso", "olha esse slidão e organiza". Também se chega aqui pela Fase 1b da skill `aula`, quando ela detecta material extenso na fila e ele aprova mapear.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. wendelcastro/fluxo-engenharia-ia★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository8 other files it gives its agents.

The file

Files
SKILL.md

/planejar — mapear o material do semestre

Roda toda vez que o professor publica material novo — e isso costuma acontecer em partes: 50 páginas agora, mais 80 depois de cinco aulas, e assim por diante. Na primeira vez cria o plano; nas seguintes, acrescenta. Entre uma e outra, /proxima escreve as notas.

O ganho é o panorama antecipado: sabendo o conteúdo inteiro, a organização sai por assunto e não pela ordem em que as aulas caíram no calendário. Tema cortado no meio da aula e retomado na seguinte vira uma unidade.

Comandos assumem a raiz do projeto (~/Documents/AGENTES/ATIVOS/escriba).

Passo 1 — Pode escrever nesse curso?

scripts/posso-escrever.sh "02 - Areas/Estudos/<curso>"

Bloqueado → pare. Curso ainda não mapeado → pergunte onde as notas vão morar e acrescente ao config.md antes de continuar.

Passo 2 — É material novo de um curso que já tem plano?

ls planos/

Existe plano → este é o caminho comum. Não recomece: leia o plano atual, veja onde parou, e trate o material novo como continuação.

  1. Confira se o material é mesmo novo — mesmo arquivo republicado não vira unidade nova. Compare nome e número de páginas com os já registrados
  2. Mande só o material novo para o escriba-planejador, junto com a lista de unidades que já existem, para ele não repetir tema já mapeado
  3. Continue a numeração. Se o plano vai até a unidade 07, o material novo começa na 08
  4. Cada unidade registra de qual material veio — o curso passa a ter vários, e o /proxima precisa saber qual PDF fatiar

Não existe plano → siga para o Passo 3, é a primeira vez.

Quando o material novo muda o desenho

Às vezes a parte 2 revela que a organização feita com a parte 1 não serve mais — um tema que parecia único se abre em três, ou dois grupos separados viram um.

Diga, não force. O plano feito com 50 páginas era hipótese com informação parcial; rever é usar o que não existia antes:

Com o material 2, a unidade 03 ("Aproximação") se abre em duas: interpolação
(mat.1 pág 40-50 + mat.2 pág 1-22) e ajuste (mat.2 pág 23-60).
Reviso o plano, ou mantenho e trato as duas como uma nota só?

Notas já escritas não são refeitas por causa disso — a menos que ele peça. Se a revisão mudar a pasta de uma nota existente, isso é /organizar, e passa pelo gate dele.

Passo 3 — Ler o material inteiro

scripts/extrair-materiais.sh "<material.pdf>" "trabalho/plano-<slug>"

Material acima de 40 páginas não é renderizado em imagem — só texto. É o esperado aqui: o mapa se faz com o texto, e os diagramas entram depois, quando /proxima fatiar a unidade.

Vários materiais (teoria + listas + anexo)? Extraia todos para a mesma pasta.

Passo 3b — Nenhuma página fica de fora por não ter texto

Antes de fechar o mapa, confira a cobertura: toda página do material pertence a alguma unidade, ou está explicitamente marcada como sem nota (capa, encerramento).

O erro a evitar tem nome e já aconteceu: montar um índice pelo texto extraído, ver uma página em branco e declará-la vazia. Página sem texto costuma ser ilustração — e ilustração de slide costuma ser o conteúdo mais denso que existe, não o mais vazio.

# quais páginas não têm texto, e quais dessas são desenho
"$(pyvenv)" -c '
import io, sys, subprocess
txt = io.open(sys.argv[1], encoding="utf-8", errors="replace").read().split("\f")
mudas = [i+1 for i, p in enumerate(txt) if len(p.strip()) < 30]
print("sem texto:", mudas)' "trabalho/plano-<slug>/<material>.txt"

Para cada uma, renderize e olhe. PNG acima de ~60 KB é desenho; abaixo é branco de verdade.

pdftoppm -png -r 150 -f <pág> -l <pág> "<material.pdf>" /tmp/checa

Só declare "sem nota" o que você viu estar vazio. E registre no plano uma seção listando as ilustrações e a que unidade cada uma pertence — quem escrever a nota depois precisa saber que elas existem.

Passo 4 — Chamar o escriba-planejador

Passe a pasta de trabalho/. Ele devolve o mapa: unidades, faixas de página, proposta de pastas.

Não leia o material você mesmo — 200 páginas destroem seu contexto. É pra isso que o subagente existe.

Passo 5 — Propor, e esperar

Mostre o mapa inteiro. Para cada unidade: título, páginas, e por que ela é uma unidade quando não for óbvio. Destaque em separado os casos em que o corte do professor não bate com o conteúdo — é o que justifica o plano existir.

📚 Modelagem computacional — material de 214 páginas

Li o material inteiro. Ele está organizado por aula, e em 3 pontos o corte
da aula parte um assunto no meio:

  · "Interpolação" começa na pág. 88 (Aula 13) e termina na 119 (Aula 14)
  · "Integração" e "EDO" estão na mesma Aula 15, e são temas separados

Proposta — 11 unidades em 3 pastas:

📁 Álgebra Linear Numérica/
   01 · Sistemas Lineares               pág 12-38
   02 · Matriz Inversa                  pág 39-61
   03 · Métodos Iterativos              pág 62-87

📁 Aproximação de Funções/
   04 · Interpolação Polinomial         pág 88-119   ← junta Aula 13 e 14
   05 · Ajuste de Curva                 pág 120-141
   06 · Integração Numérica             pág 142-166  ← separado de EDO

...

Escrevo o plano? Nenhuma nota é criada agora — só o mapa.

Ele pode discordar do agrupamento, e a decisão é dele. Nada é escrito antes do ok.

Passo 6 — Gravar

Aprovado, escreva planos/<slug-do-curso>.md:

# Plano — <Curso>

**Destino:** `02 - Areas/Estudos/<curso>/`
**Criado em:** <YYYY-MM-DD>

## Materiais

| ID | Arquivo | Páginas | Publicado |
|---|---|---|---|
| M1 | `slides-parte-1.pdf` | 50 | 2026-08-10 |
| M2 | `slides-parte-2.pdf` | 80 | 2026-09-14 |

## Unidades

| # | Unidade | Material | Páginas | Pasta | Nota |
|---|---|---|---|---|---|
| 00 | Frente e sumário | M1 | 1-6 | — | — sem nota |
| 01 | Sistemas Lineares | M1 | 7-38 | Álgebra Linear | ✅ |
| 02 | Interpolação | M1 · M2 | M1:39-50, M2:1-22 | Aproximação | ⬜ |

<!-- ⬜ pendente · 🟡 escrita, revisar · ✅ pronta -->
<!-- faixa pode ser descontínua: extrair-paginas.sh aceita "a-b,c,d-e" -->

## Temas espalhados
Assunto que reaparece longe. Vira `[[link]]` entre as notas, não merge.
- Unidade 02 (condicionamento) retoma a 01 (propagação de erro)

## Como o corte da aula difere do conteúdo
- Unidade 04 junta as Aulas 13 e 14 — interpolação estava partida
- Unidade 06 e 07 saíram da mesma Aula 15 — eram dois temas

E acrescente os grupos ao config.md, na tabela "Subpastas temáticas por curso", para as notas caírem no lugar certo.

Não crie as pastas no vault agora. Elas nascem quando a primeira nota de cada grupo for escrita — pasta vazia no Obsidian é ruído.

Relatório

Primeira vez:

✅ Plano criado
   📄 planos/<slug>.md
   Unidades:  8  (6 com nota · 2 sem)
   Material:  M1 · slides-parte-1.pdf, 50 páginas
   Pastas:    plano, sem pastas
   config.md: registrado

   Próximo passo: "próxima" escreve a unidade 01.

Material acrescentado:

✅ Plano atualizado
   📄 planos/<slug>.md
   Material novo:  M2 · slides-parte-2.pdf, 80 páginas
   Unidades novas: 09 a 14  (6)
   Unidade 02 estendida: agora M1:39-50 + M2:1-22
   Total:          14  ·  3 escritas · 11 pendentes
   Organização:    inalterada

   Próxima pendente: 03 · Métodos Iterativos

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.