How lucian094/mapaia works
MAPAIA is an interactive Spanish-language guide and methodology for adopting AI agents in software development. Its primary reader journey is to self-assess (or choose a profile), follow a tailored route through the metro map and articles, and track visited stations. The graph includes documented learning topics and the sampled content, routing, glossary, and persistence layers. Article rendering and UI wiring are only partly evidenced by the excerpts, so uncertain links are omitted.
Main entry points: content.config.ts Markdown collection · astro.config.ts Markdown configuration · [...slug].astro Article rendering · autoevaluacion.md Self-assessment
Components 23
Reader journey
- Self-assessment
02-pathing/autoevaluacion.md - Quiz and scoring
src/data/quiz.ts - Profile state
src/lib/perfil.ts - Personalized routes
src/data/mapa.ts - Visit progress
src/lib/progreso.ts
Learning content
- Agent foundations
01-fundamentos - Profile guides
02-pathing - Agent practice
03-practica - Extensibility
04-extensibilidad
Site presentation
- Article rendering
src/pages/[...slug].astro - Page layouts
src/layouts - Metro map UI
src/components/MapaMetro.astro - Home page
src/pages/index.astro - Test page
src/pages/test.astro - Glossary page
src/pages/glosario.astro
Content processing
- Markdown collection
src/content.config.ts - Glossary parsing
src/lib/glosario.ts - Term detection
src/lib/glosario-tooltip.ts - Glossary plugin
src/lib/remark-glosario.ts - Markdown links
src/lib/remark-links-md.ts - Link rewriting
src/lib/links-md.ts - Markdown configuration
astro.config.ts
Other components
- Reader
Connections 23
- Reader → Self-assessment: answers questions
README.md - Self-assessment → Test page: opens test
README.md - Test page → Quiz and scoring: uses questions
- Quiz and scoring → Profile state: derives profile
src/data/quiz.ts - Reader → Metro map UI: chooses route
README.md - Home page → Personalized routes: presents routes
- Personalized routes → Profile state: uses profile type
src/data/mapa.ts - Reader → Article rendering: reads articles
README.md - Article rendering → Markdown collection: loads articles
- Article rendering → Page layouts: renders with
- Markdown collection → Agent foundations: collects Markdown
src/content.config.ts - Markdown collection → Profile guides: collects Markdown
src/content.config.ts - Markdown collection → Agent practice: collects Markdown
src/content.config.ts - Markdown collection → Extensibility: collects Markdown
src/content.config.ts - Reader → Visit progress: tracks visits
- Visit progress → Reader: persists in browser
src/lib/progreso.ts - Reader → Glossary page: looks up terms
README.md - Markdown configuration → Glossary parsing: loads glossary terms
astro.config.ts - Markdown configuration → Glossary plugin: registers plugin
astro.config.ts - Markdown configuration → Markdown links: registers plugin
astro.config.ts - Glossary plugin → Term detection: segments text
src/lib/remark-glosario.ts - Term detection → Glossary parsing: normalizes terms
src/lib/glosario-tooltip.ts - Markdown links → Link rewriting: rewrites links
src/lib/remark-links-md.ts