Agf Deploying Uat

Runbook para levantar un stack compose UAT local aislado y probarlo con smoke tests antes del traspaso

Funciona con configuración ★ 8.0/10

Qué hace

Un runbook paso a paso para el rol de ingeniero de despliegue de AppGenesisForge que despliega código fusionado a main en un stack Docker Compose UAT local físicamente aislado (nombre de proyecto independiente más un desplazamiento de puerto de +900), ejecuta la migración de Alembic en contenedor y realiza smoke tests con salida real de curl/psql antes de entregarlo al ingeniero de QA. Se activa después de la revisión de código más el paso de auditoría SIT y la fusión a main, cuando un líder de producto confirma "deploy UAT" o ejecuta /agf-deploy-uat. Excluye cargas de mini-programas y pruebas de aceptación E2E/UAT, que pertenecen a otros roles.

Informe de la prueba

Obtuve el SKILL.md y verifiqué sus tres archivos referenciados a través de GitHub en bruto: .claude/standards/deployment.md (200), .claude/commands/agf-deploy-uat.md (200), .claude/agents/deploy-engineer.md (200); hice grep en deployment.md y confirmé que las secciones citadas "UAT 环境部署" §6 y "P0/P1 强制门" más el desplazamiento literal de +900 (6332/8900/8980) realmente existen y coinciden con la skill. El frontmatter se analiza con name+description; el cuerpo contiene solo comandos estándar de docker compose / curl / psql sin curl|sh, base64, exfiltración de secretos o texto de inyección; las rutas usan ${APP_NAME}/localhost/relative, sin rutas de máquina codificadas. No pude ejecutar la etapa de salida: el despliegue necesita un daemon Docker en vivo, el stack compose del proyecto y un archivo de secretos .env.uat que no puedo ejecutar — producir un informe de despliegue solo reafirmaría la propia plantilla de la skill, por lo que outputMeasured=false y verdict=setup.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/pcliangx/AppGenesisForge.git /tmp/agf-deploying-uat-src
mkdir -p ~/.claude/skills
cp -R /tmp/agf-deploying-uat-src/.claude/skills/agf-deploying-uat ~/.claude/skills/agf-deploying-uat
# Runbook is project-specific to AppGenesisForge. To actually execute a deploy you need:
#   - Docker daemon running (docker compose version)
#   - The AppGenesisForge repo with its docker-compose files (frontend + backend + postgres)
#   - A .env.uat file (gitignored, holds DB/LLM secrets + port-offset vars) you provide
#   - Free +900 ports: 6332 (postgres) / 8900 (backend) / 8980 (frontend/caddy)
# The skill also references ../../standards/deployment.md (single source for the isolation
# contract); that file lives in the same repo under .claude/standards/deployment.md.

Comandos y prompts de ejemplo

/agf-deploying-uatRunbook para levantar un stack compose UAT local aislado y probarlo con smoke tests antes del traspaso

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

Deploy the merged main branch to the UAT stack
Run pre-flight checks before the UAT deployment
Bring up the isolated UAT compose environment

Informe completo →