# Coautoría de documentos

> Guía un flujo estructurado para redactar documentos, propuestas, especificaciones y documentos de decisión en colaboración. Tres fases: captura de contexto, refinamiento iterativo y prueba con el lector.



Tags: Redacción, Colaboración, Documentación


## Example Prompts

- Coautor de documento de diseño técnico con ciclos de feedback
- Borrador de PRD con iteración guiada
- Redactar y probar un RFC o documento de decisión

URL: https://rakenne.app/es/skills/doc-coauthoring/index.md

Try this skill: https://rakenne.app/a/?skill=doc-coauthoring



## Resumen

Flujo estructurado para redactar en colaboración documentos, propuestas, especificaciones y documentos de decisión. Tres fases: captura de contexto, refinamiento iterativo y prueba con el lector.

## Primeros pasos

Añada sus materiales al espacio del proyecto y active el skill *Coautoría de documentos*. El agente le guiará paso a paso.

## Ejemplo de conversación

> **Usted:** Quiero redactar un documento de decisión de una página para migrar nuestra autenticación a OAuth2. ¿Podemos seguir el flujo estructurado?
>
> **Agente:** Sí. Tres fases: (1) Captura de contexto — preguntaré audiencia, impacto y plantilla; (2) Refinamiento — construiremos cada sección con lluvia de ideas y ediciones; (3) Prueba con el lector — comprobaremos si un lector nuevo puede responder las preguntas clave. Para empezar: ¿Quién es la audiencia principal? ¿Qué deben hacer tras leerlo? ¿Hay plantilla?
>
> **Usted:** Audiencia: responsables de ingeniería y seguridad. Objetivo: go/no-go. Sin plantilla, solo secciones claras.
>
> **Agente:** Propongo: Contexto y problema, Opciones consideradas, Recomendación, Riesgos y mitigación, Próximos pasos. Empezamos por «Opciones» y «Recomendación». Suelte todo el contexto (restricciones, discusiones previas, por qué no otras opciones); luego lluvia de ideas y redacción por secciones. ¿Listo para el contexto?
>
> **Usted:** [Proporciona contexto.]
>
> **Agente:** He creado `decision-doc-auth-oauth2.md` con placeholders. En la sección Recomendación hay 8 posibles puntos según lo que compartió. ¿Cuáles mantener, quitar o combinar? [Lista opciones.] Cuando elija, redactaré esa sección e iteramos.

## Fragmento de salida de ejemplo

Fragmento representativo de un documento de decisión con el flujo de coautoría.

---

# Decisión: Migrar autenticación a OAuth2

## Contexto y problema

La autenticación actual basada en cookies no soporta móvil ni integraciones de terceros. Necesitamos una capa de autenticación estándar y mantenible para web, móvil y API.

## Opciones consideradas

| Opción | Pros | Contras |
|--------|------|---------|
| Mantener sistema actual | Sin coste de migración | No cumple requisitos móvil/API |
| OAuth2 + OIDC | Estándar, soporte de librerías, encaja en nuestro stack | Esfuerzo de migración y gestión de claves |
| Capa de tokens propia | Control total | No estándar, mayor coste a largo plazo |

## Recomendación

Adoptar OAuth2 con OpenID Connect para identidad. Usar [Proveedor X] para emisión y nuestro user store actual. Fase 1: web y API; Fase 2: móvil. Plazo: 8 semanas hasta piloto, 12 hasta despliegue completo.

## Riesgos y mitigación

- **Riesgo:** Revocación de tokens e invalidación de sesión. **Mitigación:** Tokens de acceso de vida corta, rotación de refresh y endpoint de revocación en Fase 2.
- **Riesgo:** Rotación de claves. **Mitigación:** Rotación automatizada y soporte de doble clave durante el traspaso.

## Próximos pasos

1. Aprobación de seguridad del proveedor y flujo (Semana 1).
2. Implementar emisor e integrar en la aplicación web (Semanas 2–6).
3. Piloto con consumidores internos de la API (Semanas 7–8).


---

Back to [Skill Library](https://rakenne.app/es/skills/index.md)