Loading repository data…
Loading repository data…
caiocoswosk / repository
Sistema de documentação acadêmica assistida por IA — do caos de materiais dispersos a um caderno estruturado e autoexplicativo.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
Sistema de documentação acadêmica assistida por IA — do caos de materiais dispersos a um caderno estruturado, navegável e autoexplicativo.
Sempre tive dificuldade de organizar minhas sessões de estudo de forma que fossem fluidas e consistentes. Na faculdade federal isso se complica ainda mais: não existe nenhum padrão entre livros, aulas e materiais fornecidos pelos professores. O resultado era muito tempo gasto em esforços paralelos e redundantes sem chegar a lugar nenhum.
Por ter TDAH, prestar atenção na aula e ao mesmo tempo copiar o conteúdo do quadro sempre foi uma batalha. Isso se intensificava por um problema de coordenação motora que tornava a experiência de copiar literalmente dolorosa. Quanto mais complexo o conteúdo, pior ficava o dilema: acompanhar o raciocínio ou registrar o que estava sendo escrito.
Com o aumento de responsabilidades — estágio, atividades extracurriculares, projetos — a pergunta ficou inevitável:
Como posso organizar e estruturar meu estudo de forma fácil, rápida, com baixa carga cognitiva — e ao mesmo tempo só enviar fotos do quadro ou os materiais do professor e ter todo o conteúdo de estudo gerado automaticamente?
O Caderneiro é a resposta que construí para isso.
O Caderneiro é um sistema baseado em IA para criar e operar cadernos acadêmicos — repositórios de conhecimento por disciplina, gerados a partir dos materiais brutos das aulas.
Um caderno transforma isso:
aulas/aula-03/
├── capturas/ ← fotos do quadro tiradas na aula
├── slides.pdf ← material do professor
└── codigo-exemplo.c ← implementação vista em aula
Em isso:
conteudos/
└── 1-introducao-grafos.md ← conteúdo estruturado, navegável,
com teoria, código comentado,
exercícios por nível e glossário
Sem precisar digitar nada durante a aula. Sem perder o fio do raciocínio. Sem dor.
O Caderneiro é um conjunto de instruções para agentes de IA (Claude Code ou OpenCode). Ele define:
capturas/) em transcricao.md com verificação de inconsistências e correção automáticaToda interação acontece via menus interativos ou skills diretas: o agente apresenta opções usando o recurso nativo de menus do Claude Code / OpenCode, e cada operação tem sua própria skill invocável diretamente.
caderneiro/ ← clone este repositório e abra aqui
└── cadernos/ ← seus cadernos ficam aqui (privados, .gitignore)
Cada caderno gerado tem a seguinte estrutura:
nome-da-disciplina/
├── conteudos/ ← conteúdo estruturado, um arquivo por tópico
│ └── 1-introducao-grafos.md
├── aulas/ ← materiais brutos originais
│ └── aula-01/
│ ├── capturas/
│ ├── slides.pdf
│ └── codigo.c
└── instrucoes/ ← procedimentos operados pelo agente (não editar)
Detalhes completos da estrutura interna em
caderneiro.md.
| Ferramenta | Arquivo de contexto | Skills |
|---|---|---|
| Claude Code | CLAUDE.md | .claude/commands/ |
| OpenCode | AGENTS.md + opencode.json | .opencode/commands/ |
caderneiro/ no Claude Code ou OpenCode/menu para ver as operações disponíveis/menu para acessar as operações do dia a dia| Comando | Operação | O que faz |
|---|---|---|
/menu | Menu principal | Apresenta as opções abaixo |
/criar-caderno | Criar caderno | Configura um novo caderno para uma disciplina a partir da ementa |
/atualizar-caderno | Atualizar caderno | Propaga melhorias do caderneiro para um caderno existente |
/modificar-caderno | Modificar caderno | Ajusta configurações de um caderno existente |
| Comando | Operação | O que faz |
|---|---|---|
/menu | Menu principal | Apresenta as opções abaixo |
/transcrever-aula | Transcrever aula | Converte fotos do quadro em transcrição revisada |
/processar-aula | Processar aula | Transforma qualquer material da pasta da aula em conteúdo estruturado; identifica o tópico automaticamente |
/gerar-imagens | Gerar imagens | Produz imagens de diagramas a partir dos prompts pendentes |
/exportar-conteudo | Exportar conteúdo | Sincroniza conteudos/ + imagens com o Notion ou exporta como PDF |
/revisar-conteudo | Revisar conteúdos | Verifica arquivos em conteudos/ contra os padrões atuais e oferece re-processamento dos divergentes |
O caderneiro recomenda automaticamente o modelo mais adequado para cada operação com base na complexidade da tarefa:
| Nível | Operações | Exemplos (Anthropic) |
|---|---|---|
| SIMPLES | criar-caderno, modificar-caderno, gerar-imagens | haiku |
| MEDIO | questionario, atualizar-caderno, transcrever-aula, exportar-conteudo, revisar-conteudo | sonnet |
| COMPLEXO | geracao, processar-aula | opus |
Ao iniciar uma operação, o agente identifica o modelo ativo e compara com o nível recomendado. Se diferente, sugere troca e para — aguarda a decisão do usuário antes de prosseguir. Detalhes em instrucoes/modelos.md.
Este projeto tem foco pessoal e estudantil. Os cadernos gerados são para uso próprio como ferramenta de estudo.
Não compartilhe cadernos que contenham transcrições, slides ou qualquer material de terceiros (professores, livros, apostilas) sem autorização explícita dos detentores dos direitos. O fato de o conteúdo ter sido processado por IA não altera a titularidade do material original.
Feito para quem aprende de forma não-linear, em ambientes não-padronizados, com uma cabeça que não para.