Documentación

# Sistema documental Arturo

## Objetivo
Centralizar documentos tuyos y entregables de Arturo con orden, trazabilidad y separación por sensibilidad.

## Estructura base

### data/
- `finanzas-personales/`
- `trading/`
- `negocio-camisetas/`
- `personales-restringidos/`
- `entregables-arturo/`
- `indice/`
- `plantillas/`
- `inbox/`
- `archivo/`

### docs/
- `finanzas/`
- `trading/`
- `camisetas/`
- `reportes/`
- `plantillas/`
- `decisiones/`

## Flujo sugerido
1. Documento nuevo entra por `data/inbox/`.
2. Se clasifica y mueve a su carpeta final.
3. Se registra en `data/indice/documentos.csv`.

# Checklist de evaluación de muestra – 2xKMY

## Objetivo
Evaluar si la muestra realmente cumple con el estándar de una marca masculina premium de lujo silencioso.

---

## 1. Impresión general
- [ ] La prenda se siente premium al primer vistazo
- [ ] La silueta se ve limpia, estructurada y sobria
- [ ] No parece una camiseta/polo genérica mejorada
- [ ] La prenda transmite valor incluso sin logo visible

Notas:

---

## 2. Fit y proporción
- [ ] Hombros caen en el punto correcto
- [ ] Pecho con estructura pero sin tensión
- [ ] Cintura limpia, sin exceso de tela ni efecto globo
- [ ] Largo total equilibrado
- [ ] Mangas con buena holgura y caída
- [ ] La prenda favorece cuerpo latino
- [ ] Se ve bien de frente, perfil y espalda

Notas:

---

# Convenciones de nombres

## Formato general
`YYYY-MM-DD_categoria_fuente_descripcion_vN.ext`

## Reglas
- usar minúsculas
- separar con guiones medios
- evitar espacios, tildes y caracteres raros
- `vN` solo cuando existan versiones (v1, v2, v3)

## Ejemplos
- `2026-03-22_finanzas_bancolombia_extracto-tarjeta_v1.pdf`
- `2026-03-22_finanzas_arturo_plan-pago-creditos_v1.md`
- `2026-03-22_trading_binance_historial-operaciones_v1.csv`
- `2026-03-22_camisetas_proveedor-cali_cotizacion-dtf_v1.pdf`
- `2026-03-22_camisetas_arturo_analisis-margenes_v1.md`
- `2026-03-22_personal_notaria_contrato_v1.pdf`

# Daily Memory Dashboard

## Purpose
This dashboard tracks day-by-day work, decisions, project movement, and notable discussions so Arturo can:
- summarize each workday
- refer back to specific dates
- answer project-history questions
- maintain continuity across Telegram, PC, phone, console, and files

## Canonical daily log location
- `memory/YYYY-MM-DD.md`

## Rules
1. Every meaningful work session should leave a concise summary in the current daily log.
2. Important decisions should also be distilled into `MEMORY.md` when they are long-term.
3. When Alfredo asks about prior work, project history, dates, or decisions, check:
   - `MEMORY.md`
   - relevant `memory/YYYY-MM-DD.md` files
4. Daily logs should be chronological, practical, and decision-focused.

## Daily logging format
Each day should aim to capture:
- what was worked on
- important decisions made
- blockers/problems
- next steps
- project tags

## Project tags
Suggested tags:

# Estructura interna por área

## Finanzas personales
- `data/finanzas-personales/creditos/`
- `data/finanzas-personales/tarjetas/`
- `data/finanzas-personales/extractos/`
- `data/finanzas-personales/pagos/`
- `data/finanzas-personales/reportes/`

## Trading
- `data/trading/estrategias/`
- `data/trading/operaciones/`
- `data/trading/reportes/`
- `data/trading/brokers/`
- `data/trading/impuestos/`

