MishraShardendu22/agent-skills-hub-sync-engine-

Skill de Arquitetura de CI/CD e Implantação

Esta skill orienta agentes de IA e contribuidores na manutenção de pipelines CI/CD do GitHub Actions, publicação de imagens de contêineres e implantações automatizadas.

---

1. Desenvolvimento Local com Prioridade de Branch e Cadência de Commits

[!IMPORTANT] CRIE UMA BRANCH LOCAL PRIMEIRO E FAÇA COMMITS FREQUENTEMENTE: Sempre comece criando uma branch local dedicada a partir de main:

git switch -c <desenvolvedor-ou-agente>/main/<nome-da-feature>

Faça commits a cada marco lógico (mais commits = mais trabalho explicado). Nunca faça commit diretamente em main.

---

2. Pipeline CI/CD Multi-Ambiente

jobs:
  backend-test:
    name: Teste e Build Backend
    steps:
      - uses: actions/setup-go@v5
      - run: go test -v -race ./...
      - run: go build -v ./...

  service-test:
    name: Teste e Lint de Serviço Python
    steps:
      - uses: astral-sh/setup-uv@v5
      - run: uv sync
      - run: uv run pytest

  frontend-test:
    name: Lint e Build Frontend
    steps:
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
      - run: pnpm install --frozen-lockfile
      - run: pnpm run lint
      - run: pnpm run build

---

3. Runbook de Espelhamento Local do CI

Para garantir que suas alterações passem no CI antes do commit:

# 1. Execute o gate de pre-commit (espelho exato das verificações CI)
make pre-commit

# 2. Alternativamente, execute jobs individuais do CI localmente:
# Go Backend:
go test -v -race ./... && go build -v ./...

# Serviço Python:
uv run pytest

# Frontend:
pnpm run lint && pnpm run build

---

4. Segredos vs Configuração Centralizada

• Segredos: Estritamente definidos em .env / Segredos CI e dashboards de runtime (DATABASE_URL, API_KEY, JWT_SECRET).
• Padrões Operacionais: Centralizados em módulos de código.
• Nunca codifique segredos em YAML de workflows CI ou commits Git.