| name | prddiario |
| description | Gestiona tareas diarias con formato jerárquico legible, documentación completa (descripción + solución) con timestamps, y genera reportes automáticos de horas trabajadas. Usa cuando necesites crear PRD diario, registrar tareas completadas, gestionar pendientes, o generar reportes de horas. Incluye scripts Python/PowerShell para automatizar todo. |
| license | MIT |
PRD Diario - Gestor de Tareas Diarias
Descripción General
Automatiza la creación y organización de Documentos de Requisitos de Productos (PRD) diarios para un seguimiento estructurado de tareas. Mantiene separadas las carpetas de PRD, trabajo diario, reportes y archivos. Ideal para:
- Organización flexible - Configura dónde guardar cada tipo de documento
- Carpetas PRD centralizadas - Todos los
PRD_YYYYMMDD.md en un solo lugar
- Trabajo diario organizado - Carpetas YYMMDD separadas para documentos del día
- Reportes consolidados - Resúmenes y análisis en una carpeta dedicada
- Archivo histórico - Días completados archivados para referencia
- Registro de tareas con timestamps exactos y documentación completa
- Resúmenes automáticos que analizan metadatos de archivos
- Rastreo de inicio de jornada usando fecha de creación de documentos
- Reportes de horas trabajadas y auditoría completa
Cuándo Usar Este Skill
Use este skill cuando:
- Necesite iniciar el día y crear la carpeta + PRD diario
- Quiera registrar tareas completadas con hora exacta
- Deba documentar soluciones de manera estructurada
- Tenga tareas pendientes que requieran seguimiento
- Necesite guardar conversaciones o documentos del día en un solo lugar
- Quiera generar resumen del día automático con metadatos
- Necesite reportes de horas trabajadas al final del día
- Desee saber cuándo empezó el día (primer documento creado)
- El usuario pida "crear PRD diario", "iniciar día", "registrar tarea", "resumen del día" o "generar reporte de horas"
Flujo de Trabajo
Fase 0: Configuración Inicial (IMPORTANTE!)
Primera ejecución - Configura tus carpetas:
python scripts/setup_config.py
Este wizard interactivo te permite elegir dónde guardar:
- 📄 PRD_DOCUMENTS: Donde van todos los
PRD_YYYYMMDD.md
- 📁 DAILY_WORK: Donde se crean carpetas YYMMDD por día
- 📊 REPORTS: Donde se generan resúmenes y reportes
- 📦 ARCHIVES: Donde archivar días completados (opcional)
Estructura recomendada:
~/Documents/prd_diarios/
├── PRD_DOCUMENTS/ ← Todos los PRD centralizados
│ ├── PRD_20260225.md
│ ├── PRD_20260226.md
│ └── PRD_20260227.md
├── DAILY_WORK/ ← Trabajo diario por carpetas
│ ├── 260225/
│ │ ├── README.md
│ │ ├── conversacion_cliente.md
│ │ └── notas_meeting.md
│ ├── 260226/
│ └── 260227/
├── REPORTS/ ← Resúmenes y reportes
│ ├── RESUMEN_260225.md
│ ├── RESUMEN_260226.md
│ ├── HORAS_PRD_20260225.md
│ └── HORAS_PRD_20260226.md
└── ARCHIVES/ ← Días completados
└── (semanas antiguas)
Ver configuración actual:
python scripts/setup_config.py --show
Resetear configuración:
python scripts/setup_config.py --reset
Fase 1: Inicio del Día (NUEVO)
Mientras trabajas:
- Registrar tareas: Añade tareas completadas con timestamps
- Guardar documentos: Guarda conversaciones, notas, archivos en la carpeta del día
- Actualizar PRD: Documenta descripción + solución de cada tarea
Ejemplo de estructura durante el día:
260225/
├── README.md
├── PRD_20260225.md
├── conversacion_cliente_proyecto_X.md
├── notas_meeting_equipo.md
└── diagrama_arquitectura.png
Mientras trabajas:
- Registrar tareas: Añade tareas completadas con timestamps en el PRD
- Guardar documentos: Guarda conversaciones, notas, archivos en DAILY_WORK/260225/
- Actualizar PRD: Documenta descripción + solución de cada tarea en PRD_DOCUMENTS/
Estructura típica durante el día:
DAILY_WORK/260225/
├── README.md
├── conversacion_cliente_proyecto_X.md
├── notas_meeting_equipo.md
└── diagrama_arquitectura.png
PRD_DOCUMENTS/
└── PRD_20260225.md ← Actualizado con tareas
Fase 3: Fin del Día
Al terminar la jornada:
- Generar resumen del día: Ejecuta
generate_day_summary.py
- Analiza metadatos: Lee fechas de creación de todos los archivos
- Calcula horas: Determina inicio (primer archivo) y tareas realizadas
- Crea reporte: Genera RESUMEN_YYMMDD.md con toda la información
Estructura final:
260225/
├── README.md
├── PRD_20260225.md
├── conversacion_cliente_proyecto_X.md
├── notas_meeting_equipo.md
├── diagrama_arquitectura.png
├── RESUMEN_260225.md # ← Generado automáticamente
└── HORAS_PRD_20260225.md # ← Opcional: reporte de horas detallado
Fase 3 (Antigua): Registrar Tareas Realizadas
Para cada tarea completada:
### ✅ N. Nombre de la Tarea — **HH:MM**
**Descripción**
Contexto y motivo de la tarea. Qué problema se resolvía, de dónde venía la solicitud.
**Solución**
Qué se hizo y cómo se resolvió. Pasos tomados, tecnologías usadas, resultado final.
Ejemplo:
### ✅ 1. Revisar tareas asignadas en Trello — **09:00**
**Descripción**
Morning standup: Revisión de tareas pendientes del sprint. Se identificaron 12 tareas en el backlog y 3 en progreso.
**Solución**
Se revisaron prioridades con el equipo. Se replanificó una tarea de baja prioridad. Se inició trabajo en tarea crítica de cliente.
Fase 3: Gestionar Tareas Pendientes
Para tareas incompletas:
### ⏳ X. Nombre de Tarea Pendiente — **HH:MM**
**Descripción**
Contexto de la tarea pendiente...
**Estado**
En curso / Bloqueado / En espera
Fase 4: Generar Reportes de Horas
Al final del día, para generar un reporte automático:
Python:
python scripts/generate_hours_report.py PRD_260216.md
PowerShell:
.\scripts\generate_hours_report.ps1 -PRDFile "PRD_260216.md"
Genera automáticamente HORAS_PRD_260216.md con:
- Desglose por tarea con duración
- Horas totales trabajadas
- Promedio por tarea
- Timestamp de generación
Resumen Ejecutivo
- Fecha: DD de MMMM de YYYY
- Tareas completadas: N
- Tareas pendientes: M
- Total de horas: Xh YYm
Tareas Realizadas
✅ 1. Primera Tarea — 09:00
Descripción
...
Solución
...
✅ 2. Segunda Tarea — 10:30
Descripción
...
Solución
...
Tareas Pendientes
⏳ 1. Tarea Pendiente — 16:00
Descripción
...
Estado
En curso
Notas Adicionales
- Observaciones importantes
## Patrón de Uso - Paso a Paso
### ⚙️ Primer Día - Configuración Inicial
Usuario: "Configura el skill prddiario"
Claude:
- Ejecuta: python scripts/setup_config.py
- Pregunta interactiva por rutas:
- ¿Dónde guardar los PRD?
- ¿Dónde guardar el trabajo diario?
- ¿Dónde guardar los reportes?
- ¿Dónde archivar días completados?
- Pregunta sobre features (resúmenes automáticos, metadata, etc.)
- Guarda configuración en config.json
- Confirma:
✅ PRD_DOCUMENTS configurado
✅ DAILY_WORK configurado
✅ REPORTS configurado
✅ ARCHIVES configurado
### Iniciar el Día
Usuario: "Vamos a iniciar el día" o "Crear PRD de hoy"
Claude:
- Ejecuta: python scripts/create_daily_folder.py
→ Crea 260225 en DAILY_WORK/
- Ejecuta: python scripts/create_daily_prd.py
→ Crea PRD_20260225.md en PRD_DOCUMENTS/
- Confirma:
✅ Carpeta creada: ~/Documents/prd_diarios/DAILY_WORK/260225/
✅ PRD creado: ~/Documents/prd_diarios/PRD_DOCUMENTS/PRD_20260225.md
**Estructura después:**
DAILY_WORK/260225/ ← Nuevas conversaciones aquí
└── README.md
PRD_DOCUMENTS/
└── PRD_20260225.md ← Actualizar con tareas del día
### Guardar Documentos Durante el Día
Usuario: "Guarda esta conversación en el día de hoy"
Claude:
- Identifica fecha actual (ej: 260225)
- Guarda archivo en: DAILY_WORK/260225/
- El archivo queda organizado junto a otros documentos del día
**Ejemplos de archivos guardados:**
DAILY_WORK/260225/
├── README.md
├── conversacion_proyecto_X_cliente.md ← Nuevo
├── notas_meeting_equipo.md ← Nuevo
└── diagrama_arquitectura.png ← Nuevo
### Crear PRD Nuevo (Método Original)
Usuario: "Vamos a crear el PRD de hoy"
Claude:
- Obtiene fecha actual (ej: 16 de febrero de 2026)
- Si use_daily_folders=true, crea carpeta 260216
- Crea PRD_20260216.md dentro de la carpeta (o en ruta especificada)
- Abre el archivo para edición
### Registrar Tarea Completada
Usuario: "Completé: Revisar correos. Tomó 45 minutos. Fueron 23 correos, respondí prioritarios."
Claude:
- Obtiene hora actual: 10:30
- Calcula número siguiente en PRD
- Actualiza PRD_DOCUMENTS/PRD_20260225.md:
✅ N. Revisar correos — 10:30
Descripción
Revisión diaria de correos...
Solución
Se procesaron 23 correos nuevos...
- Confirma actualización en PRD
**Actualización en:**
PRD_DOCUMENTS/PRD_20260225.md ← Se actualiza con tarea
### Generar Reporte de Horas
Usuario: "Genera el reporte de horas de hoy"
Claude:
- Ejecuta: python scripts/generate_hours_report.py PRD_20260225.md
- Lee PRD_DOCUMENTS/PRD_20260225.md
- Extrae tareas y timestamps
- Calcula duración entre tareas
- Genera REPORTS/HORAS_PRD_20260225.md
- Confirma generación:
✅ Reporte guardado: ~/Documents/prd_diarios/REPORTS/HORAS_PRD_20260225.md
📊 Horas trabajadas: 7h 30m
📋 Tareas registradas: 5
**Output:**
REPORTS/HORAS_PRD_20260225.md
- Desglose por tarea
- Duración de cada una
- Horas totales
- Promedio
### Generar Resumen del Día
Usuario: "Dame un resumen del día" o "Genera resumen del día"
Claude:
- Ejecuta: python scripts/generate_day_summary.py
- Analiza DAILY_WORK/260225/
- Lee metadatos de TODOS los archivos
- Determina hora de inicio (primer archivo creado)
- Extrae tareas del PRD
- Calcula horas trabajadas
- Genera REPORTS/RESUMEN_260225.md con:
- Información general (hora inicio, tareas, horas, documentos)
- Tareas realizadas con timestamps
- Tareas pendientes
- Lista de documentos con metadatos
- Confirma:
✅ Resumen guardado: ~/Documents/prd_diarios/REPORTS/RESUMEN_260225.md
📊 Estadísticas:
- Tareas completadas: 5
- Tareas pendientes: 2
- Horas trabajadas: 7h 30m
- Documentos: 8
**Output:**
REPORTS/RESUMEN_260225.md
- Información del día
- Tareas completadas/pendientes
- Documentos generados
- Análisis de metadatos
## Características Clave
✅ **Carpetas Diarias** - Organiza todo en carpetas YYMMDD (260225, 260226...)
✅ **Gestión Unificada** - PRD + conversaciones + documentos en un solo lugar
✅ **Metadatos de Archivos** - Rastrea fecha creación/modificación de documentos
✅ **Hora de Inicio Automática** - Detecta cuándo empezó el día (primer archivo)
✅ **Formato Jerárquico** - Estructura clara con encabezados H3 y emojis
✅ **Timestamps Exactos** - Registra hora de inicio de cada tarea
✅ **Documentación Completa** - Descripción + Solución para auditoría
✅ **Resumen Automático del Día** - Analiza carpeta y genera reporte completo
✅ **Reportes de Horas** - Scripts Python/PowerShell generan horas trabajadas
✅ **Gestión de Pendientes** - Seguimiento de tareas en progreso
✅ **Git-friendly** - Markdown puro, fácil de versionear
✅ **Rastreabilidad Completa** - Auditoría diaria con toda la información
## Ejemplos de Registros Reales
### Tarea Simple (Bug Fix)
```markdown
### ✅ 2. Corregir validación en formulario — **11:15**
**Descripción**
Usuario reportó error en validación de email en formulario de contacto. La validación rechazaba emails válidos con subdominios. Impacta signup de nuevos usuarios.
**Solución**
Se identificó regex incorrecto en campo email (patrón muy restrictivo). Se actualizó patrón de validación a RFC 5322. Se testeó con 50 casos de prueba. Desplegado en producción. Validado con clientes específicos.
Tarea Compleja (Integración)
### ✅ 5. Integración con API de Stripe — **14:45**
**Descripción**
Cliente solicita añadir nuevo proveedor de pagos (Stripe) al sistema. Requerido conectar a sistema actual, modificar flujo de checkout y actualizar documentación. Esta es actividad crítica para Q1.
**Solución**
Se implementó cliente Stripe official. Se integraron webhooks para confirmación de pago y reembolsos. Se actualizó checkout para soportar múltiples proveedores (Stripe + PayPal). Testing completado con casos de éxito y error. Demo realizado con cliente. Documentación actualizada.
Scripts Disponibles
setup_config.py (NUEVO - IMPORTANTE!)
Asistente interactivo para configurar las rutas de trabajo.
python scripts/setup_config.py
python scripts/setup_config.py --show
python scripts/setup_config.py --reset
Características:
- Interfaz interactiva y amigable
- Configura PRD_DOCUMENTS, DAILY_WORK, REPORTS, ARCHIVES
- Valida rutas y crea directorios
- Guarda configuración en config.json
- Compatible con macOS, Linux y Windows
create_daily_folder.py
create_daily_folder.py
Crea una carpeta diaria con formato YYMMDD en la carpeta DAILY_WORK.
python scripts/create_daily_folder.py [--date 20260225] [--path ./custom]
Características:
- Crea carpeta en DAILY_WORK (configurado en setup_config.py)
- Formato YYMMDD (260225 para 25 de febrero de 2026)
- Genera README.md dentro con información del día
- Verifica si la carpeta ya existe antes de crear
Estructura creada:
DAILY_WORK/260225/
├── README.md
└── (vacía, lista para documentos)
create_daily_prd.py (ACTUALIZADO)
Crea un nuevo archivo PRD_YYYYMMDD.md en la carpeta PRD_DOCUMENTS.
python scripts/create_daily_prd.py [--date 20260216] [--path ./custom]
Características:
- Crea PRD en carpeta PRD_DOCUMENTS (configurada en setup_config.py)
- Nombre: PRD_20260225.md
- Incluye estructura inicial y timestamp
- También usable para PRDs de otros días/proyectos
Estructura creada:
PRD_DOCUMENTS/
├── PRD_20260225.md
├── PRD_20260226.md
└── PRD_20260227.md
create_daily_prd.ps1
Versión PowerShell de creación de PRD con soporte para carpetas diarias.
.\scripts\create_daily_prd.ps1 -Date "2026-02-16" -Output "./path"
generate_day_summary.py (ACTUALIZADO)
Analiza todos los archivos de la carpeta diaria (DAILY_WORK/YYMMDD/) y genera un resumen completo en REPORTS/.
python scripts/generate_day_summary.py [--date 20260225] [--path ./custom] [--output ./custom]
Características:
- Lee metadatos de todos los archivos en DAILY_WORK/YYMMDD/
- Determina hora de inicio del día (primer archivo creado)
- Extrae tareas del PRD (completadas y pendientes)
- Calcula horas trabajadas basado en timestamps
- Lista todos los documentos generados en el día
- Guarda RESUMEN_YYMMDD.md en carpeta REPORTS
Input: DAILY_WORK/260225/ (carpeta con documentos del día)
Output: REPORTS/RESUMEN_260225.md
generate_hours_report.py (ACTUALIZADO)
Analiza un PRD diario y genera reporte detallado de horas trabajadas en carpeta REPORTS/.
python scripts/generate_hours_report.py PRD_20260216.md [--output ./custom]
Características:
- Lee el PRD de PRD_DOCUMENTS/
- Extrae timestamps de tareas
- Calcula duración entre tareas
- Guarda reporte en carpeta REPORTS
- Genera desglose detallado de horas
Input: PRD_DOCUMENTS/PRD_20260225.md
Output: REPORTS/HORAS_PRD_20260225.md
generate_hours_report.ps1
Versión PowerShell de generación de reportes.
.\scripts\generate_hours_report.ps1 -PRDFile "PRD_260216.md" -Output "./reports"
Checklist de Completitud
Configuración Inicial (Primera vez):
Cada Día:
Fin de Día:
Referencias
Licencia
MIT License - Libre para usar y modificar
