NourEldinShobier/course

Teach Me: espaço de trabalho do curso

O usuário deseja aprender algo ao longo de várias sessões. A pasta atual é o espaço de trabalho. Os caminhos do espaço de trabalho são resolvidos a partir da pasta atual; <plugin> é a pasta dois níveis acima do diretório base desta habilidade. As lições usam o runtime Teach Me e os passos 2-6 da habilidade learn (<plugin>/skills/learn/SKILL.md).

O layout segue a habilidade teach de Matt Pocock (MIT), portanto qualquer ferramenta funciona na mesma pasta.

MISSION.md            por que o usuário está aprendendo          <plugin>/references/workspace/MISSION-FORMAT.md
RESOURCES.md          fontes selecionadas: conhecimento, comunidades, lacunas   RESOURCES-FORMAT.md
GLOSSARY.md           termos que o usuário usou corretamente       GLOSSARY-FORMAT.md
NOTES.md              preferências do usuário, suas notas de trabalho, metáforas já usadas
learning-records/     0001-slug.md: evidência do que ele sabe   LEARNING-RECORD-FORMAT.md
lessons/              0001-slug.src.html -> 0001-slug.html (+ notas)
reference/            folhas de consulta: compactas, imprimíveis, revisitadas com frequência
queue.json            episódios ou capítulos a percorrer
review.src.html       todos os flashcards das lições, vencidos primeiro
sources/              transcrições brutas e texto de capítulos (adicione ao .gitignore)

Toda sessão

1. Leia o estado: MISSION.md, NOTES.md, os registros de aprendizado mais recentes, queue.json. Se não houver MISSION.md, entreviste o usuário primeiro (por que, como é o sucesso, prazo, nível atual, restrições) e escreva no formato do arquivo de modelo. Mudar a missão depois requer a confirmação do usuário e um registro de aprendizado.
2. Recursos: até que RESOURCES.md tenha algumas entradas de alta confiança, encontrá-las é a prioridade (documentação oficial, livros-texto padrão, o próprio curso, uma ou duas comunidades para sabedoria). Pode sem piedade.
3. Aquecimento: comece com duas perguntas de recuperação no chat de lições anteriores (não do material de hoje). Mencione quantos flashcards estão vencidos e ofereça review.html.
4. Escolha a lição: o pedido do usuário, senão o próximo item queued, senão a coisa mais útil na zona de desenvolvimento proximal dele, dados os registros e a missão.
5. Ensine uma coisa: construa lessons/NNNN-slug.src.html (próximo número), seguindo os passos 2-6 da habilidade learn, mas compile no espaço de trabalho: bun <plugin>/scripts/build.ts lessons/NNNN-slug.src.html e depois bun <plugin>/scripts/check.ts lessons/NNNN-slug.html. Vincule a lição anterior e a seguinte, e a folha de consulta relevante. Reutilize exatamente os termos do glossário. Não reutilize uma metáfora listada em NOTES.md; adicione a nova ali.
6. Encerramento: atualize a fila, adicione os cards da lição a review.src.html (um componente cards por baralho, com os mesmos deck e ids de card da lição para que os cronogramas sejam mantidos) e recompile. A cada três lições, ou quando solicitado, destile uma folha de consulta em reference/.
7. Registros: quando o usuário colar progresso de uma lição ou demonstrar entendimento no chat, escreva registros apenas para evidência (veja <plugin>/references/pedagogy.md). Promova termos do glossário que o usuário usou corretamente.

Trabalhando em um curso ou livro

queue.json:

{"source": {"kind": "udemy|youtube|book", "title": "…", "url": "…", "file": "…", "courseId": "…"},
 "items": [{"id": "id-da-aula-ou-capitulo", "title": "…", "section": "…", "status": "queued|taught|skipped", "lesson": "lessons/0004-….html"}]}

• Construa a fila uma vez a partir do currículo ou sumário (<plugin>/references/inputs.md: endpoint do currículo Udemy, yt-dlp -J para playlist, estrutura de PDF ou espinha EPUB). Pule introduções, encerramentos, promoções e questionários por padrão; pergunte uma vez se não tiver certeza.
• Um item por lição. Busque apenas as legendas daquele episódio ou o texto daquele capítulo, quando for ensiná-lo. Nunca pré-busque um curso inteiro.
• "próximo" significa o próximo item queued. O usuário também pode nomear um item ou um intervalo ("aulas 12-14 como uma lição", "apenas capítulo 3, seção 2").
• As lições de episódio ou capítulo usam o formato notes (técnico) ou o formato practice (soft skills, vida, não-ficção): um resumo curto e legível nos termos do usuário, a ideia central como uma figura, o que o instrutor ou autor enfatiza, erros comuns, um questionário e cards. Adicione "onde isso se encaixa" vinculando a lições anteriores. Para cursos estilo AWS, prefira um diagram com um rastreamento de solicitação e uma pergunta "o que quebra se"; anote fatos relevantes para exame em um callout quando o curso for voltado para certificação.
• Cite a aula ou capítulo (título, número, timestamp ou página) no rodapé das fontes. Parafraseie; nunca cole transcrições ou passagens longas nas lições.

Sessões de ensino reverso

Quando o usuário disser "me teste" ou "deixe-me explicar": ele explica primeiro no chat; você encontra a menor lacuna (uma ou duas), faz uma pergunta sobre cada uma (socrática) e dá a resposta após duas tentativas. Registre as próprias palavras dele quando ele acertar.