Problema resolvido
Quando a gente mistura modelo (o que é definido) com instância (o que acontece no uso real), a estrutura de pastas vira confusão: rascunhos vão parar no Livro, e o Aprendiz perde liberdade para errar e evoluir.
Frase canônica: O Livro define o que é possível. O Aprendiz mostra isso acontecendo. Instância é conhecimento em uso.
M3 Metamodelo (o que é uma trilha?)
M2 Modelo (Trilha Preparatória de Categorias)
M1 Especificação (página oficial no Livro)
M0 Instância (meu uso real + evidência)
Definição essencial
Instância é uma ocorrência concreta de algo que foi definido em um nível mais abstrato. Em OLA: o Livro descreve; o Aprendiz executa, adapta, registra e produz evidências.
Diagrama (Modelo → Instância → Evidência)
Como isso afeta a estrutura (impacto prático)
Regra estrutural 1
Onde há instância, há variabilidade
Por isso o Aprendiz tem trilhas por ciclo, rascunhos, versões e evidências.
Regra estrutural 2
Modelo não vira instância “por existir”
Arquivo no Livro é proposta/definição. Instância só existe quando alguém usa.
Regra estrutural 3
Instância registra experiência (não perfeição)
Aprendiz precisa de reflexões, erros e rastros. O Livro não.
Regra estrutural 4
Migração Aprendiz → Livro é curadoria
Só o que ficou estável e validado vira artigo/OLA oficial no Livro.
Checklist rápido: isto é modelo ou instância?
Marque pensando no arquivo/pasta que você está criando agora.
Mini-quiz (30 segundos)
- “trilha_teoria_categorias.html” no Livro é modelo ou instância?
- “aprendiz/trilhas_ativas/trilha_categorias/progresso.html” é modelo ou instância?
- “aprendiz/artigos/rascunhos/artigo_categorias_v0.md” deveria estar no Livro?
Respostas canônicas:
1) Modelo/Especificação (M2/M1). 2) Instância (M0). 3) Não — rascunho é do Aprendiz.