# Sergio Azócar - Software Engineer

> Personal website of Sergio Azócar, Software Engineer with 10+ years of experience in Vue, React, TypeScript, and Nuxt. Designs AI-friendly code and architectures -- software that works for teams, users, and language models. Based in Chile.

## Documentation Sets

- [Sergio Azócar - Complete Site Content](https://sergioazocar.com/llms-full.txt): Complete site content: blog posts on frontend engineering and AI-ready architecture, professional experience, conference talks, mentorship program, and frontend consulting services.

## Main Pages

Key pages of the site with information about Sergio Azócar.

- [About / Sobre mí](https://sergioazocar.com/en/about/): Professional background, 10+ years of experience, career timeline, and contact information.
- [Mentorship / Mentoría](https://sergioazocar.com/en/mentorship/): 1:1 mentorship program in early access (free sessions) for developers — covers Vue, React, TypeScript, architecture, and career growth.
- [Talks & Workshops / Charlas](https://sergioazocar.com/en/talks/): Conference talks and workshops at Nerdearla, PHP México, JSConf Chile — frontend architecture and JavaScript ecosystem.
- [Consulting / Consultoría](https://sergioazocar.com/en/consulting/): Frontend consulting — architecture audits, technical advisory, and workshops for teams building with Vue, React, and TypeScript.
- [Open source](https://sergioazocar.com/en/open-source/): Open-source projects maintained (oxlint-tailwindcss) and contributions to the ecosystem (h3 percent-encoding fix).

## Blog (Spanish)

Technical articles in Spanish about frontend development, architecture, and software engineering.

- [Cómo hacer migraciones con Claude Code y no morir en el intento](https://sergioazocar.com/raw/blog/es/como-hacer-migraciones-con-claude-code-y-no-morir-en-el-intento.md): Tres migraciones reales con Claude Code: el toolchain de un monorepo, screaming architecture y el rediseño de este sitio. Lo que antes tomaba semanas, hoy se hace en días.
- [Context Architecture: el día que entendí que el repo entero es el contexto](https://sergioazocar.com/raw/blog/es/context-architecture-el-repo-entero-es-contexto.md): Cómo nació Context Architecture: el dolor de pelear con agentes de IA en un monorepo real y por qué terminé poniéndole nombre a una forma de estructurar el código.
- [Lo que aprendí construyendo Design Systems y que haría diferente](https://sergioazocar.com/raw/blog/es/lo-que-aprendi-construyendo-design-systems-y-que-haria-diferente.md): Lecciones reales construyendo Design Systems en Vue y TypeScript: errores comunes, decisiones de arquitectura y qué haría diferente hoy.
- [oxlint-tailwindcss: el plugin de linting que Tailwind v4 necesitaba](https://sergioazocar.com/raw/blog/es/oxlint-tailwindcss-el-plugin-de-linting-que-tailwindcss-necesitaba.md): El plugin de linting más completo para Tailwind CSS, nativo para oxlint. 23 reglas con autofix, determinista y diseñado desde cero para Tailwind CSS v4.
- [Screaming Architecture: la clave para un frontend escalable](https://sergioazocar.com/raw/blog/es/screaming-architecture-la-clave-para-un-frontend-escalable.md): Tu proyecto frontend debería gritar lo que hace, no con qué está hecho. Ejemplos concretos de migración, convivencia con frameworks como Nuxt y manejo de shared state.

## Blog (English)

Technical articles in English about frontend development, architecture, and software engineering.

- [Context Architecture: the day I realized the whole repo is the context](https://sergioazocar.com/raw/blog/en/context-architecture-the-whole-repo-is-the-context.md): How Context Architecture started: the pain of fighting AI agents in a real monorepo, and why I ended up giving a name to a way of structuring code.
- [How to migrate with Claude Code and not die trying](https://sergioazocar.com/raw/blog/en/how-to-migrate-with-claude-code-and-not-die-trying.md): Three real migrations with Claude Code: monorepo toolchain, screaming architecture, and a full site redesign. What used to take weeks, now takes days.
- [oxlint-tailwindcss: the linting plugin Tailwind v4 needed](https://sergioazocar.com/raw/blog/en/oxlint-tailwindcss-the-linting-plugin-tailwind-v4-needed.md): The most complete linting plugin for Tailwind CSS, native to oxlint. 23 rules with autofix, deterministic and designed from scratch for Tailwind CSS v4.
- [Screaming Architecture: the key to a scalable frontend](https://sergioazocar.com/raw/blog/en/screaming-architecture-the-key-to-scalable-frontend.md): Your frontend project should scream what it does, not what it is built with. Concrete migration examples, framework coexistence with Nuxt, and shared state handling.
- [What I learned building Design Systems and what I would do differently](https://sergioazocar.com/raw/blog/en/what-i-learned-building-design-systems-and-what-i-would-do-differently.md): Real lessons from building Design Systems in Vue and TypeScript: common mistakes, architecture decisions, and what I would do differently today.

## Notes

- This site is bilingual (Spanish/English). Spanish (default) URLs have no prefix; English URLs use /en/.
- Blog posts are linked across languages via the "union" field.
- The author offers 1:1 mentorship sessions (early access, free) for developers looking to grow their frontend and engineering careers.
- The author offers frontend consulting services: architecture audits, technical advisory, and workshops for development teams.
- Contact: sergioazoc@gmail.com | LinkedIn: linkedin.com/in/sergio-azocar | GitHub: github.com/sergioazoc