Actions fijadas, secretos acotados, cada despliegue reversible.
Constitution — CI/CD pipelines
Version 1.0.0 · Ratified 2026-11-10
These principles hold for every spec, plan and task of the pipelines. A spec may add rules; it never weakens these.
-
Pinned actions. Every third-party action is pinned to a full commit SHA with the version in a trailing note, and Dependabot or Renovate proposes updates. A tag or branch reference to a third-party action fails the workflow lint.
-
Scoped secrets. Workflows declare
permissionswith the least access they need, and the default token is read-only. Deploy credentials live in protected environments with required reviewers, and only the jobs that deploy can read them. -
OIDC instead of long-lived keys. Jobs that reach a cloud provider get short-lived credentials through OIDC federation bound to the repository, branch and environment. No long-lived cloud access key is stored as a secret.
-
Every deploy is reversible. Each deploy uses an immutable, versioned artifact, and the previous version can be redeployed with one action. Database migrations are backward compatible with the previous release, and a rollback is rehearsed at least once per quarter.
-
Build once, promote the same artifact. The artifact built and tested in CI is the one promoted to staging and production, identified by its digest. Nothing is rebuilt per environment.
-
Fast and trustworthy pipelines. The pull request pipeline finishes in under 10 minutes with caching, and flaky tests are quarantined with a ticket instead of being retried silently. Workflows are linted with actionlint in CI.