Documentación del Sistema

Appearance

AI Work Documentation ​

Este directorio contiene documentación relacionada con el trabajo de inteligencia artificial en el proyecto Sistema Bautista, incluyendo configuraciones, optimizaciones, y guías para el uso efectivo de Claude Code y otras herramientas de IA.

Estructura ​

ai-work/
├── README.md                                    # Este archivo
├── auto-invoke-optimization-results.md          # Resultados de optimización de patterns
├── skills/                                      # Documentación sobre skills
│   └── (futura documentación de skills)
├── prompts/                                     # Templates y guías de prompts
│   └── (futura documentación de prompts)
└── workflows/                                   # Workflows de IA documentados
    └── (futura documentación de workflows)

Contenido Actual ​

Optimizaciones de Sistema ​

Propósito ​

Esta sección documenta:

  1. Configuraciones de IA: Cómo están configuradas las skills, agents, y comandos de Claude Code
  2. Optimizaciones: Mejoras realizadas al sistema de IA para mejor rendimiento
  3. Guías de Uso: Mejores prácticas para trabajar con herramientas de IA en el proyecto
  4. Workflows: Procesos y flujos de trabajo que involucran asistencia de IA
  5. Resultados: Métricas y resultados de implementaciones y experimentos con IA

Audiencia ​

Esta documentación está dirigida a:

  • Desarrolladores que usan Claude Code para trabajar en el proyecto
  • Arquitectos que configuran skills y agents
  • Mantenedores del proyecto que necesitan entender las optimizaciones de IA
  • Nuevos miembros del equipo que necesitan entender el setup de IA

Convenciones ​

  • Toda documentación debe estar en formato Markdown (.md)
  • Incluir fechas en formato ISO (YYYY-MM-DD) en documentos de resultados
  • Usar títulos descriptivos y estructura clara
  • Incluir métricas y resultados cuantitativos cuando sea posible
  • Referenciar skills, commands, y agents por su nombre oficial

Contribuir ​

Al agregar nueva documentación de AI work:

  1. Usa nombres de archivo descriptivos en kebab-case
  2. Incluye un resumen ejecutivo al inicio del documento
  3. Documenta el "por qué" además del "qué"
  4. Incluye ejemplos cuando sea apropiado
  5. Actualiza este README con un enlace al nuevo documento

Recursos Relacionados ​

  • .claude/skills/ - Definiciones de skills de Claude Code
  • .claude/commands/ - Comandos personalizados de Claude Code
  • CLAUDE.md (raíz y submódulos) - Instrucciones para Claude Code
  • docs/features/ - Documentación de requerimientos de negocio