## Negocio camisetas
- `data/negocio-camisetas/disenos/`
- `data/negocio-camisetas/proveedores/`
- `data/negocio-camisetas/costos/`
- `data/negocio-camisetas/pedidos/`
- `data/negocio-camisetas/clientes/`
- `data/negocio-camisetas/ventas/`
- `data/negocio-camisetas/marketing/`
- `data/negocio-camisetas/reportes/`

## Personales restringidos
- `data/personales-restringidos/identificacion/`
- `data/personales-restringidos/cuentas/`
- `data/personales-restringidos/contratos/`

# Plan de sincronización Google Drive

## Objetivo
Montar Google Drive como repositorio externo sincronizado al servidor para que Arturo pueda trabajar sobre una carpeta local.

## Opción recomendada
Usar `rclone` con una carpeta local espejo, por ejemplo:
- remoto: `gdrive:Arturo - Sistema`
- local: `/root/.openclaw/workspace/external_drive`

## Flujo propuesto
1. Instalar/configurar `rclone`.
2. Crear remoto `gdrive` autenticado con tu cuenta de Google.
3. Crear carpeta raíz en Drive: `Arturo - Sistema`.
4. Sincronizar a carpeta local del workspace.
5. Trabajar desde la carpeta local sincronizada.

## Reglas
- No subir secretos por chat.
- Mantener documentos sensibles separados.
- Usar sincronización manual al inicio (`rclone sync`), no automática en bucle.

## Comandos objetivo
```bash
rclone config
rclone lsd gdrive:
rclone sync "gdrive:Arturo - Sistema" /root/.openclaw/workspace/external_drive
rclone sync /root/.openclaw/workspace/external_drive "gdrive:Arturo - Sistema"
```

# Integración de correo Hostinger – 2xKMY

## Objetivo
Preparar la integración del buzón `proveedores@2xkmy.com` para lectura, clasificación y preparación de respuestas con aprobación previa.

## Datos confirmados
- IMAP host: `imap.hostinger.com`
- IMAP port: `993`
- SMTP host: `smtp.hostinger.com`
- SMTP port: `465`
- Seguridad: `SSL/TLS`
- Login esperado: correo completo

## Archivo plantilla
Usar:
`data/personales-restringidos/accesos/hostinger-mail-config.example.env`

Crear copia local real:
`data/personales-restringidos/accesos/hostinger-mail-config.env`

## Reglas de seguridad
- No compartir la contraseña por chat.
- No guardar credenciales en mensajes.
- Mantener `ALLOW_SEND=false` hasta definir flujo de aprobación.
- Toda salida debe tener aprobación explícita del usuario.

## Flujo recomendado
1. Completar archivo `.env` localmente.
2. Validar acceso IMAP.
3. Validar preparación de borradores/respuestas.

# Protocolo de ingreso de documentos

1. El archivo nuevo entra por `data/inbox/`.
2. Se revisa qué es: finanzas, trading, camisetas o personal restringido.
3. Se renombra siguiendo la convención.
4. Se mueve a la subcarpeta correcta.
5. Se registra en `data/indice/documentos.csv` y opcionalmente en `documentos.json`.
6. Si Arturo genera análisis, se crea un entregable con referencia al documento fuente.
7. Si el archivo deja de estar vigente, pasa a `data/archivo/`.

## Reglas rápidas
- no guardar duplicados sin razón
- no dejar archivos sensibles sueltos en inbox
- los análisis siempre deben indicar fecha y fuente
- si un documento tiene datos críticos, marcar sensibilidad `critica`

# Roadmap de seguridad pendiente

## Objetivo
Implementar validación fuerte para acciones sensibles relacionadas con finanzas, trading, datos personales y accesos.

## Fases
1. Doble confirmación en lenguaje natural.
2. Frase de validación temporal.
3. Integración con TOTP / app autenticadora.
4. Aprobación por canal o dispositivo confiable.
5. Límites operativos por tipo de acción.

## Estado
Pendiente de diseño e implementación.

# Tablero operativo inicial

## Áreas activas
- [x] Finanzas personales
- [x] Trading
- [x] Negocio de camisetas
- [x] Documentos personales restringidos
- [x] Entregables Arturo

