Skill: Documentación técnica por capability

Guía para crear o actualizar documentos técnicos en docs/specs/technical-docs/. Cada documento pertenece a una capability (una capacidad del sistema: facturación, autenticación, catálogo…) y estandariza los modelos de datos, APIs/endpoints, flujos/procesos y diagramas (clases, contexto, contenedores, componentes…) de esa capability, con elementos identificables (MD-XX, API-XX, FL-XX, DG-XX) que las US, TK y WI enlazan como referencia de implementación.

Alcance: este skill produce especificación técnica, no documentación funcional ni código. El valor de negocio y los criterios de aceptación viven en la US (work-define); el plan de implementación vive en las TK/WI (work-plan); las decisiones de arquitectura viven en ADRs (docs/adr/, nunca creados desde aquí). Un documento técnico describe qué forma tienen los modelos, contratos y flujos — no por qué se eligió una tecnología ni cómo se codifica.

La plantilla canónica está en assets/technical-doc-template.md (léela antes de escribir cualquier documento). Los estándares de cada tipo de elemento están en references/element-standards.md.

Subagente

Si el proyecto define el subagente docs-specialist, ejecutar este skill bajo ese subagente. Si no existe en el proyecto:

• Invocación directa por el usuario: ejecutar el flujo normalmente, sin subagente.
• Invocación desde otro skill (work-define, work-plan): ejecutar este skill bajo un subagente genérico (el de propósito general que exponga el cliente). La delegación siempre ocurre en un subagente — con docs-specialist si existe, genérico si no — para aislar el contexto del skill llamador y que la respuesta final sea solo las referencias devueltas.

Este skill es frecuentemente invocado por otros skills mediante un subagente (work-define al detectar que una US define flujos, modelos o APIs; work-plan cuando una TK/WI menciona elementos técnicos sin especificación). En ese modo, ver Modo delegado.