docs(media): add social preview and release prep kit

Author: juanklagos

README.es.md

@@ -15,6 +15,8 @@
   </p>
 </div>
 
+![Social Preview](./docs/assets/social-preview.svg)
+
 ---
 
 ## ⚡ Empieza en 30 segundos
@@ -174,6 +176,8 @@ Paquete obligatorio por feature:
 - Setup clientes: [Recetas](./docs/es/36-recetas-setup-clientes.md)
 - Versionado: [Estrategia](./docs/es/37-estrategia-versionado.md)
 - Roadmap: [Roadmap público](./docs/es/35-roadmap-publico.md)
+- Kit de medios: [Assets y posicionamiento](./docs/es/38-kit-medios.md)
+- Preparación próxima release: [v1.2.0](./docs/es/39-preparacion-v1.2.0.md)
 - Calidad: [Checklists por etapa](./docs/es/21-checklists-calidad-por-etapa.md) · [ADR](./docs/es/24-decisiones-de-arquitectura.md)
 
 ---

README.md

@@ -15,6 +15,8 @@
   </p>
 </div>
 
+![Social Preview](./docs/assets/social-preview.svg)
+
 ---
 
 ## ⚡ Start in 30 Seconds
@@ -174,6 +176,8 @@ Mandatory spec bundle (for each feature):
 - Client Setup: [Recipes](./docs/en/36-client-setup-recipes.md)
 - Versioning: [Strategy](./docs/en/37-versioning-strategy.md)
 - Roadmap: [Public Roadmap](./docs/en/35-public-roadmap.md)
+- Media Kit: [Assets and Positioning](./docs/en/38-media-kit.md)
+- Next Release Prep: [v1.2.0](./docs/en/39-v1.2.0-preparation.md)
 - Quality: [Stage Checklists](./docs/en/21-quality-checklists-by-stage.md) · [ADR](./docs/en/24-architecture-decisions.md)
 
 ---

docs/README.md

@@ -50,6 +50,8 @@ flowchart LR
 - Public roadmap: [EN](./en/35-public-roadmap.md) | [ES](./es/35-roadmap-publico.md)
 - Client setup recipes: [EN](./en/36-client-setup-recipes.md) | [ES](./es/36-recetas-setup-clientes.md)
 - Versioning strategy: [EN](./en/37-versioning-strategy.md) | [ES](./es/37-estrategia-versionado.md)
+- Media kit: [EN](./en/38-media-kit.md) | [ES](./es/38-kit-medios.md)
+- Next release prep: [EN](./en/39-v1.2.0-preparation.md) | [ES](./es/39-preparacion-v1.2.0.md)
 - Continuous refinement: [EN](./en/11-continuous-refinement.md) | [ES](./es/11-refinamiento-continuo.md)
 - Quality checklists: [EN](./en/21-quality-checklists-by-stage.md) | [ES](./es/21-checklists-calidad-por-etapa.md)
 
@@ -59,8 +61,8 @@ flowchart LR
 - Validated prompt bank: [EN](./en/26-validated-prompt-bank.md) | [ES](./es/26-banco-prompts-validados.md)
 
 ## Full index / Índice completo
-- EN docs list: `docs/en/00` to `docs/en/37`
-- ES docs list: `docs/es/00` to `docs/es/37`
+- EN docs list: `docs/en/00` to `docs/en/39`
+- ES docs list: `docs/es/00` to `docs/es/39`
 
 ## Documentation audits / Auditorías de documentación
 - EN: [32-documentation-audit-2026-03-14](./en/32-documentation-audit-2026-03-14.md)

docs/assets/social-preview.svg

