| name | write-manual |
| description | Use when adapting or generating a manual (text expositiu instructiu) for students. Activates when genre_discursiu == "manual". Applies gradual progression (simple to complex), explicit causal connectors, and defined technical terms. Output: manual in markdown with title, entradeta, and ordered sections.
|
| author | FJE — Fundació Jesuïtes Educació |
| version | 4.0.0-canonic |
| genre_key | manual |
| tipologia | Expositiva |
| mecr_range | ["A1","A2","B1","B2","C1"] |
| agent_role | adapter |
| tools_required | [] |
| triggers | [{"path":"params.genere_discursiu","equals":"manual"}] |
| moduls_relacionats | ["M3"] |
| macro_tipologia | explicativa |
| label_ca | Manual |
| font_canonic | M3_genere-escriure-manual.md |
| font_version | 4.0.0-canonic |
| generat_at | 2026-06-28 |
| generat_per | build_skills.py@v2-2026-05-26 |
| checksum_font | 7d1ee6ad7b68f435 |
Escriure/adaptar un manual — skill operativa per a LLM
El manual és un text expositiu organitzat en apartats progressius que presenta coneixements de manera sistemàtica, de simple a complex. El seu tret definitori és la progressió epistèmica: cada apartat es recolza conceptualment en l'anterior, els termes tècnics estan definits a la primera aparició, i els exemples concrets precedeixen sempre les abstraccions.
Tipologia MALL: Expositiva/Progressiva.
HCL principal: Explicar — exposar un conjunt de conceptes relacionats de manera progressiva i sistemàtica.
HCL secundàries: Descriure — definir i caracteritzar termes tècnics nous (A1-B1) · Justificar — explicar per qué els conceptes s'ordenen de la manera que s'ordenen (B1+).
No s'adapta a pre-A1: el manual requereix la comprensió de la progressió simple→complex com a estructura epistèmica — entendre que els apartats estan en un cert ordre perquè cada un es recolza conceptualment en l'anterior implica la comprensió de la jerarquia i la dependència conceptual entre idees. Aquesta abstracció estructural requereix base lecto-escriptora mínima i familiaritat mínima amb les categories de la matèria. (Decisió 6 canònica Fase B.)
Connexions MALL transversals:
- HCL Explicar com a CALP operatiu: el manual és el gènere on la HCL Explicar és més pura i sistemàtica. Llegir i escriure manuals és aprendre a estructurar l'exposició del coneixement: la competència acadèmica transversal per excel·lència, transferible a totes les matèries.
- Desnominalitzar com a estratègia d'accés al CALP: convertir noms abstractes en processos verbals ("l'oxidació" → "quan un metall s'oxida") és una estratègia de simplificació sense pèrdua de rigor. Permet l'accés al CALP des del BICS: l'alumne llegeix un concepte acadèmic en la seva forma processal accessible.
- Exemple primer com a bastida ZDP: presentar l'exemple concret ABANS del principi abstracte és aplicar la teoria de Vygotsky. L'alumne ancora el nou concepte en el que ja coneix i llavors pot generalitzar. L'ordre exemple→abstracció és la regla d'or del manual accessible.
Aclariment d'ús — què descriu aquesta rúbrica.
Aquesta rúbrica descriu el manual adaptat per a la LECTURA de l'alumne. No descriu la producció autònoma de l'alumne — la producció és tasca d'un derivat propi. Principi pedagògic MALL: l'alumne llegeix models al màxim del seu abast.
Sub-granularitat dins de A1: es treballa amb fase_lectora: [alfabetica_emergent, alfabetica_fluida]; no hi ha nivell logogràfic perquè el gènere requereix base lecto-escriptora mínima.
Modulació per nivell (format vertical jerarquitzat)
