CI/CD & Deployment Architecture Skill
This skill guides AI agents and contributors in maintaining GitHub Actions CI/CD pipelines, Docker Hub container publishing, and automated zero-touch deployments across Vercel and Render for the **GitHub Backup Automation System**.
1. Branch-First Development & Commit Cadence
IMPORTANT
**CREATE A LOCAL BRANCH FIRST & COMMIT FREQUENTLY**: Always start by creating a local branch from `main`: ```bash git switch -c MishraShardendu22/main/<feature-name> ``` Commit at each logical milestone (`more commits = more explanatory work`). Never commit directly on `main`.
2. Deployment Boundaries & Automated Pipeline
text
┌───────────────────────────┐ ┌───────────────────────────┐
│ Next.js Frontend │ │ Python Observatory │
│ (Vercel Production Edge) │ │ (Vercel Serverless /) │
└─────────────┬─────────────┘ └─────────────┬─────────────┘
│ │
└───────────────┬──────────────────┘
│
┌───────────────▼──────────────────┐
│ Go Backend API │
│ (Render Container Service) │
│ (Auto-Deployed from Docker Hub) │
└───────────────┬──────────────────┘
│
┌───────────────▼──────────────────┐
│ PostgreSQL 16 + pgvector │
│ (Neon Database Branching) │
│ [production, staging, dev] │
└──────────────────────────────────┘yaml
jobs:
backend-test:
name: Go Backend Test & Build
steps:
- uses: actions/setup-go@v5
- run: go test -v -race ./...
- run: go build -v ./...
observatory-test:
name: Python Observatory Test & Lint
steps:
- uses: astral-sh/setup-uv@v5
- run: uv sync
- run: uv run python test_*.py
frontend-test:
name: Frontend Lint & Build
steps:
- uses: pnpm/action-setup@v4
- uses: actions/setup-node@v4
- run: pnpm install --frozen-lockfile
- run: pnpm run lint
- run: pnpm run build3. Local CI Mirroring Runbook
To guarantee that your changes pass CI before committing:
bash
# 1. Run the pre-commit gate (exact mirror of CI checks)
make pre-commit
# 2. Alternatively, run individual CI jobs locally:
# Go Backend:
go test -v -race ./... && go build -v ./...
# Python Observatory:
cd agentic-observatory && uv run python test_observability.py && uv run python test_openrouter_keys.py && uv run python test_agent_template.py && uv run python test_agent_suite.py
# Frontend:
cd frontend && pnpm run lint && pnpm run build