Business Workflow Documentation

Generate visual Mermaid flowcharts from exploration session captures and session briefs.

Usage

python3 .agents/skills/business-workflow-doc/scripts/generate_workflow.py \
  --input <capture_file_or_glob> \
  --output <output_file.md> \
  --type <flowchart|stateDiagram|sequenceDiagram>

Flags:

• --input PATH : Input file(s) — session brief, BRD draft, or problem framing capture
• --output PATH : Output markdown file (default: exploration/captures/workflow-map.md)
• --type TYPE : Diagram type: flowchart (default), stateDiagram, or sequenceDiagram
• --title TEXT : Optional diagram title

Capture Pass (CLI dispatch pattern)

cat exploration/session-brief.md exploration/captures/brd-draft.md \
  | copilot -p "$(cat .agents/skills/exploration-cycle-plugin-requirements-doc-agent/SKILL.md)" \
    "Mode: workflow-map. Generate a Mermaid flowchart diagram of the core business process described in this context. Use a flowchart TD layout. Label each step clearly. Include decision nodes for branches and validation gates." \
  > exploration/captures/workflow-map.md

Output Format

The skill always outputs a Markdown file with one or more fenced Mermaid code blocks:

# Business Workflow: [Process Name]
Source: [input file(s)]
Date: [today]

## Core Process Flow

```mermaid
flowchart TD
    A[Start: Trigger Event] --> B{Validation Gate}
    B -->|Pass| C[Step 1: Process Action]
    B -->|Fail| D[Error: Notify User]
    C --> E[Step 2: Business Rule Applied]
    E --> F{Approval Required?}
    F -->|Yes| G[Approval Workflow]
    F -->|No| H[Auto-Proceed]
    G --> I[End: Complete]
    H --> I
```

## Open Questions
- [NEEDS HUMAN INPUT: step ordering unclear from captures]

Diagram Types

Anti-Hallucination Rules

• Do NOT invent process steps not described in the source captures.
• If step ordering is ambiguous, list the options and mark [NEEDS HUMAN INPUT].
• Do NOT add error handling paths unless explicitly mentioned in the source.
• Mark every diagram as DRAFT until confirmed by the human explorer.