Plantilla del fichero de instrucciones globales que Codex lee de tu máquina.
Sirve para que Codex entienda la infraestructura de Pampling y trabaje con tus credenciales sin tener que repetírselas en cada conversación.
| Sistema | Ruta |
|---|---|
| Windows nativo (PowerShell/CMD) | C:\Users\TU_USUARIO\.codex\AGENTS.md |
| WSL2 / Linux | ~/.codex/AGENTS.md |
Privado. No se sube a ningún repositorio.
Pídele a Codex:
Lee https://wiki.pampl.ing/en/setup-personal/plantilla-codex-agents-md, sustituye los placeholders con mis datos y guárdalo como
~/.codex/AGENTS.md. Si el fichero ya existe, hazme un backup primero y muéstrame qué vas a sobrescribir.
Codex te pedirá los datos uno a uno (nombre, rol, email Bitbucket, token Bitbucket, token Coolify) y rellenará la plantilla.
AGENTS.md de un repositorio — esos sí se commitean y comparten con el equipo. En proyectos, los tokens se leen de variables de entorno o de .env gitignored.# Instrucciones globales Pampling para Codex
Fichero personal y privado. Ruta: C:\Users\TU_USUARIO\.codex\AGENTS.md
No se sube a ningún repositorio.
## Usuario
{NOMBRE}, {ROL} en Pampling (marca de moda).
Trabaja en Windows 11 con Codex.
## Idioma
Responder siempre en español.
## Criterio de trabajo
- Antes de modificar infraestructura, explicar el plan y confirmar acciones irreversibles.
- No sobrescribir configuraciones existentes sin revisarlas primero. Hacer backup si es necesario.
- No commitear secrets bajo ningún concepto. Tokens, passwords y connection strings con credenciales viven solo en `~/.codex/AGENTS.md`, `.env` gitignored o `CLAUDE.local.md`/`AGENTS.local.md` gitignored.
- Si una app ya existe en local, Vercel u otro sistema, auditar primero y proponer integración o migración antes de crear recursos.
## Infraestructura Pampling
- Wiki: https://wiki.pampl.ing/
- Servidor: Ubuntu 24.04 (192.168.1.10)
- Coolify: http://192.168.1.10:8000 (solo red local)
- Dominio público de apps: `https://NOMBRE.pampl.ing` (SSL automático)
- Bitbucket workspace: `pampling`
- GitHub organization: `Pampling-com` (para repos nuevos con CI/CD)
- Stack recomendado: Python/FastAPI + PostgreSQL, salvo que el proyecto justifique otro stack.
## Workflows
- **Crear app nueva**: seguir el workflow documentado en https://wiki.pampl.ing/en/workflow/create-app (ruta A — app nueva).
- **App existente** (local, Vercel, otro servidor): seguir el workflow ruta B — auditoría primero, decidir si migrar a Coolify o solo documentar.
## Credenciales
Las credenciales viven en este fichero, no en repositorios.
- **BITBUCKET_EMAIL**: {EMAIL_ATLASSIAN}
- **BITBUCKET_TOKEN**: {TOKEN_BITBUCKET}
- **COOLIFY_TOKEN**: {TOKEN_COOLIFY} *(token compartido del equipo, temporal)*
## Constantes de infraestructura
- SERVER_IP: 192.168.1.10
- COOLIFY_URL: http://192.168.1.10:8000
- COOLIFY_SERVER_UUID: p9oujt6wvwz90l3zgzd1vexy
- DEPLOY_KEY_UUID: lay870h6dq9p25wvj4la8otn
- BITBUCKET_WS: pampling
- APP_DOMAIN: pampl.ing
Estos MCPs están desplegados en la infraestructura de Pampling y deben registrarse en ~/.codex/config.toml:
# Wiki MCP — gateway de solo lectura sobre la wiki interna
[[mcp_servers]]
name = "pampling-wiki"
url = "https://wiki-mcp.pampl.ing/mcp/"
transport = "streamable-http"
Cuando aparezcan más MCPs (DB, Coolify, etc.), añadirlos a esta lista.
Una vez creado el fichero, Codex debe verificar que ambos tokens funcionan:
# Bitbucket
curl -s -u "{EMAIL}:{TOKEN}" \
https://api.bitbucket.org/2.0/repositories/pampling?pagelen=1
# Coolify
curl -s -H "Authorization: Bearer {TOKEN}" \
http://192.168.1.10:8000/api/v1/applications
Si Bitbucket falla, confirmar que la invitación al workspace pampling está aceptada (pedírsela a jose.moya@pampling.com o IT).
Si Coolify falla, pedirle el token actualizado a jose.moya@pampling.com.