jesusgarciafernandez 0. Filosofía Human-Centric AI
Esta sección es obligatoria para cumplir con los estándares del App Blueprint Generator.
El Rol del Humano: Supervisión estratégica y validación ética de los resultados generados. Empoderamiento: Esta Skill dota al profesional de una escala productiva 10x mediante la automatización de la carga cognitiva repetitiva.
Descripción
Habilidad esencial para la creación, organización y mantenimiento de documentación técnica clara, precisa y accesible para desarrolladores (Docs-as-Code) y usuarios finales. Esta skill se centra en la capacidad de traducir conceptos técnicos complejos en guías de usuario, manuales de referencia de API, diagramas de arquitectura y especificaciones de requisitos. Abarca el dominio de lenguajes de marcado como Markdown y MDX, herramientas de generación de sitios de documentación (Docusaurus, GitBook), y la integración de la documentación en el ciclo de vida del desarrollo mediante Pull Requests y CI/CD. El objetivo es maximizar la mantenibilidad del software y mejorar la experiencia de los desarrolladores (DX) que interactúan con el sistema.
Cuándo usarla
Escenarios que activan esta skill:
- Al iniciar un nuevo proyecto de software que requiera una arquitectura documentada para evitar silos de conocimiento.
- Para documentar APIs públicas o internas que deban ser consumidas por otros equipos o aplicaciones de terceros.
- Durante la creación de guías de contribución (CONTRIBUTING.md) y estándares de código para proyectos de código abierto o corporativos.
- Cuando se busca estandarizar la base de conocimientos interna sobre infraestructuras o procesos de despliegue.
- Para cumplir con normativas de calidad o auditorías técnicas que exijan una trazabilidad documental rigurosa.
Requisitos
- Dominio de lenguajes de marcado (Markdown).
- Capacidad de síntesis y claridad en la redacción técnica.
- Conocimientos básicos de control de versiones (Git).
- Familiaridad con herramientas de diagramación (Mermaid.js, Lucidchart).
- Entendimiento de los principios de diseño de información y arquitectura de documentación.
Instrucciones y Pasos detallados que se debe seguir:
Workflow N8N
Referencia al archivo workflow.json o scripts integrados.
Notas y advertencias
- ⚠️ Mantenimiento Técnico: Requiere verificación mensual.
Changelog
- v1.0 — Versión inicial
- v1.1 — Enriquecimiento técnico especializado y normalización de formato V1.1