Jira / Azure DevOps Configuration
TL;DR: Designs PM tool configuration (Jira, Azure DevOps, or equivalent) including project structure, workflow design, field configuration, board setup, automation rules, and reporting dashboards. Ensures the tool supports the selected methodology rather than constraining it.
Principio Rector
La herramienta debe servir al proceso, no al revés. Configurar Jira antes de diseñar el proceso garantiza que el proceso se adapte a las limitaciones de Jira — no a las necesidades del proyecto. Primero el proceso, luego la herramienta. La configuración correcta hace que el trabajo correcto sea el camino más fácil.
Assumptions & Limits
- Assumes methodology selection and ceremony design are completed before tool configuration [SUPUESTO]
- Assumes tool licensing and admin access are available or confirmed [SUPUESTO]
- Breaks if methodology is not defined — configuring a tool without a process creates arbitrary workflows [PLAN]
- Scope limited to configuration design; actual tool administration requires platform admin access [PLAN]
- Does not evaluate tool selection — assumes tool is already chosen; use
poc-lab for tool evaluation [PLAN]
Usage
/pm:jira-configuration $PROJECT_NAME --tool=jira --methodology=scrum
/pm:jira-configuration $PROJECT_NAME --tool=azure-devops --methodology=kanban
/pm:jira-configuration $PROJECT_NAME --tool=jira --methodology=safe --include=dashboards
Parameters:
| Parameter | Required | Description |
|---|
$PROJECT_NAME | Yes | Target project identifier |
--tool | No | jira / azure-devops / monday (default: jira) |
--methodology | No | scrum / kanban / safe / waterfall / hybrid |
--include | No | workflows / dashboards / automation / all (default: all) |
Service Type Routing
{TIPO_PROYECTO}: Scrum uses Scrum board with sprint management; Kanban uses Kanban board with WIP limits; SAFe uses SAFe template; Waterfall uses project plan with phases; Hybrid uses combined configuration.
Before Configuring Tools
- Read
methodology-playbook — confirm ceremonies and workflows to be supported [PLAN]
- Glob
*ceremony* and *definition-of-done* — tool must enforce these agreements [PLAN]
- Read team structure — configure permissions and board views per role [STAKEHOLDER]
- Check reporting requirements — dashboard design must satisfy governance reporting needs [PLAN]
Entrada (Input Requirements)
- Selected methodology and ceremony design
- Work item types and workflows
- Team structure and permissions
- Reporting requirements
- Integration needs (CI/CD, Slack, etc.)
Proceso (Protocol)
- Project structure — Design project hierarchy (project, board, backlog)
- Work item types — Define issue types (epic, feature, story, task, bug)
- Workflow design — Create status workflows per issue type
- Field configuration — Define custom fields per work item type
- Board setup — Configure board columns, swimlanes, and filters
- Automation rules — Design automation for transitions, notifications, SLA tracking
- Dashboard design — Create reporting dashboards with key metrics
- Permission scheme — Configure role-based access controls
- Integration setup — Plan integrations with other tools
- User guide — Create team guide for tool usage
Edge Cases
- Tool limitations prevent methodology implementation — Document limitation; design workaround configuration; if critical, recommend tool change via
poc-lab evaluation.
- Multiple methodologies on same tool instance — Create separate project configurations per methodology; use shared fields for cross-methodology reporting.
- Team resistance to new tool configuration — Phase rollout; start with minimal changes; add features incrementally based on team feedback.
- Legacy data migration needed — Design migration mapping; validate field compatibility; plan data cleanup sprint before go-live.
Example: Good vs Bad
Good Tool Configuration:
| Attribute | Value |
|---|
| Workflow states | Match methodology ceremonies exactly — no extra states [PLAN] |
| WIP limits | Enforced in board configuration, not just documented [METRIC] |
| Dashboards | 3 views: team daily, PM weekly, steering monthly [STAKEHOLDER] |
| Automation | Sprint closure, SLA alerts, blocked item notifications [PLAN] |
| User guide | Role-specific quick-start with screenshots [PLAN] |
Bad Tool Configuration:
Default Jira Scrum template with no customization. Workflows do not match team ceremonies, no WIP limits, no dashboards, no automation. Team uses tool as ticket dump rather than methodology engine.
Salida (Deliverables)
- Tool configuration specification document
- Workflow diagrams (Mermaid)
- Field configuration matrix
- Dashboard design mockups
- Team user guide
Validation Gate
Escalation Triggers
- Tool limitations preventing methodology implementation
- License constraints limiting functionality
- Integration failures with other tools
- Team resistance to tool adoption
Additional Resources
| Resource | When to read | Location |
|---|
| Body of Knowledge | Before starting to understand standards and frameworks | references/body-of-knowledge.md |
| State of the Art | When benchmarking against industry trends | references/state-of-the-art.md |
| Knowledge Graph | To understand skill dependencies and data flow | references/knowledge-graph.mmd |
| Use Case Prompts | For specific scenarios and prompt templates | prompts/use-case-prompts.md |
| Metaprompts | To enhance output quality and reduce bias | prompts/metaprompts.md |
| Sample Output | Reference for deliverable format and structure | 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
Automation Rule Builder
Automation Rule Builder Agent
Core Responsibility
Builds automation rules for status updates and notifications. 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.
Board Designer
Board Designer Agent
Core Responsibility
Designs Jira/Azure DevOps board layouts. 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.
Reporting Dashboard Creator
Reporting Dashboard Creator Agent
Core Responsibility
Creates reporting dashboards with JQL/queries. 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.
Workflow Configurer
Workflow Configurer Agent
Core Responsibility
Configures issue workflows with status transitions and rules. 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.