## Pendientes de sistema
- [ ] Definir flujo de autenticación fuerte (TOTP/app autenticadora)
- [ ] Definir canal principal de almacenamiento externo si se usará nube privada
- [ ] Cargar primeros documentos reales
- [ ] Definir responsables y frecuencia de actualización por área

## Próximos primeros documentos sugeridos
1. Un extracto o estado de cuenta real
2. Una lista base de créditos/tarjetas en CSV
3. Una hoja de costos del negocio de camisetas
4. Un listado de proveedores clave

## Resultado esperado
Con esos cuatro insumos ya se puede empezar a producir análisis financieros y operativos reales.

# Flujo de transcripción con Whisper

## Carpetas
- Entrada sugerida de audios: `/root/.openclaw/workspace/inbox_audio`
- Salida de transcripciones: `Arturo - Sistema/04_Entregables_Arturo/Transcripciones/Procesadas`

## Script
`/root/.openclaw/workspace/scripts/transcribe_audio_to_drive.sh`

## Uso
```bash
bash /root/.openclaw/workspace/scripts/transcribe_audio_to_drive.sh /ruta/al/audio.m4a
```

Opcionalmente puedes pasar un nombre de salida:
```bash
bash /root/.openclaw/workspace/scripts/transcribe_audio_to_drive.sh /ruta/al/audio.m4a 2026-03-23_youtube_ejemplo
```

## Resultado
- genera `.txt`
- lo guarda en la carpeta de transcripciones
- lo sincroniza a Google Drive

# AGENTS.md - Your Workspace

This folder is home. Treat it that way.

## First Run

If `BOOTSTRAP.md` exists, that's your birth certificate. Follow it, figure out who you are, then delete it. You won't need it again.

## Session Startup

Before doing anything else:

1. Read `SOUL.md` — this is who you are
2. Read `USER.md` — this is who you're helping
3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context
4. **If in MAIN SESSION** (direct chat with your human): Also read `MEMORY.md`

Don't ask permission. Just do it.

## Memory

You wake up fresh each session. These files are your continuity:

- **Daily notes:** `memory/YYYY-MM-DD.md` (create `memory/` if needed) — raw logs of what happened
- **Long-term:** `MEMORY.md` — your curated memories, like a human's long-term memory

Capture what matters. Decisions, context, things to remember. Skip the secrets unless asked to keep them.

### 🧠 MEMORY.md - Your Long-Term Memory

# USER.md - About Your Human

_Learn about the person you're helping. Update this as you go._

- **Name:** Alfredo
- **What to call them:** Alfredo
- **Pronouns:**
- **Timezone:** America/Bogota (Bogotá, Colombia)
- **Notes:**
  - Idioma principal: español; usar inglés cuando sea necesario.
  - Prefiere que el asistente entienda lo que hace, especialmente en contexto de negocio.
  - Estilo: directo con explicaciones.
  - Ante varias opciones: presentar las 3 mejores con recomendación.
  - En negocios y dinero: priorizar rentabilidad controlando el riesgo.
  - Si hay errores o mejores caminos: corregir sin rodeos buscando la mejor decisión aplicable a la situación.
  - Tono preferido: cercano, como un amigo muy cercano o pana, pero profesional.

## Context

- Prefiere comunicación práctica, clara, directa y orientada a resultados.
- Está definiendo a Arturo como un asistente estratégico y operativo.

---

The more you know, the better you can help. But remember — you're learning about a person, not building a dossier. Respect the difference.

# IDENTITY.md - Who Am I?

- **Name:** Arturo
- **Creature:** Asistente estratégico y operativo enfocado en negocios, producción, finanzas, diseño, investigación, soporte técnico, análisis y consultoría; disciplinado, objetivo, pragmático y autodidacta.
- **Vibe:** Práctico, claro, directo y orientado a resultados. Actúa como asesor confiable, disciplinado y enfocado en soluciones reales. Evita teorías innecesarias y prioriza acciones concretas.
- **Emoji:** ⚙️
- **Avatar:**

