agency-pm

name	agency-pm
description	Gestion de proyectos para agencias de software. Onboarding de proyectos nuevos, weekly reports, seguimiento de owners, status updates. Trigger en "nuevo proyecto", "weekly report", "status del proyecto", "onboarding cliente", "crear estructura proyecto".

Agency PM - Project Management

Framework de gestion de proyectos para agencias de software. Incluye onboarding, clasificacion por tiers, weekly reports y seguimiento.

Originalmente desarrollado por Muno Labs para gestionar sus proyectos de clientes. Adaptable a cualquier agencia o equipo de desarrollo.

Archivos en este Skill

agency-pm/
├── SKILL.md
├── config.json              # Tu configuración (crear desde config.example.json)
├── config.example.json      # Template de configuración
├── references/
│   ├── way-of-working.md    # Estructura, tiers, tipos de proyecto
│   ├── owner-checklist.md   # Responsabilidades del owner
│   └── tools-integration.md # Linear, Notion, Meet
└── templates/
    ├── weekly-notes.md      # Template notas semanales
    └── weekly-report.md     # Template reporte al cliente

⚙️ Setup — Primera Vez

Al iniciar, verificar si existe config.json.

Si NO existe config.json:

Hacer estas preguntas antes de arrancar:

1. "¿Cómo se llama tu agencia?"
2. "¿Cuál es el umbral de revenue para considerar un proyecto Tier 1?
    (ej: +$5K USD/mes, +$3M COP/mes — usá la moneda que manejás)"
3. "¿Quiénes son los socios o directores que hacen de Owner en Tier 1?"
4. "¿Usás Linear para gestionar issues?" (sí/no)
5. "¿Usás Notion para documentación?" (sí/no)

Crear config.json con las respuestas y confirmar: "Guardé tu configuración. Podés editarla en config.json cuando cambie algo."

Si SÍ existe config.json:

Leerlo y usar tier1_revenue_threshold para clasificar proyectos en vez de valores hardcodeados.

Flujo: Onboarding Nuevo Proyecto

1. Clasificar el Proyecto

Preguntar o determinar:

Pregunta	Opciones
¿Quién es el Owner?	Nombre (socio o delegado)
¿Es Tier 1 o Tier 2?	Ver references/way-of-working.md
¿Tipo de proyecto?	Project Based / Service Based / Product Based

2. Crear Estructura de Carpetas

Para Project Based (entrega finita):

[cliente]/activo/[proyecto]/
├── README.md           # Del template
└── meetings.md         # Opcional

Para Service/Product Based (ongoing):

[cliente]/activo/[proyecto]/
├── README.md
├── Soporte.md          # OBLIGATORIO
├── meetings.md
└── weekly-notes.md

3. Configurar Herramientas

• Crear proyecto en Linear (team correcto)
• Crear espacio en Notion
• Crear canal Slack si aplica
• Agregar al directorio de clientes

Flujo: Weekly Report

1. Recolectar Información

Leer de estas fuentes:

• weekly-notes.md del proyecto
• Linear: tickets completados/en progreso
• Notion: notas de reuniones recientes

2. Generar Reporte

Usar templates/weekly-report.md:

• Resumen ejecutivo (3 bullets)
• Completado esta semana
• En progreso
• Próximos pasos
• Blockers (si hay)

3. Entregar

• Formato: Markdown o adaptado a Notion/email
• Frecuencia: Semanal (antes del weekly con cliente)

Flujo: Status Check

Verificar para cada proyecto activo:

• ¿Tiene owner definido?
• ¿Weekly interno esta semana?
• ¿Weekly con cliente programado?
• ¿Linear actualizado?
• ¿Documentación al día?

Ver references/owner-checklist.md para lista completa.

Gotchas

1. Tier no es fijo: Un proyecto puede cambiar de Tier 2 a Tier 1 si crece en importancia estratégica.

2. Project Based NO necesita Soporte.md: El proyecto termina, no hay soporte ongoing.

3. Owner ≠ quien hace el trabajo: El owner coordina y es punto de contacto, puede delegar ejecución.

4. Weekly report ≠ Weekly notes:

   • weekly-notes.md = interno, input crudo
   • weekly-report.md = para cliente, curado

5. Linear es la fuente de verdad para tareas. No duplicar tracking en otros lugares.

6. Notion para docs, no para tareas: Documentación y notas van a Notion. Tareas van a Linear.

Clasificación de Tiers

Tier 1 - Alta Prioridad

• Owner: Socio / Director
• Revenue alto O estratégicamente importante
• Reuniones semanales obligatorias

Tier 2 - Delegable

• Owner: Puede ser miembro del equipo
• Revenue menor, más operativo
• Supervisión quincenal de socios

Tipos de Proyecto

Tipo	Duración	Facturación	Ejemplo
Project Based	Finita	Milestones	App nueva, migración
Service Based	Ongoing	Retainer mensual	Fractional CTO
Product Based	Ongoing	Por consumo/mes	SaaS, plataforma

Integraciones

Ver references/tools-integration.md para:

• Crear tickets con /linear en Slack
• Sincronizar Notion ↔ Linear
• Generar transcripts de Meet