agency-pm

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