# Deployment Playbook

> Release checklists with phases (before, during, after deployment), human approvals with four-eyes, an audit log, and a gate API so CI/CD pipelines wait for approvals. Plans can be created from CI (POST /api/plans) and inspected through a remote MCP server (/api/mcp). Approvals always stay human.

## Docs

- [Getting started](https://deployment-playbook.com/docs): Create a workspace, a template and your first plan, then gate a pipeline on it.
- [Concepts](https://deployment-playbook.com/docs/concepts): Workspaces, roles, templates, plans, phases, steps, approvals, four-eyes and statuses.
- [Recipes](https://deployment-playbook.com/docs/recipes): Copy-paste CI/CD examples - create a plan on a git tag, gate each phase, parallel deploy, webhooks.
- [API reference](https://deployment-playbook.com/docs/api): Authentication, POST /api/plans, GET /api/gate, errors and examples.
- [SSO and social login](https://deployment-playbook.com/docs/sso-and-social-login): Sign in with Google, GitHub or Microsoft, and set up company SSO (SAML 2.0 or OIDC) per workspace.
- [Use with AI](https://deployment-playbook.com/docs/use-with-ai): Connect Cursor, Claude, VS Code or any MCP client to Deployment Playbook, and the llms.txt docs.
- [Security & network](https://deployment-playbook.com/docs/security): For IT and security reviewers - domains to allow, hosting and data residency, implemented security controls and how to report a vulnerability.
- [GitHub integration](https://deployment-playbook.com/docs/integrations/github): Install the Deployment Playbook GitHub App - plans from tags and releases, a check run per plan, and a custom deployment protection rule for GitHub environments.
- [GitLab integration](https://deployment-playbook.com/docs/integrations/gitlab): Connect GitLab.com or self-managed GitLab - plans from tag pushes, a commit status per plan, and automatic approval of protected-environment deployments.
- [Azure DevOps integration](https://deployment-playbook.com/docs/integrations/azure-devops): Connect Azure DevOps Services or Server - plans from tag pushes via a service hook, Git commit statuses, and an Invoke REST API environment check that gates YAML deployments.

## Optional

- [Full documentation in one file](https://deployment-playbook.com/llms-full.txt)
- [Example GitHub Actions repository](https://github.com/Generation-Y-BV/deployment-playbook-example): tag-triggered plan creation and phase gates