@icarusmx/creta 1.5.16 → 1.5.18

package/lib/data/command-help/curl.js

@@ -1,80 +1,270 @@
 export const curl = {
   command: 'curl',
-  description: 'Realiza peticiones HTTP desde la terminal - tu herramienta para APIs',
+  description: 'Realiza peticiones HTTP desde la terminal - para APIs y descargar scripts',
   usage: 'curl [opciones] [URL]',
+
+  learningPath: {
+    intro: 'curl tiene dos usos principales: trabajar con APIs y descargar scripts',
+    progression: [
+      'Primero: Aprende cada flag individual (-L, -s, -f, -S)',
+      'Segundo: Combínalos para formar -fsSL',
+      'Tercero: Úsalo en instalaciones reales (curl -fsSL url | bash)',
+      'Cuarto: Aplícalo a APIs REST (-X, -H, -d)'
+    ],
+    goal: 'Dominar -fsSL te hace ver profesional. Lo verás en toda instalación de herramientas.'
+  },
+
   commonOptions: [
     {
-      flag: '-X',
-      description: 'Especifica el método HTTP (GET, POST, PUT, DELETE)'
+      flag: '-L',
+      description: 'Sigue redirects automáticamente',
+      why: 'Las URLs pueden redirigir. Sin -L, curl se detiene en la primera respuesta',
+      example: 'curl -L https://bit.ly/ejemplo',
+      level: 1
     },
     {
-      flag: '-H',
-      description: 'Agrega un header a la petición'
+      flag: '-s',
+      description: 'Modo silencioso - oculta la barra de progreso',
+      why: 'El progreso es ruido visual cuando haces piping o scripts',
+      example: 'curl -s https://api.ejemplo.com | jq',
+      level: 2
     },
     {
-      flag: '-d',
-      description: 'Envía datos en el body (JSON, form data, etc.)'
+      flag: '-f',
+      description: 'Falla visiblemente en errores HTTP (400+, 500+)',
+      why: 'Sin esto, curl devuelve el HTML de error como si fuera éxito',
+      example: 'curl -f https://api.ejemplo.com/404',
+      level: 3
     },
     {
-      flag: '-i',
-      description: 'Incluye los headers de respuesta en el output'
+      flag: '-S',
+      description: 'Muestra errores incluso en modo silencioso',
+      why: 'Para combinar con -s: silencioso pero con errores visibles',
+      example: 'curl -sS https://api.ejemplo.com',
+      level: 4
     },
     {
-      flag: '-L',
-      description: 'Sigue redirects automáticamente'
+      flag: '-fsSL',
+      description: 'EL COMBO DEFINITIVO - Siempre úsalo para instalar herramientas',
+      why: 'Combina todo: fail on error + silent + show errors + follow redirects',
+      example: 'curl -fsSL https://deno.land/install.sh | bash',
+      level: 5,
+      note: 'Este patrón aparece en TODAS las instalaciones profesionales'
     },
     {
-      flag: '-o',
-      description: 'Guarda el output en un archivo'
+      flag: '-X METHOD',
+      description: 'Especifica método HTTP: GET, POST, PUT, DELETE',
+      context: 'APIs REST',
+      example: 'curl -X POST https://api.ejemplo.com/users'
     },
     {
-      flag: '-s',
-      description: 'Modo silencioso (no muestra progreso)'
+      flag: '-H "Header: valor"',
+      description: 'Agrega headers HTTP a la petición',
+      context: 'Content-Type, Authorization, etc.',
+      example: 'curl -H "Content-Type: application/json"'
+    },
+    {
+      flag: '-d "data"',
+      description: 'Envía datos en el body (JSON, form data)',
+      context: 'POST/PUT requests',
+      example: 'curl -d \'{"nombre": "Juan"}\''
+    },
+    {
+      flag: '-i',
+      description: 'Incluye headers de respuesta en output',
+      context: 'Ver status codes: 200 OK, 404 Not Found, 500 Error',
+      example: 'curl -i https://api.ejemplo.com'
     },
     {
       flag: '-v',
-      description: 'Modo verbose (muestra toda la comunicación)'
+      description: 'Modo verbose - muestra request y response completos',
+      context: 'Debugging profundo',
+      example: 'curl -v https://api.ejemplo.com'
+    },
+    {
+      flag: '-o archivo',
+      description: 'Guarda output en archivo',
+      context: 'Descargar recursos',
+      example: 'curl -o data.json https://api.ejemplo.com/data'
     }
   ],
+
   examples: [
     {
-      command: 'curl https://api.github.com',
-      description: 'GET simple - obtiene datos de una API'
+      title: 'LA PROGRESIÓN: Construyendo hacia -fsSL',
+      commands: [
+        {
+          command: 'curl https://api.github.com',
+          step: 'Paso 1: GET básico',
+          output: 'Verás barra de progreso y datos',
+          problema: 'Demasiado ruido visual'
+        },
+        {
+          command: 'curl -L https://nodejs.org/install',
+          step: 'Paso 2: + sigue redirects',
+          output: 'Sigue automáticamente si la URL redirige',
+          mejora: 'Ahora funciona con URLs acortadas'
+        },
+        {
+          command: 'curl -sL https://nodejs.org/install',
+          step: 'Paso 3: + modo silencioso',
+          output: 'Sin barra de progreso, solo datos',
+          mejora: 'Output limpio, listo para piping'
+        },
+        {
+          command: 'curl -fsSL https://deno.land/install.sh',
+          step: 'Paso 4: + falla en errores + muestra errores',
+          output: 'El combo completo',
+          nivel: 'PROFESIONAL - Memoriza esto'
+        },
+        {
+          command: 'curl -fsSL https://deno.land/install.sh | bash',
+          step: 'Paso 5: + ejecuta con piping',
+          output: 'Descarga e instala en un comando',
+          uso: 'Así instalan los profesionales'
+        }
+      ]
     },
     {
-      command: 'curl -i https://api.github.com/users/octocat',
-      description: 'GET con headers de respuesta incluidos'
+      title: 'CASOS REALES: Instalaciones que verás constantemente',
+      commands: [
+        {
+          command: 'curl -fsSL https://get.docker.com | sh',
+          tool: 'Docker',
+          note: 'Containerización'
+        },
+        {
+          command: 'curl -fsSL https://deno.land/install.sh | sh',
+          tool: 'Deno',
+          note: 'Runtime de JavaScript/TypeScript'
+        },
+        {
+          command: 'curl -fsSL https://sh.rustup.rs | sh',
+          tool: 'Rust',
+          note: 'Lenguaje de sistemas'
+        },
+        {
+          command: 'curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash',
+          tool: 'Homebrew',
+          note: 'Package manager para macOS'
+        },
+        {
+          command: 'curl -fsSL https://get.pnpm.io/install.sh | sh',
+          tool: 'pnpm',
+          note: 'Package manager rápido'
+        }
+      ]
     },
     {
-      command: 'curl -X POST https://api.ejemplo.com/users -H "Content-Type: application/json" -d \'{"nombre": "Juan"}\'',
-      description: 'POST con JSON - envía datos a una API'
+      title: 'TRABAJANDO CON APIs REST',
+      commands: [
+        {
+          command: 'curl https://api.github.com/users/octocat',
+          use: 'GET simple - API pública',
+          response: 'JSON con datos del usuario'
+        },
+        {
+          command: 'curl -X POST https://httpbin.org/post -H "Content-Type: application/json" -d \'{"nombre": "Juan", "edad": 25}\'',
+          use: 'POST con JSON - enviar datos',
+          response: 'Echo del servidor con tus datos'
+        },
+        {
+          command: 'curl -H "Authorization: Bearer TOKEN" https://api.ejemplo.com/protected',
+          use: 'GET autenticado - API privada',
+          response: 'Recursos protegidos'
+        },
+        {
+          command: 'curl -X PUT https://api.ejemplo.com/users/123 -H "Content-Type: application/json" -d \'{"nombre": "Juan Actualizado"}\'',
+          use: 'PUT - actualizar recurso',
+          response: 'Recurso modificado'
+        },
+        {
+          command: 'curl -X DELETE https://api.ejemplo.com/users/123 -H "Authorization: Bearer TOKEN"',
+          use: 'DELETE - eliminar recurso',
+          response: 'Confirmación de eliminación'
+        }
+      ]
     },
     {
-      command: 'curl -X POST https://httpbin.org/post -d "nombre=Juan&edad=25"',
-      description: 'POST con form data - formato URL-encoded'
+      title: 'DEBUGGING: Cuando las cosas no funcionan',
+      commands: [
+        {
+          command: 'curl -i https://api.ejemplo.com',
+          purpose: 'Ver headers de respuesta',
+          verás: 'HTTP/1.1 200 OK, Content-Type, etc.'
+        },
+        {
+          command: 'curl -v https://api.ejemplo.com',
+          purpose: 'Ver comunicación completa',
+          verás: 'Request headers, response headers, handshake SSL, etc.'
+        },
+        {
+          command: 'curl -f https://api.ejemplo.com/404',
+          purpose: 'Forzar error visible en 404/500',
+          verás: 'curl: (22) The requested URL returned error: 404'
+        },
+        {
+          command: 'curl -w "\\nStatus: %{http_code}\\n" https://api.ejemplo.com',
+          purpose: 'Mostrar solo el status code',
+          verás: 'Status: 200'
+        }
+      ]
+    }
+  ],
+
+  relatedLesson: 'APIs y HTTP',
+
+  tips: [
+    'REGLA DE ORO: curl -fsSL url | bash es el patrón universal para instalaciones',
+    'Desglose de -fsSL: (f)ail on error + (s)ilent + (S)how errors + (L)ocation',
+    'Para APIs: curl -X POST -H "Content-Type: application/json" -d \'{"key":"val"}\'',
+    'Para ver status codes: curl -i (headers) o curl -v (todo)',
+    'Siempre usa -L con URLs acortadas o que pueden redirigir'
+  ],
+
+  commonMistakes: [
+    {
+      error: 'Olvidar -L cuando la URL redirige',
+      resultado: 'Verás HTML de redirect en vez del recurso',
+      solución: 'Siempre agrega -L por defecto'
     },
     {
-      command: 'curl -H "Authorization: Bearer tu_token_aqui" https://api.ejemplo.com/protected',
-      description: 'GET con autenticación - usa un token JWT'
+      error: 'No usar -f en scripts automatizados',
+      resultado: 'curl "tiene éxito" incluso con 404/500',
+      solución: 'Usa -f para que falle visiblemente'
     },
     {
-      command: 'curl -L https://github.com',
-      description: 'Sigue redirects automáticamente (importante para URLs acortadas)'
+      error: 'Usar -v en scripts de producción',
+      resultado: 'Logs llenos de ruido innecesario',
+      solución: 'Usa -i para ver solo headers o -s para silencio'
     },
     {
-      command: 'curl -o archivo.json https://api.ejemplo.com/data',
-      description: 'Descarga la respuesta y guárdala en un archivo'
+      error: 'Olvidar comillas en JSON',
+      resultado: 'curl -d {"key":"value"} falla (bash interpreta las llaves)',
+      solución: 'Siempre usa comillas simples: -d \'{"key":"value"}\''
     },
     {
-      command: 'curl -v https://api.ejemplo.com',
-      description: 'Modo verbose - ve toda la negociación HTTP (útil para debugging)'
+      error: 'No especificar Content-Type en POST',
+      resultado: 'El servidor no entiende el formato',
+      solución: 'Siempre agrega -H "Content-Type: application/json"'
     }
   ],
-  relatedLesson: 'APIs y HTTP',
-  tips: [
-    'Pro tip: usa -i siempre para ver los status codes (200, 404, 500) en la respuesta',
-    'Para APIs modernas siempre agrega el header: -H "Content-Type: application/json"',
-    'curl -L es esencial cuando trabajas con URLs acortadas o redirects',
-    'Combina -s (silencioso) con herramientas como jq para parsear JSON: curl -s url | jq'
+
+  proTips: [
+    {
+      tip: 'Combina curl con jq para parsear JSON',
+      command: 'curl -s https://api.github.com/users/octocat | jq .name',
+      output: '"The Octocat"'
+    },
+    {
+      tip: 'Usa alias para curl -fsSL',
+      command: 'alias curlsh="curl -fsSL"',
+      entonces: 'curlsh https://ejemplo.com/install.sh | bash'
+    },
+    {
+      tip: 'Guarda cookies para sesiones',
+      command: 'curl -c cookies.txt -d "user=juan" https://ejemplo.com/login',
+      luego: 'curl -b cookies.txt https://ejemplo.com/dashboard'
+    }
   ]
 }

package/lib/exercises/15-nvim-plugin-architecture.md

@@ -0,0 +1,564 @@
+# Understanding LazyVim Plugin Architecture
+
+<!-- vim: set foldmethod=marker foldlevel=0: -->
+
+## 📖 LazyVim Reading Guide {{{
+
+**Start with:** `zM` (close all folds) → Navigate with `za` (toggle fold)
+
+**Keys for navigation:**
+- `}` - Jump to next section
+- `{` - Jump to previous section
+- `zM` - Close all folds (overview mode)
+- `zR` - Open all folds (detailed mode)
+
+}}}
+
+## 🎯 Purpose {{{
+
+**What:** Understand your LazyVim plugin configuration structure
+**Why:** Know where to add/modify plugins without breaking your setup
+**Time:** 20 minutes
+**Level:** 🟡 Intermediate
+
+**Entrypoint for ariadna nvim configuration:**
+`~/.config/nvim/lua/plugins/`
+
+Each `.lua` file = one plugin configuration (auto-loaded by LazyVim)
+
+}}}
+
+## Plugin Configuration Locations {{{
+
+### Two Important Directories {{{
+
+1. **`~/.config/nvim/lua/config/`** - LazyVim core settings
+   - `lazy.lua` - Plugin manager setup
+   - `options.lua` - Vim options (tab width, line numbers, etc)
+   - `keymaps.lua` - Custom keybindings
+   - `autocmds.lua` - Auto-commands (events)
+
+2. **`~/.config/nvim/lua/plugins/`** - Your plugin overrides
+   - Each file adds/modifies plugins
+   - Auto-loaded alphabetically
+   - This is where YOU make changes
+
+}}}
+
+### Current Plugin Files {{{
+
+```bash
+~/.config/nvim/lua/plugins/
+├── colorscheme.lua           # Theme (Catppuccin Latte)
+├── example.lua               # Reference examples (disabled)
+├── markdown.lua              # Markdown rendering + Glow preview
+├── neo-tree.lua              # File explorer filters
+├── svelte.lua                # Svelte support
+└── telescope_noignore.lua    # Search hidden/ignored files
+```
+
+}}}
+
+}}}
+
+## Part 1: Color Scheme Configuration {{{
+
+### File: `colorscheme.lua` {{{
+
+**Location:** `~/.config/nvim/lua/plugins/colorscheme.lua`
+
+**Purpose:** Override LazyVim's default theme
+
+**Current Setup:**
+```lua
+return {
+  {
+    "catppuccin/nvim",
+    name = "catppuccin",
+    priority = 1000,
+    opts = {
+      flavour = "latte",              -- Light theme
+      transparent_background = true,   -- See terminal bg
+      color_overrides = {
+        latte = {
+          blue = "#1e66f5",            -- Vibrant blues
+        },
+      },
+    },
+  },
+  {
+    "LazyVim/LazyVim",
+    opts = {
+      colorscheme = "catppuccin",
+    },
+  },
+}
+```
+
+**To change theme:**
+1. Edit this file
+2. Save
+3. Run `:Lazy sync` in nvim
+4. Restart nvim
+
+}}}
+
+### Practice: Try Different Flavors {{{
+
+Catppuccin has 4 flavors. Try changing `flavour = "latte"` to:
+
+- `"latte"` - Light (current)
+- `"frappe"` - Light-ish
+- `"macchiato"` - Dark-ish
+- `"mocha"` - Dark
+
+**Exercise:**
+1. Open `~/.config/nvim/lua/plugins/colorscheme.lua`
+2. Change `flavour = "mocha"`
+3. Save (`:w`)
+4. Quit nvim (`:q`)
+5. Reopen nvim
+6. Notice the dark theme
+7. Change back to `"latte"` if you prefer light
+
+}}}
+
+}}}
+
+## Part 2: Markdown Workflow {{{
+
+### File: `markdown.lua` {{{
+
+**Two plugins for different needs:**
+
+1. **render-markdown.nvim** - Inline preview
+   - Auto-renders when you open `.md` files
+   - Shows formatted headings, code blocks, bullets
+   - Works in normal mode (not insert)
+
+2. **glow.nvim** - Full preview
+   - Press `Shift+L` to open terminal preview
+   - Better for reviewing whole documents
+   - Dark theme, 120 char width
+
+**When to use which:**
+- Editing docs → render-markdown (always on)
+- Reviewing docs → Shift+L for glow
+- Presenting docs → Shift+L for clean view
+
+}}}
+
+### Practice: Test Markdown Preview {{{
+
+**Exercise:**
+1. Create a test markdown file: `nvim ~/test-doc.md`
+2. Type this content:
+
+```markdown
+# Test Document
+
+This is a **bold** paragraph with some *italic* text.
+
+## Code Example
+
+```javascript
+console.log("Hello from markdown!");
+```
+
+- Bullet one
+- Bullet two
+```
+
+3. Save (`:w`) and notice render-markdown formatting
+4. Press `Shift+L` to see Glow preview
+5. Press `q` to exit Glow
+6. Delete the test file: `:!rm %`
+
+}}}
+
+}}}
+
+## Part 3: Project-Specific Configs {{{
+
+### File: `neo-tree.lua` {{{
+
+**Hides config clutter from file explorer**
+
+Files hidden:
+- `eslint.config.js`
+- `jsconfig.json`
+- `vite.config.js`
+- `svelte.config.js`
+- `package-lock.json`
+- `.prettierrc`, `.prettierignore`
+- `.npmrc`, `.gitignore`
+
+**Why:** Keep file tree focused on actual code
+
+**To modify:**
+Add filenames to the `hide_by_name` and `never_show` arrays.
+
+}}}
+
+### File: `svelte.lua` {{{
+
+**Sets up Svelte development:**
+
+1. Treesitter parsers: svelte, html, css, js, ts
+2. Svelte LSP with Svelte 5 support
+3. Disables annoying a11y warnings
+
+**Critical for icarus.mx work**
+
+**The config:**
+```lua
+return {
+  -- Treesitter parsers
+  {
+    "nvim-treesitter/nvim-treesitter",
+    opts = function(_, opts)
+      vim.list_extend(opts.ensure_installed, {
+        "svelte", "html", "css", "javascript", "typescript",
+      })
+    end,
+  },
+  -- LSP support
+  {
+    "neovim/nvim-lspconfig",
+    opts = {
+      servers = {
+        svelte = {
+          settings = {
+            svelte = {
+              plugin = {
+                svelte = {
+                  compilerWarnings = {
+                    ["a11y-autofocus"] = "ignore",
+                    ["a11y-click-events-have-key-events"] = "ignore",
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+}}}
+
+### File: `telescope_noignore.lua` {{{
+
+**Overrides LazyVim defaults to search EVERYTHING:**
+
+- `--hidden` - Search dotfiles
+- `--no-ignore` - Search node_modules, .git, etc.
+- Shows gitignored files in neo-tree
+
+**When you need it:**
+- Finding files in node_modules
+- Debugging .git issues
+- Exploring hidden config files
+
+**The config:**
+```lua
+return {
+  {
+    "nvim-telescope/telescope.nvim",
+    opts = function(_, opts)
+      opts.defaults = vim.tbl_deep_extend("force", opts.defaults or {}, {
+        vimgrep_arguments = {
+          "rg", "--color=never", "--no-heading",
+          "--with-filename", "--line-number", "--column",
+          "--smart-case", "--hidden", "--no-ignore",
+        },
+      })
+      opts.pickers = vim.tbl_deep_extend("force", opts.pickers or {}, {
+        find_files = {
+          find_command = { "rg", "--files", "--hidden", "--no-ignore" },
+        },
+      })
+    end,
+  },
+}
+```
+
+}}}
+
+}}}
+
+## Part 4: Adding New Plugins {{{
+
+### The Pattern {{{
+
+**Create a new file:** `~/.config/nvim/lua/plugins/my-plugin.lua`
+
+```lua
+return {
+  {
+    "author/plugin-name",
+    opts = {
+      -- plugin options here
+    },
+  },
+}
+```
+
+**LazyVim automatically loads it** - no imports needed!
+
+}}}
+
+### Example: Add GitHub Copilot {{{
+
+**File:** `~/.config/nvim/lua/plugins/copilot.lua`
+
+```lua
+return {
+  {
+    "zbirenbaum/copilot.lua",
+    cmd = "Copilot",
+    event = "InsertEnter",
+    opts = {
+      suggestion = { enabled = true, auto_trigger = true },
+      panel = { enabled = true },
+    },
+  },
+}
+```
+
+Save → `:Lazy sync` → Restart → Done
+
+}}}
+
+### Example: Add a File Icon Theme {{{
+
+**File:** `~/.config/nvim/lua/plugins/devicons.lua`
+
+```lua
+return {
+  {
+    "nvim-tree/nvim-web-devicons",
+    opts = {
+      override = {
+        md = {
+          icon = "📝",
+          color = "#519aba",
+          name = "Markdown",
+        },
+      },
+    },
+  },
+}
+```
+
+This changes the markdown file icon in neo-tree and telescope.
+
+}}}
+
+### Practice: Add Your Own Plugin {{{
+
+**Exercise: Add a TODO comment highlighter**
+
+1. Create the file:
+```bash
+nvim ~/.config/nvim/lua/plugins/todo-comments.lua
+```
+
+2. Add this config:
+```lua
+return {
+  {
+    "folke/todo-comments.nvim",
+    dependencies = { "nvim-lua/plenary.nvim" },
+    opts = {
+      signs = true,
+      keywords = {
+        TODO = { icon = "✓", color = "info" },
+        HACK = { icon = "⚠", color = "warning" },
+        WARN = { icon = "⚠", color = "warning" },
+        NOTE = { icon = "ℹ", color = "hint" },
+      },
+    },
+  },
+}
+```
+
+3. Save and run `:Lazy sync`
+4. Restart nvim
+5. Try it in a JavaScript file:
+
+```javascript
+// TODO: This will be highlighted
+// HACK: So will this
+// NOTE: And this too
+```
+
+6. Search todos with `:TodoTelescope`
+
+}}}
+
+}}}
+
+## Part 5: Understanding Plugin Loading {{{
+
+### How LazyVim Loads Plugins {{{
+
+When nvim starts:
+
+1. Reads `~/.config/nvim/lua/config/lazy.lua`
+2. This file tells Lazy.nvim to load all files in `plugins/`
+3. Each `.lua` file returns a table of plugin specs
+4. Lazy.nvim merges all specs together
+5. Plugins install/load based on events (`VeryLazy`, `InsertEnter`, etc.)
+
+**Key insight:** Files in `plugins/` don't need to import each other. They're all loaded automatically.
+
+}}}
+
+### Plugin Loading Events {{{
+
+Common events you'll see:
+
+- `VeryLazy` - Load after startup (most plugins)
+- `InsertEnter` - Load when entering insert mode
+- `BufRead` - Load when reading a buffer
+- `FileType` - Load for specific file types
+- `cmd` - Load when command is run
+
+**Example:**
+```lua
+return {
+  {
+    "ellisonleao/glow.nvim",
+    cmd = "Glow",           -- Only loads when :Glow is run
+    ft = { "markdown" },    -- Only for .md files
+  },
+}
+```
+
+This keeps nvim startup fast!
+
+}}}
+
+### Overriding vs Extending {{{
+
+**Overriding** - Replace default config:
+```lua
+opts = {
+  theme = "latte",  -- Replaces entire opts table
+}
+```
+
+**Extending** - Add to default config:
+```lua
+opts = function(_, opts)
+  vim.list_extend(opts.ensure_installed, {
+    "svelte",  -- Adds to existing list
+  })
+end
+```
+
+**Use `opts = function` when you want to keep LazyVim defaults.**
+
+}}}
+
+}}}
+
+## Part 6: Debugging Plugin Issues {{{
+
+### Common Issues {{{
+
+**1. Plugin not loading**
+```vim
+:Lazy           " Open Lazy.nvim UI
+:Lazy log       " Check for errors
+:Lazy sync      " Force re-sync
+```
+
+**2. Config not applying**
+- Did you save the file?
+- Did you restart nvim?
+- Did you run `:Lazy sync`?
+
+**3. Conflicting configs**
+- Check if another file overrides the same plugin
+- LazyVim loads files alphabetically
+- Later files can override earlier ones
+
+}}}
+
+### Useful Commands {{{
+
+```vim
+:Lazy                 " Open plugin manager UI
+:Lazy update          " Update all plugins
+:Lazy sync            " Install/update/clean plugins
+:Lazy clean           " Remove unused plugins
+:Lazy profile         " See plugin load times
+:Lazy log             " View error logs
+
+:checkhealth          " Check nvim health
+:LspInfo              " Check LSP status
+:Mason                " Manage LSP/formatters
+```
+
+}}}
+
+### Practice: Debug a Plugin {{{
+
+**Exercise:**
+
+1. Open Lazy UI: `:Lazy`
+2. Press `p` to see profile (load times)
+3. Press `l` to see logs
+4. Find the `catppuccin` plugin
+5. Press `?` to see help
+6. Press `q` to close
+
+This UI shows you:
+- Which plugins are installed
+- Load order and timing
+- Error messages
+- Update status
+
+}}}
+
+}}}
+
+## 🎯 Outcomes {{{
+
+After this exercise, you can:
+
+✅ Find where your plugins are configured
+✅ Modify existing plugin settings
+✅ Add new plugins without breaking LazyVim
+✅ Understand the difference between `config/` and `plugins/`
+✅ Know your Neovim ariadna entrypoint: `~/.config/nvim/lua/plugins/`
+✅ Debug plugin issues using `:Lazy` commands
+✅ Extend vs override plugin configs
+✅ Use lazy loading for fast startup
+
+**Next Steps:**
+- Explore `example.lua` for more patterns
+- Try adding a plugin you've been wanting
+- Customize keybindings in a new plugin file
+- Browse LazyVim extras: `:LazyExtras`
+
+}}}
+
+## 🧭 Reference Links {{{
+
+- LazyVim docs: https://lazyvim.org
+- Lazy.nvim plugin manager: https://github.com/folke/lazy.nvim
+- Catppuccin theme: https://github.com/catppuccin/nvim
+- Plugin examples: `~/.config/nvim/lua/plugins/example.lua`
+- LazyVim plugins list: https://www.lazyvim.org/plugins
+
+**Your actual config:**
+- Main directory: `~/.config/nvim/`
+- Plugin configs: `~/.config/nvim/lua/plugins/`
+- Core settings: `~/.config/nvim/lua/config/`
+
+}}}

package/lib/exercises/README.md

@@ -112,6 +112,12 @@ Each phase builds on knowledge from previous phases.
 **Time:** Design exercise
 **Level:** 🔴 Advanced
 
+### 15. [Understanding LazyVim Plugin Architecture](./15-nvim-plugin-architecture.md)
+**What:** Master your Neovim plugin configuration structure
+**Why:** Add/modify plugins without breaking your setup
+**Time:** 20 minutes
+**Level:** 🟡 Intermediate
+
 ---
 
 ## 🎯 How to Use These Guides
@@ -153,6 +159,10 @@ Prefer to browse by subject?
 - [Shell Aliases](./13-shell-aliases.md)
 - [curl + Pipes](./06-curl-and-pipes.md)
 
+### Neovim Configuration
+- [Developing Muscle Memory for Neovim](./01-developing-muscle-for-nvim.md)
+- [Understanding LazyVim Plugin Architecture](./15-nvim-plugin-architecture.md)
+
 ### JavaScript & Development
 - [Array & Object Manipulation](./04-array-object-manipulation.md)
 - [SvelteKit First Steps](./05-svelte-first-steps.md)
@@ -170,6 +180,7 @@ Prefer to browse by subject?
 
 ### Meta/Tooling
 - [Install Skills Command](./12-install-skills.md)
+- [Understanding LazyVim Plugin Architecture](./15-nvim-plugin-architecture.md)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icarusmx/creta",
-  "version": "1.5.16",
+  "version": "1.5.18",
   "description": "Salgamos de este laberinto.",
   "type": "module",
   "bin": {