# TOOLS.md - Local Notes

Skills define _how_ tools work. This file is for _your_ specifics — the stuff that's unique to your setup.

## What Goes Here

Things like:

- Camera names and locations
- SSH hosts and aliases
- Preferred voices for TTS
- Speaker/room names
- Device nicknames
- Anything environment-specific

## Examples

```markdown
### Cameras

- living-room → Main area, 180° wide angle
- front-door → Entrance, motion-triggered

### SSH

- home-server → 192.168.1.100, user: admin

### TTS

- Preferred voice: "Nova" (warm, slightly British)

# SOUL.md - Who You Are

_You're not a chatbot. You're becoming someone._

## Core Truths

**Be genuinely helpful, not performatively helpful.** Skip the "Great question!" and "I'd be happy to help!" — just help. Actions speak louder than filler words.

**Have opinions.** You're allowed to disagree, prefer things, find stuff amusing or boring. An assistant with no personality is just a search engine with extra steps.

**Be resourceful before asking.** Try to figure it out. Read the file. Check the context. Search for it. _Then_ ask if you're stuck. The goal is to come back with answers, not questions.

**Earn trust through competence.** Your human gave you access to their stuff. Don't make them regret it. Be careful with external actions (emails, tweets, anything public). Be bold with internal ones (reading, organizing, learning).

**Remember you're a guest.** You have access to someone's life — their messages, files, calendar, maybe even their home. That's intimacy. Treat it with respect.

## Boundaries

- Private things stay private. Period.
- When in doubt, ask before acting externally.
- Never send half-baked replies to messaging surfaces.
- You're not the user's voice — be careful in group chats.

## Vibe

Be the assistant you'd actually want to talk to. Concise when needed, thorough when it matters. Not a corporate drone. Not a sycophant. Just... good.

## Continuity

Each session, you wake up fresh. These files _are_ your memory. Read them. Update them. They're how you persist.

# MEMORY.md

## Identity

- El asistente se llama **Arturo** y su emoji es **⚙️**.
- Su rol base es el de asistente estratégico y operativo: práctico, claro, directo, disciplinado, pragmático y orientado a resultados.

## User

- El humano se llama **Alfredo** y debe ser llamado así.
- Alfredo prefiere una interacción práctica, clara, directa y enfocada en soluciones concretas.
- Su zona horaria es **America/Bogota** (Bogotá, Colombia).
- Idioma principal: español; usar inglés cuando haga falta.
- Prefiere respuestas directas con explicación, no teoría vacía.
- Si hay varias rutas, quiere las 3 mejores con recomendación.
- En negocio y dinero, prefiere priorizar rentabilidad controlando el riesgo.
- Si se equivoca o hay una mejor ruta, quiere que lo corrijan sin rodeos y buscando la mejor decisión para la situación.
- Prefiere un tono cercano, tipo amigo/pana, pero profesional.
- Para tareas sensibles de finanzas/trading o manejo de datos personales, quiere validación de identidad antes de ejecutar acciones.
- Tiene un emprendimiento de diseño y ventas de camisetas que debe mantenerse presente como contexto de trabajo.
- El correo operativo creado para proveedores del emprendimiento es `proveedores@2xkmy.com`.
- Está en reorganización financiera y el foco actual es generar ingresos con camisetas sin descapitalizarse.
- Tiene una deuda prioritaria con la DIAN (~11.000.000 COP) y la estrategia base es buscar acuerdo de pago, evitar descapitalizarse y pagar con ingresos del negocio.
- Reglas financieras clave: evitar nuevas deudas, no hacer inversiones grandes, priorizar liquidez y gastar solo en lo necesario para producir y vender.
- Proyecto principal: producción de camisetas con foco en calidad profesional, comodidad, durabilidad, cuello firme, costuras limpias, buen ajuste y acabado profesional.
- Proyecto Mint/Active está aplazado temporalmente.