Taxonomía de Agentes
El ecosistema de IA de Floutic está diseñado para mantener una interfaz limpia. Aunque existen más de 20 agentes especializados, el usuario solo interactúa con los "Puntos de Entrada", mientras que el resto trabaja en segundo plano.
🟢 Agentes Primarios (Puntos de Entrada)
Estos son los únicos agentes que deben aparecer en tu lista de comandos (/). Tienen mode: primary.
| Agente | ID | Rol Principal | Cuándo usarlo |
|---|---|---|---|
| OpenAgent | openagent | CEO / Director | 90% de las veces. Para cualquier feature, bug o duda. Decide a quién delegar. |
| OpenCoder | opencoder | Ingeniero Lead | Para implementación directa o refactorización compleja. |
| OpenSystemBuilder | system-builder | Arquitecto Jefe | Solo para crear nuevos sistemas de agentes desde cero (arquitectura, contextos, workflows). |
| OpenRepoManager | repo-manager | Facility Manager | Mantenimiento del repositorio de IA: skills, contextos, limpieza y validaciones. |
🟡 Agentes Especialistas (Delegados)
Estos agentes son expertos en áreas concretas. Están configurados como mode: subagent para no saturar la interfaz, pero son invocados automáticamente por OpenAgent cuando es necesario.
| Agente | ID | Rol |
|---|---|---|
| Frontend Specialist | frontend-specialist | Experto en UI/UX, Tailwind, Astro y React. |
| Backend Specialist | backend-specialist | Experto en API, Bases de Datos y Python. |
| DevOps Specialist | devops-specialist | Infraestructura, Docker y CI/CD. |
| Data Analyst | data-analyst | Análisis de datos y visualización. |
| Technical Writer | technical-writer | Documentación técnica y APIs. |
🔴 Subagentes de Utilidad (Invisibles)
Herramientas internas de bajo nivel que los agentes usan para tareas atómicas.
| Agente | ID | Función |
|---|---|---|
| TaskManager | task-manager | Desglosa tareas grandes en planes JSON. |
| ContextScout | contextscout | Busca y lee archivos relevantes antes de empezar. |
| DocWriter | documentation | Actualiza la documentación al terminar una tarea. |
| CoderAgent | coder-agent | "Becario" para tareas de código simples. |
| TestEngineer | tester | Ejecuta suites de pruebas. |
Diferencias Clave (OpenAgent vs OpenRepoManager)
| Pregunta | OpenAgent | OpenRepoManager |
|---|---|---|
| ¿Es tu punto de entrada? | Sí, siempre | No, es especializado |
| ¿Enfocado a features/bugs? | Sí | No, solo mantenimiento de IA |
| ¿Gestiona skills y contextos? | Solo si delega | Sí, es su responsabilidad |
| ¿Crea sistemas de IA nuevos? | No | No |
Ejemplos rápidos:
- "Agrega una nueva skill" → OpenRepoManager.
- "Revisa un agente" → OpenRepoManager.
- "Arregla un bug en el frontend" → OpenAgent (delegará si hace falta).
Comandos del usuario
Además de los agentes, el usuario dispone de comandos de alto nivel para ejecutar flujos completos:
/commit: commits formateados con el estilo Floutic./test: pipeline completo de tests./context: operaciones del sistema de contexto./clean: limpieza de calidad de código./optimize: análisis de performance y seguridad.
Configuración de Visibilidad
La visibilidad de los agentes se controla mediante el frontmatter en sus archivos de definición (.md):
---
id: mi-agente
name: Mi Agente
# ...
mode: primary # Visible en la lista de agentes
# O
mode: subagent # Oculto (solo invocable por otros agentes)
---
Estrategia de Uso
- Habla con
@OpenAgent: Es capaz de enrutar tu petición al especialista adecuado. - Confía en la Delegación: Si pides "un dashboard", OpenAgent llamará a FrontendSpecialist y BackendSpecialist por ti.
- Mantén el Foco: Ocultar los especialistas reduce la carga cognitiva y evita micro-management.