Agf Deploying Uat

Runbook zum Starten eines isolierten lokalen UAT-Compose-Stacks und Smoke-Test vor der Übergabe

Funktioniert mit Setup ★ 8.0/10

Was es kann

Ein Schritt-für-Schritt-Runbook für die AppGenesisForge deploy-engineer-Rolle, das merged-to-main-Code auf einen physisch isolierten lokalen UAT Docker Compose-Stack (unabhängiger Projektname plus +900 Port-Offset) bereitstellt, In-Container-Alembic-Migrationen ausführt und Smoke-Tests mit realer curl/psql-Ausgabe durchführt, bevor es an den qa-engineer übergeben wird. Wird ausgelöst nach Code-Review plus SIT-Audit-Pass und Merge zu main, wenn ein Product-Lead "deploy UAT" bestätigt oder /agf-deploy-uat ausführt. Schließt Mini-Programm-Uploads und E2E/UAT-Akzeptanztests aus, die anderen Rollen zugeordnet sind.

Testbericht

Die SKILL.md abgerufen und ihre drei referenzierten Dateien über raw GitHub stichprobenartig überprüft: .claude/standards/deployment.md (200), .claude/commands/agf-deploy-uat.md (200), .claude/agents/deploy-engineer.md (200); deployment.md gegreppt und bestätigt, dass die zitierten Abschnitte "UAT 环境部署" §6 und "P0/P1 强制门" sowie der literale +900 Offset (6332/8900/8980) tatsächlich existieren und zum Skill passen. Frontmatter wird mit name+description geparst; der Body enthält nur Standard-docker compose / curl / psql-Befehle ohne curl|sh, base64, Geheimnis-Exfiltration oder Injection-Text; Pfade verwenden ${APP_NAME}/localhost/relative, keine fest codierten Maschinenpfade. Die Output-Phase konnte nicht ausgeführt werden: Das Deployment benötigt einen aktiven Docker-Daemon, den Compose-Stack des Projekts und eine .env.uat-Secrets-Datei, die ich nicht ausführen kann – die Erstellung eines Deployment-Berichts würde nur die eigene Vorlage des Skills wiederholen, daher outputMeasured=false und verdict=setup.

Getestet am: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

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.

Befehle & Beispiel-Prompts

/agf-deploying-uatRunbook zum Starten eines isolierten lokalen UAT-Compose-Stacks und Smoke-Test vor der Übergabe

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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

Vollständiger Testbericht (Englisch) →