DevOps-PM Alignment
TL;DR: Bridges DevOps engineering practices with PM governance by mapping CI/CD pipelines to milestone tracking, release cadences to sprint ceremonies, deployment metrics to project KPIs, and infrastructure changes to change control. Produces an integrated operating model where engineering velocity and project visibility reinforce each other.
Principio Rector
DevOps sin gobernanza de proyecto es velocidad sin dirección; gobernanza de proyecto sin DevOps es visibilidad sin velocidad. El alineamiento no es imponer burocracia al pipeline ni automatizar la rendición de cuentas — es crear un modelo operativo donde cada deploy sea un hito trazable y cada milestone tenga evidencia de entrega real.
Assumptions & Limits
- Assumes CI/CD pipelines exist and are documented [SUPUESTO]
- Assumes PM and engineering teams are willing to collaborate on integration [STAKEHOLDER]
- Breaks when no CI/CD pipeline exists — recommend DevOps foundation before alignment
- Does not implement CI/CD pipelines — designs the alignment layer between DevOps and PM
- DORA metrics (deployment frequency, lead time, MTTR, change failure rate) are standard alignment points
- Tooling integration depends on API availability between DevOps and PM tools [SUPUESTO]
Usage
# Map CI/CD pipeline to project milestones
/pm:devops-pm-alignment $PROJECT --type=pipeline-mapping
# Correlate DORA metrics with PM KPIs
/pm:devops-pm-alignment $PROJECT --type=metric-alignment --dora="all"
# Design integrated operating model
/pm:devops-pm-alignment $PROJECT --type=operating-model
Parameters:
| Parameter | Required | Description |
|---|
$PROJECT | Yes | Project identifier |
--type | Yes | pipeline-mapping, metric-alignment, operating-model, ceremony-integration |
--dora | No | DORA metrics to correlate (all, deployment-frequency, lead-time) |
Service Type Routing
{TIPO_PROYECTO} variants:
- Agile: Map sprint increments to deployment pipelines, automate sprint metrics from CI/CD
- Waterfall: Map phase gates to release gates, align environment promotion with project phases
- SAFe: Map ART cadences to release trains, PI objectives to epic-level deployments
- Kanban: Map flow metrics to deployment frequency, WIP limits to concurrent release branches
- Hybrid: Integrate phase-gate approvals with continuous delivery checkpoints
- Transformation: Design target DevOps-PM operating model for organizational change
Before Aligning
- Read the current CI/CD pipeline architecture to understand deployment workflow
- Read the project management process to identify milestone and ceremony structure
- Glob
skills/devops-pm-alignment/references/*.md for integration patterns
- Grep for existing automation or reporting that bridges DevOps and PM data
Entrada (Input Requirements)
- Current CI/CD pipeline architecture and tooling
- Project management tool and workflow configuration
- Release management process (if exists)
- Deployment frequency and environment topology
- Current pain points in visibility or coordination
Proceso (Protocol)
- Current state mapping — Document existing CI/CD pipeline and PM process independently
- Integration point identification — Find natural connection points between DevOps and PM
- Metric alignment — Map DevOps metrics (DORA) to PM KPIs (schedule, quality, scope)
- Ceremony integration — Design ceremonies that serve both engineering and governance needs
- Tooling bridge design — Define integrations between CI/CD tools and PM tools
- Change control mapping — Align infrastructure/code changes with change control board
- Release-milestone binding — Bind release cadence to project milestone tracking
- Automated reporting — Design automated status extraction from deployment pipelines
- Escalation protocol — Define when pipeline failures escalate to project-level risks
- Operating model documentation — Compile integrated DevOps-PM operating model
Edge Cases
- No CI/CD pipeline exists: Document current manual deployment process. Design minimum viable pipeline as prerequisite. Alignment begins after basic CI/CD is established. [PLAN]
- PM and engineering use incompatible tools: Design data export/import bridge. If no API exists, recommend tool consolidation or middleware. [SUPUESTO]
- Deployment frequency exceeds PM tracking capacity: Aggregate deployments to sprint/release level for PM tracking. Keep detailed deployment logs in engineering tools. [METRIC]
- Change control blocks engineering velocity: Calibrate change control to methodology. Exempt routine deployments from CCB. Reserve formal control for infrastructure and baseline changes. [STAKEHOLDER]
Example: Good vs Bad
Good DevOps-PM Alignment:
| Attribute | Value |
|---|
| Pipeline mapping | Every CI/CD stage mapped to PM milestone |
| DORA-PM correlation | 4 DORA metrics mapped to PM KPIs |
| Ceremony integration | ≥2 ceremonies serving both domains |
| Automated reporting | Status extracted from pipeline without manual input |
| Operating model | Documented with roles, tools, and cadence |
| Escalation protocol | Pipeline failure to project risk threshold defined |
Bad DevOps-PM Alignment:
A document saying "engineering should report to PM weekly" without pipeline mapping, no metric correlation, no ceremony integration, no automation. Fails because manual reporting creates overhead and lag — the whole point of alignment is that deployment data automatically informs project status.
Validation Gate
Escalation Triggers
- No CI/CD pipeline exists (manual deployments only)
- PM and engineering teams use incompatible tooling with no API bridge
- Deployment frequency exceeds project tracking capacity
- Change control process blocks engineering velocity beyond acceptable limits
Additional Resources
| Resource | When to read | Location |
|---|
| Body of Knowledge | Before aligning to understand DevOps-PM integration theory | references/body-of-knowledge.md |
| State of the Art | When evaluating DevOps-PM tooling integration | references/state-of-the-art.md |
| Knowledge Graph | To link alignment to CI/CD, ceremonies, and governance | references/knowledge-graph.mmd |
| Use Case Prompts | When scoping integration requirements | prompts/use-case-prompts.md |
| Metaprompts | To generate operating model templates | prompts/metaprompts.md |
| Sample Output | To calibrate expected alignment documentation | examples/sample-output.md |
Output Configuration
- Language: Spanish (Latin American, business register)
- Evidence: [PLAN], [SCHEDULE], [METRIC], [INFERENCIA], [SUPUESTO], [STAKEHOLDER]
- Branding: #2563EB royal blue, #F59E0B amber (NEVER green), #0F172A dark
Sub-Agents
Cicd Schedule Aligner
Cicd Schedule Aligner Agent
Core Responsibility
Aligns CI/CD pipeline events with project schedule milestones. This agent operates autonomously, applying systematic analysis and producing structured outputs.
Process
- Gather Inputs. Collect all relevant data, documents, and stakeholder inputs needed for analysis.
- Analyze Context. Assess the project context, methodology, phase, and constraints.
- Apply Framework. Apply the appropriate analytical framework or model.
- Generate Findings. Produce detailed findings with evidence tags and quantified impacts.
- Validate Results. Cross-check findings against related artifacts for consistency.
- Formulate Recommendations. Transform findings into actionable recommendations with owners and timelines.
- Deliver Output. Produce the final structured output with executive summary, analysis, and action items.
Output Format
- Analysis Report — Structured findings with evidence tags and severity ratings.
- Recommendation Register — Actionable items with owners, deadlines, and success criteria.
- Executive Summary — 3-5 bullet point summary for stakeholder communication.
Deployment Tracker
Deployment Tracker Agent
Core Responsibility
Tracks deployments as project deliverables with release management integration. This agent operates autonomously, applying systematic analysis and producing structured outputs.
Process
- Gather Inputs. Collect all relevant data, documents, and stakeholder inputs needed for analysis.
- Analyze Context. Assess the project context, methodology, phase, and constraints.
- Apply Framework. Apply the appropriate analytical framework or model.
- Generate Findings. Produce detailed findings with evidence tags and quantified impacts.
- Validate Results. Cross-check findings against related artifacts for consistency.
- Formulate Recommendations. Transform findings into actionable recommendations with owners and timelines.
- Deliver Output. Produce the final structured output with executive summary, analysis, and action items.
Output Format
- Analysis Report — Structured findings with evidence tags and severity ratings.
- Recommendation Register — Actionable items with owners, deadlines, and success criteria.
- Executive Summary — 3-5 bullet point summary for stakeholder communication.
Devops Pm Bridge Builder
Devops Pm Bridge Builder Agent
Core Responsibility
Bridges DevOps and PM practices for unified project governance. This agent operates autonomously, applying systematic analysis and producing structured outputs.
Process
- Gather Inputs. Collect all relevant data, documents, and stakeholder inputs needed for analysis.
- Analyze Context. Assess the project context, methodology, phase, and constraints.
- Apply Framework. Apply the appropriate analytical framework or model.
- Generate Findings. Produce detailed findings with evidence tags and quantified impacts.
- Validate Results. Cross-check findings against related artifacts for consistency.
- Formulate Recommendations. Transform findings into actionable recommendations with owners and timelines.
- Deliver Output. Produce the final structured output with executive summary, analysis, and action items.
Output Format
- Analysis Report — Structured findings with evidence tags and severity ratings.
- Recommendation Register — Actionable items with owners, deadlines, and success criteria.
- Executive Summary — 3-5 bullet point summary for stakeholder communication.
Dora Metrics Integrator
Dora Metrics Integrator Agent
Core Responsibility
Integrates DORA metrics into project reporting. This agent operates autonomously, applying systematic analysis and producing structured outputs.
Process
- Gather Inputs. Collect all relevant data, documents, and stakeholder inputs needed for analysis.
- Analyze Context. Assess the project context, methodology, phase, and constraints.
- Apply Framework. Apply the appropriate analytical framework or model.
- Generate Findings. Produce detailed findings with evidence tags and quantified impacts.
- Validate Results. Cross-check findings against related artifacts for consistency.
- Formulate Recommendations. Transform findings into actionable recommendations with owners and timelines.
- Deliver Output. Produce the final structured output with executive summary, analysis, and action items.
Output Format
- Analysis Report — Structured findings with evidence tags and severity ratings.
- Recommendation Register — Actionable items with owners, deadlines, and success criteria.
- Executive Summary — 3-5 bullet point summary for stakeholder communication.