docs: inicializar estructura de documentacion de agentes

This commit is contained in:
2026-10-12 19:28:02 -05:00
commit 6ea00e4ec5
8 changed files with 3025 additions and 0 deletions
+17
View File
@@ -0,0 +1,17 @@
# ideas.md — Ideas y posibilidades
> Especulativo — "podría ser interesante si...". Sin compromiso.
> Cuando una idea se aprueba y se decide que debe hacerse, moverla a `objetivos.md`.
> Cuando una idea pasa directamente a ejecución, moverla a `proyecto_memoria.md`.
---
## Ideas pendientes
_(anota aquí las ideas con algo de forma)_
---
## Ideas en borrador
_(anota aquí lo que se te ocurra, sin filtro)_
File diff suppressed because it is too large Load Diff
+30
View File
@@ -0,0 +1,30 @@
# objetivos.md — Objetivos del proyecto
> Cosas que deben implementarse o cumplirse, sin importar cuándo.
> Describen QUÉ — no cómo. El cómo va en proyecto_memoria.md cuando se ejecuta.
>
> Flujo: ideas.md → objetivos.md → (en ejecución) → proyecto_memoria.md
---
## Pendientes
| # | Objetivo | Origen | Prioridad |
|---|----------|--------|-----------|
| 1 | Definir funcionalidades clave de app_compartir | pablinux | Alta |
---
## En curso
| # | Objetivo | Iniciado |
|---|----------|----------|
| — | — | — |
---
## Completados
| Fecha | Objetivo | Notas |
|---|---|---|
| 2026-10-12 | Estructura base de agentes y documentación inicializada | Plantilla Telcotronics |
+19
View File
@@ -0,0 +1,19 @@
# proyecto_errores.md — Registro de errores
> Cada error relevante durante desarrollo o producción.
---
## Plantilla
### [FECHA] — [Título corto]
- **Síntoma:** [qué fallaba]
- **Causa raíz:** [por qué ocurrió]
- **Solución:** [qué se cambió]
- **Estado:** ✅ Resuelto | 🔧 En curso | ⏳ Pendiente
---
## Errores registrados
_(ninguno aún)_
+35
View File
@@ -0,0 +1,35 @@
# proyecto_estructura.md — Estructura del proyecto
> Árbol de archivos, rutas HTTP/API y dependencias entre módulos.
> Actualizar al agregar o mover archivos ("actualizar proyecto").
---
## Árbol de archivos
```
app_compartir/
├── README.md
├── agents.md
└── .agente/
├── infraestructura.md
├── proyecto_estructura.md
├── proyecto_memoria.md
├── proyecto_errores.md
├── objetivos.md
└── ideas.md
```
---
## Rutas (HTTP / CLI / eventos)
| Método | Ruta | Handler | Descripción |
|---|---|---|---|
| [COMPLETAR] | [COMPLETAR] | [COMPLETAR] | [COMPLETAR] |
---
## Dependencias entre módulos
[COMPLETAR]
+32
View File
@@ -0,0 +1,32 @@
# proyecto_memoria.md — Memoria técnica del proyecto
> Decisiones tomadas, razonamiento detrás de cada elección y estado actual.
> Actualizar con cada decisión técnica relevante.
---
## Decisiones técnicas
| Fecha | Decisión | Razonamiento |
|---|---|---|
| 2026-10-12 | Inicialización de la estructura estándar de documentación de agentes | Estandarización bajo el ecosistema Telcotronics |
---
## Estado actual
Proyecto recién inicializado. Estructura de documentación base creada. Pendiente definir objetivos específicos, stack detallado y requerimientos.
---
## Pendientes
- [ ] Definir alcance y objetivos del proyecto `app_compartir`
- [ ] Inicializar módulo Go (`go mod init app_compartir`)
- [ ] Definir arquitectura base
---
## Notas y observaciones
[COMPLETAR]