business-workflows

Generate business workflow documentation and a Mermaid sequence diagram for multi-service projects.

35|8|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/microsoft/github-copilot-modernization --skill business-workflows
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: business-workflows
Source: https://github.com/microsoft/github-copilot-modernization/tree/main/plugins/github-copilot-modernization/skills/business-workflows
Command: npx skills add https://github.com/microsoft/github-copilot-modernization --skill business-workflows

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Document business workflows across multiple services and domains with a shareable Mermaid sequence diagram, enabling clear governance and traceability.

Core Features & Use Cases

  • Generate Domain Entities section focusing on business meaning, bounded context, and relationships (without technical field details).
  • Generate Service-to-Domain Mapping section mapping each service to its bounded context and owned entities, plus cross-context data exchange.
  • Generate Primary Workflows section detailing significant entry points (APIs, scheduled tasks, events) and end-to-end flow.
  • Generate Cross-Service Data Flows section describing aggregation patterns and data ownership.
  • Produce a Mermaid Business Workflow Sequence diagram illustrating the end-to-end process, including alternate/fallback paths for circuit breakers.
  • Support output to .github/modernize/assessment/engines/facts/business-workflows.md and guidance for future expansions.

Quick Start

Provide your project path and let the skill generate a core business workflows documentation with a Mermaid sequence diagram.

Frequently Asked Questions about business-workflows

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document cross-service business workflows with a sequence diagram?

Document cross-service business workflows by generating end-to-end documentation and a Mermaid sequence diagram that captures domain boundaries, cross-service interactions, and governance rules across multiple services.

What is the best way to map domain entities to services for bounded context documentation?

Mapping domain entities to services requires generating a service-to-domain mapping section that defines bounded context ownership, cross-context data exchange, and business relationships without technical field details.

How do I visualize circuit breaker fallback paths in a Mermaid sequence diagram?

Visualize circuit breaker fallback paths by generating a Mermaid business workflow sequence diagram that illustrates the end-to-end process, explicitly including alternate and fallback paths for resilience.

Can I document cross-service data flows and aggregation patterns for multi-service projects?

You can document cross-service data flows by generating a dedicated section that describes aggregation patterns, data ownership, and significant entry points like APIs, scheduled tasks, and events.

Does the generated business workflow documentation support output to a specific markdown path?

Yes, the generated business workflow documentation supports output directly to the .github/modernize/assessment/engines/facts/business-workflows.md file path, including guidance for future expansions.

When do I need to generate workflow analysis documentation for multi-service architectures?

You need workflow analysis documentation when applying this to projects with multiple services to capture domain boundaries, primary workflows, cross-service data flows, and business rules for clear governance and traceability.