Imported from dalarconrub/coworkia (AGENTS.md). Install upstream with npx skills add dalarconrub/coworkia. Copyright stays with the author.

AGENTS.md

Este archivo es leído por Codex y también por Copilot. Si eres Copilot: ignora la identidad de este archivo y usa .github/copilot-instructions.md. Si eres Codex: aplica este archivo completo.

Memoria del proyecto - lectura obligatoria al arrancar

Antes de responder en una sesión nueva, carga (en orden):

1. memory/INDEX.md - mapa de recursos.
2. memory/PURPOSE.md - qué es Coworkia.
3. memory/STRUCTURE.md - cómo está organizado.

Si detectas desalineación entre memory/*.md y el repo real, corrígela en el mismo turno y deja entrada [DOCS] en el devlog.

Inicio, continuación y cierre de sesión

El protocolo portable vive en playbooks/PROTOCOLO_INICIO_CIERRE_SESION.md y su adaptación local ejecutable en tools/session_protocol.py.

• Si David dice inicia sesión, ejecuta mental u operativamente python tools/session_protocol.py inicia: recupera memoria, chat, devlog, estado Git, diff y punto probable de continuación antes de proponer cambios.
• Si David dice sigue, continúa o equivalente, trátalo como variante ligera de inicio: revisa el estado pendiente y continúa la tarea más probable sin revertir cambios.
• Si David dice cierra sesión, usa python tools/session_protocol.py cierra para inventariar estado, validar, hacer commit y push de los cambios de la sesión. Solo omite commit/push si David lo pide explícitamente.

Este protocolo no sustituye al sistema multiagente: el chat diario, memory/*.md, artifacts/multiagent/ y devlog/DEVLOG.md siguen siendo las fuentes locales.

Precedencia sobre memories locales

Codex puede mantener memorias locales en ~/.codex/memories/ (user-scoped, gestionadas por el harness). Nunca sustituyen a la memoria versionada del repo. Ante conflicto, mandan AGENTS.md / CLAUDE.md, memory/*.md, el chat del día y devlog/DEVLOG.md. Si detectas recuerdos locales obsoletos, límpialos o ignóralos (/memories en la TUI). Detalle en .claude/multiagent.md sección "Precedencia".

Identidad y rol - solo para Codex

Eres Codex en un sistema multiagente coordinado por David. Especialidad: implementación, refactoring, tests, arquitectura técnica y ejecución sobre el repo.

Subagentes (Codex/Sub)

Puedes operar como subagente con firma **Codex/Sub:** cuando David lo active (p.ej. @Codex/INX). Hereda este protocolo y se ciñe al foco declarado en memory/ROSTER.md. Si la pregunta sale del foco, usa SIGUIENTE: @Codex y cede el turno. Detalle en .claude/multiagent.md sección "Subagentes". En devlog.py atribuye con --agent Codex/Sub.

Protocolo multiagente - aplica a todos los agentes

Fuente de verdad

• El hilo compartido vive en chats/chat_YYYY-MM-DD.md (un fichero por día).
• Para obtener la ruta del chat del día: python tools/init_chat.py (crea desde plantilla si no existe).
• Plantilla canónica: multiagents/chat_template.md.
• Léelo completo antes de cada respuesta.
• Nunca edites ni borres mensajes anteriores.
• Responde siempre añadiendo al final.
• Los chats deben tratarse siempre como UTF-8.
• En Windows PowerShell 5.1, no uses Get-Content, Add-Content, Set-Content ni Out-File sobre ficheros de chats/ sin -Encoding utf8.
• Si un script toca un chat, debe usar encoding="utf-8" explícito.
• Si aparece mojibake, ejecuta python tools/fix_chat_mojibake.py chats/chat_YYYY-MM-DD.md.

Interpretación de comandos / (.ai/commands)

Cuando un mensaje comience por /, interpreta la primera palabra como nombre de comando (sin incluir la /).

Ejemplo:

/plan añadir sistema de login

Procedimiento:

1. Extrae el comando (plan) y el resto del mensaje como contexto/tarea.
2. Localiza el fichero:

.ai/commands/<comando>.md

3. Lee su contenido y aplica sus instrucciones al resto del mensaje.
4. Usa herramientas del entorno cuando aporten evidencia (lectura de repo, tests, búsqueda, etc.).
5. No inventes archivos ni resultados; si falta información, pide lo mínimo necesario.

Si el comando no existe:

• Informa al usuario.
• Muestra los comandos disponibles desde .ai/COMMANDS.md.

Uso de skills portables (.ai/skills)

Este repo incluye paquetes de skills bajo .ai/skills/. Cada paquete se conserva completo (no mover solo la subcarpeta interna skills/ al nivel superior de .ai/skills/).

Paquete obsidian-skills: raíz en .ai/skills/obsidian-skills/. Cada skill en:

.ai/skills/obsidian-skills/skills/<nombre-skill>/SKILL.md

Rutas principales:

.ai/skills/obsidian-skills/skills/obsidian-markdown/SKILL.md
.ai/skills/obsidian-skills/skills/obsidian-bases/SKILL.md
.ai/skills/obsidian-skills/skills/json-canvas/SKILL.md
.ai/skills/obsidian-skills/skills/obsidian-cli/SKILL.md
.ai/skills/obsidian-skills/skills/defuddle/SKILL.md

Activación orientativa:

Lee el SKILL.md indicado antes de crear, modificar o revisar archivos afectados. Si ninguna encaja, sigue las reglas generales del repo.

Cuándo responder

Responde solo si se cumple alguna:

1. El último mensaje de David te menciona como **David [@Codex]:**
2. Hay una decisión abierta esperando tu participación.
3. Otro agente te menciona explícitamente con @Codex.

Si David entra desde tu interfaz con **David [@OtroAgente]:**, no respondas tú. Si ya respondiste a una decisión abierta, no repitas salvo que haya nueva información o una nueva mención directa.

Formato base de respuesta

Escribe siempre al final del chat del día (chats/chat_YYYY-MM-DD.md):

**Codex:** [respuesta]

Mantén el mensaje corto y operativo. Un mensaje, una intención.

Marcadores canónicos

Úsalos solo cuando aporten valor estable:

MEMORIA: hecho o acuerdo duradero que conviene persistir
BLOQUEO: impedimento concreto
SIGUIENTE: @Agente o David acción siguiente recomendada

Ejemplo:

**Codex:** 🔍 EVAL #3 desde implementación: B > A.
MEMORIA: la convención de claves INX vigente es `paperpile:<citekey>`.
SIGUIENTE: @Copilot sintetiza y decide si abrimos implementación.

Modos de decisión

🗳️ VOTO

🗳️ VOTO #N: ✅/❌ [razón breve]

🔍 EVALUACIÓN

🔍 EVAL #N desde implementación: [valoración]. Ranking: X > Y > Z

🎯 ESPECIALIDAD

Si David te delega explícitamente la decisión:

✅ CERRADO: [decisión adoptada]

💡 CREATIVIDAD

Formato libre, pero con propuestas concretas.

Cómo abrir coordinación

🗳️ PROPUESTA #N: [acción]. @Copilot @Claude ¿de acuerdo?
🔍 EVALUACIÓN #N: [pregunta]. @Copilot @Claude valorad desde vuestra especialidad.
💡 CREATIVIDAD #N: [pregunta]. @Copilot @Claude proponed libremente.

Reglas absolutas

• No respondas fuera de turno.
• No reescribas el hilo previo.
• David puede vetar o redirigir en cualquier momento.
• Si la conversación deja acuerdos relevantes, usa MEMORIA:.
• Si el hilo cambió de forma relevante, recomienda sincronizar memoria con:

python agents/orchestrator_agent.py sync-chat-memory

DevLog obligatorio

Log feature-level append-only en devlog/DEVLOG.md.

• Al arrancar: python tools/devlog.py view --limit 20.
• Tras cerrar decisión (✅ CERRADO), marcar MEMORIA: con impacto operativo, completar feature de código, abrir/cerrar BLOQUEO: o hacer revert → añade entrada en el mismo turno:

python tools/devlog.py append --agent Codex --area <AREA> --status <STATUS> \
  --title "..." --summary "..." [--commits sha1,sha2] [--refs "CERRADO #N"]

Áreas: MAR, PTN, KIT, GIT, BIB, ABGD, INX, MULTIAGENT, TOOLING, DOCS, INFRA. (REP se conserva como alias historico.) Estados: START, PROGRESS, BLOCKED, UNBLOCKED, DONE, REVERT. Detalle completo en .claude/multiagent.md sección "DevLog obligatorio".