Spine Agents

Sistema operativo de equipos basado en agentes de IA y documentación viva.

Qué es esto

Spine Agents es una plantilla base para construir el sistema nervioso operativo de cualquier empresa. Combina un vault de Obsidian (base de conocimiento) con agentes de IA especializados que operan sobre esa base usando OpenCode o Claude Code.

Cada área de la empresa tiene su propia carpeta con documentación estructurada. Los agentes leen esa documentación para ejecutar tareas con contexto real de la empresa.

Compatibilidad Dual: OpenCode + Claude Code

Este sistema soporta ambos frameworks de agentes:

• OpenCode: Agentes invocados con @agente desde OpenCode CLI
• Claude Code: Subagents que Claude delega automáticamente

Ambos sistemas comparten la misma base de conocimiento y pueden coexistir sin conflictos. Elegí el que prefieras según tu workflow.

Estructura

spine-agents/
├── areas/                ← Una carpeta por área de la empresa
│   ├── marketing/        ← Documentación del área de marketing
│   ├── operaciones/      ← Documentación del área de operaciones
│   ├── finanzas/         ← Documentación del área de finanzas
│   ├── producto/         ← Documentación del área de producto
│   ├── rrhh/             ← Documentación del área de RRHH
│   └── legal/            ← Documentación del área de legal
├── knowledge/            ← Base de conocimiento compartida entre áreas
├── templates/            ← Plantillas reutilizables
├── meetings/             ← Notas de reuniones
├── _inbox/               ← Outputs de agentes para revisión humana
├── _meta/                ← Docs del sistema
├── .opencode/            ← Sistema OpenCode (opcional)
│   ├── agents/           ← Agentes OpenCode por área + curator
│   └── skills/           ← Skills reutilizables OpenCode
├── .claude/              ← Sistema Claude Code (opcional)
│   ├── agents/           ← Subagents Claude Code por área + curator
│   └── skills/           ← Skills reutilizables Claude Code
├── AGENTS.md             ← Router y documentación OpenCode
└── CLAUDE.md             ← Router y documentación Claude Code

Cómo usar esta plantilla

1. Cloná o copiá este repositorio
2. Completá la base de conocimiento:
   • knowledge/ con la información general de tu empresa
   • areas/ con la información específica de cada equipo
3. Elegí tu sistema de agentes:
   • OpenCode: Lee AGENTS.md y configurá .opencode/agents/
   • Claude Code: Lee CLAUDE.md y configurá .claude/agents/
   • Ambos: Podés usar los dos simultáneamente
4. Seguí el setup detallado en _meta/SETUP.md

OpenCode vs Claude Code

Aspecto	OpenCode	Claude Code
Invocación	@agente explícito	Delegación automática
Ubicación	.opencode/agents/	.claude/agents/
CLI	OpenCode CLI	Claude Code CLI
Formato	YAML + Markdown	YAML + Markdown
Documentación	AGENTS.md	CLAUDE.md
Base de conocimiento	Compartida (knowledge/, areas/)	Compartida (knowledge/, areas/)

Ambos sistemas son equivalentes en funcionalidad. Elegí el que mejor se adapte a tu workflow o usa ambos según preferencia.

Convenciones

• Formato de fechas: YYYY-MM-DD en nombres de archivo, DD/MM/YYYY en contenido
• Links internos: Usar wikilinks de Obsidian [[archivo]] para conectar docs
• Tags: Usar tags de Obsidian para categorizar contenido
• _inbox/: Los agentes escriben aquí. Los humanos revisan y mueven.
• Idioma: Adaptar al idioma de tu empresa

Setup rápido

Ver [[_meta/SETUP]] para instrucciones detalladas de instalación.

Instancias de Spine Agents

Una vez configurada, esta plantilla genera una instancia específica de tu empresa. Por ejemplo:

• spine-agents → plantilla base (este repo)
• spine-agents-[empresa] → instancia configurada para tu empresa