Agf Deploying Uat

Runbook om een geïsoleerde lokale UAT compose stack op te zetten en te smoke-testen vóór overdracht

Door pcliangx · pcliangx/AppGenesisForge

Werkt met setup ★ 8.0/10

Agf Deploying Uat — Runbook om een geïsoleerde lokale UAT compose stack op te zetten en te smoke-testen vóór overdracht

Wat het doet

Een stap-voor-stap runbook voor de AppGenesisForge deploy-engineer rol dat samengevoegde-naar-main code deployt naar een fysiek geïsoleerde lokale UAT Docker Compose stack (onafhankelijke projectnaam plus +900 poortoffset), in-container Alembic migratie uitvoert, en smoke-tests met echte curl/psql output voordat het wordt overgedragen aan de qa-engineer. Activeert na code review plus SIT audit pass en merge naar main, wanneer een product-lead "deploy UAT" bevestigt of /agf-deploy-uat uitvoert. Exclusief mini-programma uploads en E2E/UAT acceptatietesten, die tot andere rollen behoren.

Testrapport

De SKILL.md opgehaald en de drie gerefereerde bestanden steekproefsgewijs gecontroleerd via raw GitHub: .claude/standards/deployment.md (200), .claude/commands/agf-deploy-uat.md (200), .claude/agents/deploy-engineer.md (200); deployment.md gegrepped en bevestigd dat de geciteerde "UAT 环境部署" §6 en "P0/P1 强制门" secties plus de letterlijke +900 offset (6332/8900/8980) echt bestaan en overeenkomen met de skill. Frontmatter parseert met name+description; body bevat alleen standaard docker compose / curl / psql commando's zonder curl|sh, base64, geheime exfiltratie, of injectietekst; paden gebruiken ${APP_NAME}/localhost/relative, geen hardgecodeerde machinepaden. Kon de outputfase niet uitvoeren: deployen vereist een live Docker daemon, de compose stack van het project, en een .env.uat secrets bestand dat ik niet kan uitvoeren — het produceren van een deploy rapport zou alleen de eigen template van de skill herhalen, dus outputMeasured=false en verdict=setup.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

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.

Commando's en voorbeeldprompts

/agf-deploying-uatRunbook om een geïsoleerde lokale UAT compose stack op te zetten en te smoke-testen vóór overdracht

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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

Volledig rapport (Engels) →