🏭 IPSmart Project Manager — Línea de Producción v3

Sistema operativo para gestión de módulos de IPSmart

¿Qué es Línea de Producción v3?

Sistema operativo de trabajo para proyectos asistidos por IA. Governa cómo planificar, diseñar, implementar, revisar e iterar — no es código, es proceso.

🎯 Propósito

Corregir el comportamiento natural de las IAs: ir directo al código sin planificar, documentar o revisar seguridad.

📐 Estructura Minimalista

1 archivo de gobernanza (CLAUDE.md) + 3 documentos operativos. Nada de carpetas fantasma ni roles sin usar.

✅ Verificación Real

No solo backend. No solo frontend. Feature = backend + frontend + usuario puede usarla end-to-end.

🔄 Ciclo Completo

Plan → Design → Implement → Review → Iterate. Cada fase tiene reglas claras e imperativas.

Para IPSmart: Usa una Instancia por Módulo

Cada módulo es un proyecto independiente con su Línea de Producción-v3
Kernel compartido (@ipsmart/auth, database, utils)
Mismo ciclo de vida en los 16 módulos
Sin duplicación de gobernanza
Escalable: agregar módulos sin afectar existentes
Railway deploy integrado

Estructura de la Plantilla

📦 Línea de Producción-APP-TEMPLATE-v3/
📄 CLAUDE.md Gobernanza
📄 README.md Quick Start
📄 START_PROJECT_PROMPT.md Proyecto
📁 .claude/commands/
→ init-project.md (Planificación)
→ start-execution.md (Construcción)
→ session-start.md (Resumir sesión)
→ review.md (QA independiente)
→ iterate.md (Post-delivery)
📁 planning/
→ requirements.md (Qué construir)
→ scope.md (Alcance)
→ risks.md (Riesgos)
→ questions.md (Incógnitas)
📁 design/
→ architecture.md (Decisiones técnicas)
→ data_model.md (Entidades y relaciones)
→ api_contracts.md (Endpoints)
→ ui_wireframes.md (Pantallas)
→ design_summary.md (Referencia rápida)
📁 implementation/
→ task_tracker.md (Progreso)
→ user_journeys.md (Features end-to-end)
📁 docs/
→ project_memory.md (Estado actual)
→ work_log.md (Cronología)
→ decision_log.md (Decisiones arquitectónicas)
→ nfr.md (Requisitos no-funcionales)
📁 backend/
→ README.md + código fuente
📁 frontend/
→ README.md + código fuente
📁 tests/
→ README.md + test specs
📁 deployment/
→ docker/ (Dockerfile, compose)
→ easypanel/ (Config panel)
→ scripts/ (Deploy scripts)

Archivos Críticos (Léelos en Orden)

📘

README.md

Quick start: qué es, por qué, estructura básica y comandos disponibles.

⚖️

CLAUDE.md

Gobernanza operativa: reglas imperativas, workflow, security checklist, cuando actualizar qué.

🚀

START_PROJECT_PROMPT.md

Descripción del proyecto. Lo llenas tú al comienza, Claude lo usa para planificación.

📊

design_summary.md

Referencia rápida de arquitectura (~50 líneas). Lees esto antes de cada tarea, no archivos completos.

✅

task_tracker.md

Progreso real. Qué está hecho, qué está in-progress, qué es next.

📝

project_memory.md

Estado actual del proyecto. Se actualiza cada sesión con contexto para reanudar.

Ciclo de Vida Completo

1

/init-project

Fase: Planificación (1-2 días)

Claude crea planning/ y design/ documentos. Tú revisas y apruebas el plan.

2

/start-execution

Fase: Implementación (3-7 días)

Claude construye backend + frontend + tests. Commits automáticos tras cada tarea. No esperes, mira el progreso en task_tracker.

3

/review

Fase: Verificación (1 día)

Subagent independiente verifica: ¿funciona end-to-end? ¿security checklist aplicado? ¿gaps funcionales?

4

/session-start

Fase: Continuidad (cada sesión nueva)

Claude lee project_memory y task_tracker. Resume exactamente donde paró.

5

/iterate

Fase: Cambios post-delivery

