pal-e-docs

Board: Validation Pipeline (Dev → Staging → Prod)

board-validation-pipeline Board

active
Project

Board: Validation Pipeline (Dev → Staging → Prod)

Validation = smoke tests based on integration tests, running across three tiers. Each tier catches different failure classes. The pipeline ensures merged work actually works before it reaches users.

Parent

Platform-level capability. Establishes the validation column in the board workflow and the infrastructure to support it. Affects all projects.

User Stories

Role Key Story Success Metric
Superadmin superuser-validate I want every merge validated in dev and staging before prod, so regressions never reach users Zero regressions in prod that integration tests would have caught
Dev agent dev-validate I want my PR's tests to run against a real environment so I know my changes work beyond unit tests Every PR has a passing dev-tier smoke test before QA

Architecture

Three validation tiers:
Components: arch:validation-pipeline, arch:kustomize, arch:ci-pipeline, arch:argocd, arch:harbor

Acceptance Criteria

  • Dev tier: every service has a dev overlay with volume-mount in pal-e-deployments
  • Dev tier: git pull on main enforced before dev testing (SOP + hook)
  • Staging tier: staging namespace with ArgoCD apps for all active services
  • Staging tier: Woodpecker pipeline builds, pushes, deploys, smoke tests
  • Staging tier: same terraform + infra pattern as prod (different vars)
  • /validate-ticket skill orchestrates tier 1 → tier 2 → tier 3 checks
  • Validation column enforced — no ticket to done without validation PASS
  • SOP documents the full validation flow

Kanban

Foundation (parallel, no deps)

  • Convention: validation-pipeline — Document three-tier model. Dottie task. ~3 min.
  • SOP: pull-before-dev — SessionStart hook enforces git pull main. claude-custom. ~3 min.
  • Update skill-validate-ticket — Add tier awareness. pal-e-docs. ~3 min.

Dev Tier

  • Dev overlays audit — Check/create dev overlays per service. pal-e-deployments. ~5 min/service.
  • Dev Woodpecker step — dev-test step in .woodpecker.yaml per repo. ~3 min/repo.

Staging Tier

  • Staging namespace + ArgoCD apps — pal-e-services terraform. ~5 min.
  • Staging overlays — pal-e-deployments staging/ per service. ~3 min/service.
  • Staging Woodpecker pipeline — build→push→deploy→smoke per repo. ~5 min/repo.
  • Staging terraform — staging-specific infra if needed. pal-e-services. ~5 min.

Enforcement

  • Validation column hook — Block done without validation PASS. claude-custom. ~3 min.
  • Dogfood: validate 17 unvalidated PRs — Run /validate-ticket on all session PRs. ~2 min/ticket.
  • template-validation — validation note template
  • skill-validate-ticket — the skill this board enhances
  • sop-board-workflow — validation column
  • convention-kustomize-overlay — overlay structure
  • sop-frontend-dev-overlay — existing dev overlay SOP