diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..4565729
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,27 @@
+# AGENTS.md
+
+## OpenSpec
+Este proyecto usa [OpenSpec](https://openspec.dev/) para desarrollo spec-driven.
+- Cambios activos: `openspec/changes/`
+- Cambios archivados: `openspec/changes/archive/`
+- Especificaciones: `openspec/specs/`
+- Comandos: `/opsx-propose`, `/opsx-apply`, `/opsx-archive` en .opencode/
+
+## Agent Skills
+Skills del proyecto en `skills/`:
+- `toldo-architecture-solid` - Arquitectura limpia, SOLID, separación lógica/presentación
+- `toldo-domain-modeling` - Modelo de dominio CESTA
+- `toldo-tdd-vitest` - TDD con Vitest
+- `toldo-offline-export-import` - Export/Import JSON versionado
+
+## Arquitectura
+- Monorepo: `apps/`, `packages/` (core, data, services, ui)
+- Tecnologías: Vite + Vue 3 + TypeScript + Vuetify 3 + Capacitor + Dexie.js
+- Principios: SOLID, componentes pequeños/reutilizables, separación lógica/presentación
+- Testing: TDD con Vitest, Playwright para E2E
+- Offline-first, APK Android
+
+## Desarrollo
+Seguir OpenSpec workflow: propose -> apply -> archive
+Usar skills cuando aplique al contexto
+Mantener código siguiendo arquitectura limpia