Usuario pide cambios. Claude modifica sin replanning. Faster loop.

Clave: Cada sesión comienza con /session-start. No duplica la planificación. Lee project_memory.md y sabe dónde estamos.

Los 5 Comandos Disponibles

🎯 /init-project

Ejecuta una sola vez al principio. Claude planifica el proyecto basado en START_PROJECT_PROMPT.md.

Genera: planning/ y design/ completos

Duración: 1-4 horas

🚀 /start-execution

Ejecuta una sola vez después de aprobar el plan. Claude construye backend + frontend + tests.

Modo: Autónomo. Commits automáticos.

Duración: Variable (3-14 días típicamente)

🔄 /session-start

Ejecuta al inicio de cada sesión nueva. Claude lee project_memory y task_tracker.

No replanes: Continúa exactamente donde paró

Duración: 30 segundos

✅ /review

Ejecuta después de cada milestone. Subagent independiente audita calidad.

Verifica: Funcionalidad, seguridad, gaps

Duración: 2-4 horas

🔧 /iterate

Ejecuta cuando quieres cambios post-delivery. Claude adapta sin replanning.

Más rápido: Ya tiene contexto y arquitectura

Duración: Variable según cambio

Regla clave: Los comandos son los ÚNICOS puntos de entrada. No describes tareas directamente. Describes cambios vía /init-project, /iterate, o durante /start-execution (que ya está corriendo).

Documentación Completa

Aquí están los paths completos. Léelos en este orden.

Orden recomendado:
1. README.md (quick start)
2. CLAUDE.md (gobernanza)
3. MANUAL_DE_USO_FACTORIA.md (philosophía)
4. design_summary.md (architecture reference)

📘 Documentos Principales (IPSmart Project Manager v3)

  • README.md — Quick start y estructura Plantillas/Línea de Producción-de-Apps-v3.zip/Línea de Producción-APP-TEMPLATE-v3/
  • CLAUDE.md — Gobernanza operativa (CRÍTICO) Plantillas/Línea de Producción-de-Apps-v3.zip/Línea de Producción-APP-TEMPLATE-v3/
  • START_PROJECT_PROMPT.md — Template para describir tu proyecto Plantillas/Línea de Producción-de-Apps-v3.zip/Línea de Producción-APP-TEMPLATE-v3/
  • design_summary.md — Referencia rápida arquitectura design/ (creado tras /init-project)

📚 Manual Completo (Filosofía + Evolución)

  • MANUAL_DE_USO_FACTORIA.md — Documento definitivo (2-3h de lectura) Plantillas/Línea de Producción-Eskailet.zip/

🏗️ Documentación por Área

  • backend/README.md — Stack, estructura, configuración Plantillas/Línea de Producción-de-Apps-v3.zip/Línea de Producción-APP-TEMPLATE-v3/backend/
  • frontend/README.md — Framework, estructura, diseño Plantillas/Línea de Producción-de-Apps-v3.zip/Línea de Producción-APP-TEMPLATE-v3/frontend/
  • tests/README.md — Estrategia de testing Plantillas/Línea de Producción-de-Apps-v3.zip/Línea de Producción-APP-TEMPLATE-v3/tests/
  • deployment/docker/README.md — Docker y Railway Plantillas/Línea de Producción-de-Apps-v3.zip/Línea de Producción-APP-TEMPLATE-v3/deployment/docker/

📋 Durante Ejecución (Actualiza Claude automáticamente)

  • task_tracker.md — Qué está done/in-progress/next implementation/
  • project_memory.md — Estado actual, resumir sesión docs/
  • work_log.md — Cronología de lo que se hizo docs/
Shortcut para copiar rutas completas:
# Path base /Users/thomas/Proyectos/ASUS_Agosto_2026/Plantillas/Línea de Producción-de-Apps-v3.zip/Línea de Producción-APP-TEMPLATE-v3/ # Documentos clave + README.md + CLAUDE.md + START_PROJECT_PROMPT.md # Manual completo /Users/thomas/Proyectos/ASUS_Agosto_2026/Plantillas/Línea de Producción-Eskailet.zip/MANUAL_DE_USO_FACTORIA.md