SOP: Configuración de Reglas y Contexto para AI Coding Agents

Cada proyecto debe tener un archivo de reglas en su raíz:

Contenido mínimo:

`markdown

• Lenguaje: Python 3.11+
• Framework: FastAPI
• Base de datos: PostgreSQL

• Nombres de variables en snake_case
• Clases en PascalCase
• Type hints obligatorios

• /config/production.py
• /migrations/
• /.env
• /secrets/

• pydantic, sqlalchemy, httpx, pytest
• NO: requests (usar httpx), selenium

Crear CONTEXT.md en la raíz del proyecto. Actualizarlo al final de cada sesión:

`markdown

• 2026-06-02: migramos autenticación de JWT a OAuth2
• 2026-05-28: cambiamos ORM de SQLAlchemy 1.4 a 2.0

• [x] Endpoint de login
• [x] Rate limiting

• [ ] Refresh token rotation
• [ ] Tests de integración para auth

• El módulo de pagos está congelado hasta Q3
• No migrar a async hasta revisar compatibilidad de librerías

En Hermes Agent: el archivo AGENTS.md se carga automáticamente al iniciar una sesión en ese directorio.

En Cursor/Claude Code: verificar que .cursorrules o CLAUDE.md estén en la raíz. El agente los lee al iniciar.

Antes de cada sesión, definir explícitamente qué archivos puede tocar el agente:

`bash cd proyecto/ echo "auth/" > .agent-scope `

Regla: si el agente intenta modificar un archivo fuera del scope, detener y revisar.

Al terminar cada sesión:

1. Revisar git diff — verificar que solo se modificaron los archivos esperados
2. Actualizar CONTEXT.md con las decisiones tomadas y próximos pasos
3. Si el agente tocó algo que no debía, agregarlo a "Archivos intocables" en las reglas