@@ -0,0 +1,50 @@
+# Media Kit
+
+## Purpose
+
+This page centralizes reusable public-facing assets for social posts, repository previews, talks, and product positioning.
+
+## Social preview
+
+Suggested asset:
+- `docs/assets/social-preview.svg`
+
+Recommended GitHub social preview size:
+- `1280 x 640`
+
+## Positioning line
+
+Use this as the short descriptor:
+
+```text
+Operational SDD framework with AI guidance and MCP support.
+```
+
+## Short pitch
+
+```text
+Spec-Driven Development Template helps users move from idea to implementation with less friction.
+It combines a starter framework, multi-agent rules, guided documentation, and a local MCP layer for operational workflows.
+```
+
+## Conference/session intro
+
+```text
+This project is not just a documentation template. It is an operational framework for Spec-Driven Development.
+It guides both technical and non-technical users, keeps runnable work isolated in ./www/<project-name>, and gives AI assistants a consistent flow through policy, specs, logbook discipline, and MCP tooling.
+```
+
+## Visual checklist
+
+- Use the social preview asset as the repository preview image
+- Pair it with one screenshot or gif of the MCP flow
+- Keep the message centered on reduced friction and consistent AI-assisted execution
+
+## Suggested next media asset
+
+- 30-45 second terminal demo:
+  - build MCP
+  - connect client
+  - create workspace
+  - create spec
+  - validate and gate

docs/en/38-media-kit.md

@@ -0,0 +1,25 @@
+# v1.2.0 Preparation
+
+## Purpose
+
+This page tracks the minimum bar for the next minor release.
+
+## Proposed release theme
+
+Adoption maturity.
+
+## Minimum scope
+
+- MCP CI stays green
+- integration test stays green
+- README keeps the MCP path visible
+- social preview asset is configured in GitHub
+- one real demo artifact exists outside the repo text docs
+
+## Release checklist
+
+- confirm changelog entries
+- confirm package versions remain aligned
+- confirm examples still match the documented workflow
+- confirm client setup recipes are still accurate
+- confirm release notes mention SDD + MCP together, not separately

docs/en/39-v1.2.0-preparation.md

@@ -0,0 +1,50 @@
+# Kit de medios
+
+## Propósito
+
+Esta página centraliza assets reutilizables de cara al público para posts, preview del repositorio, charlas y posicionamiento del producto.
+
+## Social preview
+
+Asset sugerido:
+- `docs/assets/social-preview.svg`
+
+Tamaño recomendado para GitHub social preview:
+- `1280 x 640`
+
+## Frase de posicionamiento
+
+Usa esto como descriptor corto:
+
+```text
+Framework operativo de SDD con guía para IA y soporte MCP.
+```
+
+## Pitch corto
+
+```text
+Spec-Driven Development Template ayuda a pasar de idea a implementación con menos fricción.
+Combina un framework de arranque, reglas multi-agente, documentación guiada y una capa MCP local para flujos operativos.
+```
+
+## Intro para charla o sesión
+
+```text
+Este proyecto no es solo un template de documentación. Es un framework operativo para Spec-Driven Development.
+Guía tanto a usuarios técnicos como no técnicos, mantiene el trabajo ejecutable aislado en ./www/<project-name> y da a los asistentes de IA un flujo consistente mediante policy, specs, disciplina de bitácora y tooling MCP.
+```
+
+## Checklist visual
+
+- Usa el social preview como imagen de preview del repositorio
+- Combínalo con una captura o gif del flujo MCP
+- Mantén el mensaje centrado en reducir fricción y lograr ejecución consistente asistida por IA
+
+## Siguiente asset sugerido
+
+- demo de terminal de 30-45 segundos:
+  - compilar MCP
+  - conectar cliente
+  - crear workspace
+  - crear spec
+  - validar y pasar compuerta

docs/es/38-kit-medios.md

@@ -0,0 +1,25 @@
+# Preparación v1.2.0
+
+## Propósito
+
+Esta página registra la barra mínima para la siguiente minor release.
+
+## Tema propuesto de la release
+
+Madurez de adopción.
+
+## Alcance mínimo
+
+- la CI MCP sigue en verde
+- el test de integración sigue en verde
+- el README mantiene visible la ruta MCP
+- el social preview queda configurado en GitHub
+- existe al menos un demo real fuera de la documentación textual del repo
+
+## Checklist de release
+
+- confirmar entradas del changelog
+- confirmar que las versiones de paquetes siguen alineadas
+- confirmar que los ejemplos siguen el workflow documentado
+- confirmar que las recetas de setup por cliente siguen siendo correctas
+- confirmar que las notas de release hablen de SDD + MCP como una sola propuesta