4.0 KiB
agents.md — Punto de entrada del proyecto
Reglas:
- Este archivo es el eslabón más importante. Leerlo siempre antes de cualquier tarea.
- Cada cambio significativo debe reflejarse en este archivo y en los demás archivos del índice.
- Debe ser técnico, claro y detallado para que cualquier humano, agente o IA lo entienda sin explicaciones previas.
- "carga proyecto" = Leer este archivo (agents.md) para comprender las reglas, stack, rutas y objetivos del proyecto.
- "actualizar proyecto" = hacer commit de los cambios pendientes, actualizar
agents.mdy.agente/proyecto_estructura.mdcon el árbol de archivos actual.
Antecedentes
[COMPLETAR — contexto del problema que resuelve este proyecto, por qué existe dentro del ecosistema Telcotronics]
Objetivo general
[COMPLETAR — qué hace el sistema y cuáles son sus responsabilidades principales]
- [COMPLETAR — responsabilidad 1]
- [COMPLETAR — responsabilidad 2]
Stack técnico
| Componente | Tecnología |
|---|---|
| Lenguaje | Go |
| Framework | [COMPLETAR] |
| Base de datos | [COMPLETAR] |
| [Otros] | [COMPLETAR] |
Módulos del sistema
1. [Nombre del módulo]
Estado: ⏳ Pendiente
[Descripción del módulo]
Infraestructura (referencia rápida)
⚠️ La infraestructura es compartida por todo el ecosistema Telcotronics (sigma-robot, sigma-web, sigma-c, sigmac_app, CRM, ERP y otros). La fuente de verdad es
mcp.telcotronics.net— actualmente 🔧 en mantenimiento. Mientras esté en mantenimiento, la fuente alternativa es/home/pablinux/Projects/infraestructura.md. No editar.agente/infraestructura.mddirectamente — ver protocolo de sincronización.
| Parámetro | Valor |
|---|---|
| Dominio público | [COMPLETAR] |
| Puerto interno | [COMPLETAR] |
| Servicio systemd | [COMPLETAR] |
| BD principal | [COMPLETAR] |
| MCP ecosistema | mcp.telcotronics.net 🔧 en mantenimiento |
Correo del ecosistema: usar
no-reply@sigmac.appcon contraseñaSigma.2030@víasmtp.sigmac.app:587(STARTTLS). Desde LAN interna usar192.168.10.111:587. Credenciales disponibles en.agente/infraestructura.md— sección servidor-email.
Para el detalle completo y datos del ecosistema ver
.agente/infraestructura.md.
Documentos del ecosistema (referencia)
Estos documentos viven en
/home/pablinux/Projects/y son la fuente de verdad del ecosistema. No duplicar su contenido aquí — referenciarlos.
| Documento | Descripción |
|---|---|
~/Projects/design-system.md |
Sistema de diseño unificado — colores, tipografía, componentes para Flutter / Vue / Java / PHP |
~/Projects/roadmap.md |
Hoja de ruta estratégica — decisiones técnicas tomadas y pendientes de ejecutar |
~/Projects/infraestructura.md |
Arquitectura completa de servidores, red, CTs y servicios del ecosistema |
~/Projects/prompt_actualizacion.md |
Protocolo de actualización — registrar objetivos, documentar sesiones, sincronizar |
Variables de entorno (.env)
| Variable | Descripción |
|---|---|
| [COMPLETAR] | [COMPLETAR] |
Migraciones
Runner: [COMPLETAR]
| Archivo | Tabla principal | Estado |
|---|---|---|
| — | — | — |
Para arrancar en local
# [COMPLETAR — pasos mínimos para correr el proyecto]
Índice de archivos del proyecto
app_compartir/
├── README.md
├── agents.md # ← LEER PRIMERO
└── .agente/
├── infraestructura.md # Ecosistema — espejo del global
├── proyecto_estructura.md # Árbol de archivos y rutas
├── proyecto_memoria.md # Decisiones técnicas e historial
├── proyecto_errores.md # Registro de errores
├── objetivos.md # Qué debe cumplirse (sin fecha)
└── ideas.md # Posibilidades sin compromiso
Estado global del proyecto
| Módulo | Estado |
|---|---|
| [COMPLETAR] | ⏳ Pendiente |