DevOps Setup

Automate Kanopi's complete Drupal/Pantheon DevOps onboarding workflow using the drupal-pantheon-devops-specialist agent.

⚠️ Side Effect Warning

This skill makes irreversible changes across multiple systems:

Creates a new GitHub repository in the kanopi/ organization
Configures branch protection rules and GitHub teams
Enables Pantheon services (Redis, New Relic) — may incur costs
Makes code changes across 16 files and creates new branches/PRs
Installs new Composer dependencies

Explicit user confirmation is required before each destructive phase. This skill will pause and confirm before creating the GitHub repo, before Pantheon configuration, and before pushing any code.

Usage

"Set up DevOps for this Pantheon project"
"Onboard this site to Kanopi's CI/CD pipeline"
/devops-setup [git-url]

Arguments: Git URL (Pantheon SSH or GitHub HTTPS/SSH)

Prerequisites

Git installed and configured
GitHub CLI (gh) installed and authenticated with kanopi org access
Terminus CLI installed (or will be installed automatically)
Write access to Pantheon site
Pantheon site UUID

Environment Detection

Tier 1 — Portable (Claude Desktop, Codex, any environment)

When Task() or system tools are unavailable:

Gather inputs — Ask user for: Git URL, GitHub org, Pantheon site name/UUID, team members
Plan phases — Present the complete 5-phase setup plan for review
⛔ STOP: Wait for user confirmation to proceed with each phase
Provide manual instructions — Step-by-step commands for each phase:
- Phase 1: Clone repo and create GitHub repo commands
- Phase 2: GitHub settings configuration commands
- Phase 3: Pantheon Terminus commands
- Phase 4: Code change checklist (16 steps)
- Phase 5: Branch creation and PR commands
Generate config files — Use Write to create .ddev/config.yaml, .circleci/config.yml, phpstan.neon, etc. based on project info

Tier 2 — Claude Code Enhanced

When running in Claude Code with Task() and all required tools:

⚠️ CONFIRM WITH USER before spawning the agent — this is an irreversible multi-system setup.

Present to user:

DevOps Setup will:
1. Create new GitHub repo: kanopi/{repo-name}
2. Configure branch protection and teams
3. Enable Redis and New Relic on Pantheon (may incur costs)
4. Make code changes and create feature/kanopi-devops branch
5. Create PR

Reply "confirm" to proceed, or "cancel" to abort.

After user confirms:

Task(cms-cultivator:drupal-pantheon-devops-specialist:drupal-pantheon-devops-specialist,
     prompt="Set up Kanopi DevOps for a Drupal/Pantheon project. Arguments: {git-url if provided}. Follow the complete 5-phase workflow: (1) Clone repo and create new GitHub repo in kanopi org, (2) Configure GitHub settings (squash merge, branch protection, teams), (3) Configure Pantheon services via Terminus (Redis, New Relic), (4) Make all code changes on feature/kanopi-devops branch, (5) Push branch, create PR, and output verification checklist with manual follow-up tasks.")

Workflow Phases

Phase 1: Initial Git Setup

Clone from provided git URL
Create new private GitHub repo under kanopi/ org
Configure remotes: pantheon (original) + origin (new kanopi repo)
Create main branch and push

Phase 2: GitHub Configuration

Enable squash merges, auto-delete branches, auto-merge
Create GitHub team with write access + kanopicode
Set branch protection: require PR reviews, status checks, conversation resolution

Phase 3: Pantheon Configuration

Verify/install Terminus CLI
Enable Redis and New Relic on Pantheon site
Retrieve site UUID for CircleCI config

Phase 4: Code Changes (feature/kanopi-devops branch)

16 code changes including: DDEV config, Composer dev deps + scripts, code quality configs, pantheon.yml, Cypress tests, CircleCI config, CODEOWNERS, Quicksilver scripts, README, CLAUDE.md

Phase 5: PR Creation

Push feature/kanopi-devops branch
Create PR with comprehensive description
Output verification checklist and manual follow-up tasks

Manual Follow-Up Tasks (Always Required)

CircleCI Secrets: Configure TERMINUS_TOKEN, GITHUB_TOKEN, etc.
CircleCI SSH Key: Add SSH key to Pantheon for deployments
Gulp Upgrade: Upgrade Gulp 3 to 4 if flagged
Theme Compilation: Verify theme builds on multidev

Related Skills

pr-create — Create PRs for subsequent changes
quality-audit — Analyze code quality after setup
security-audit — Run security audit on the project

devops-setup