exchange-review

name	exchange-review
description	Review exported Cisco workflow JSON against the canonical workflow review standard, enumerate the export first, and produce severity-ranked findings plus remediation suggestions and an overall readiness assessment.

Exchange Review

When to use

• The user provides a workflow export JSON file.
• The user wants Exchange review, standards validation, or approval-readiness feedback.
• The user wants findings aligned to the canonical workflow review standard.

Start here prompts

• Review this workflow export.
• Review this file against the internal review standard.
• Review this export and include remediation suggestions.

Inputs to collect

• Workflow export JSON path

Required flow

1. Use WorkflowReviewChecklist.md from the repository root when this repo is checked out. Fall back to the packaged checklist only when the toolkit is installed outside the repo.
2. Resolve the real skill directory and the repo root from this skill's file location. Do not assume the current working directory is the repo.
3. Run the shared CLI first to review the export and establish scope:
   • The review flow should enumerate first and return remediation suggestions in the first pass.

   PYTHONPATH="<repo-root>/Toolkit/cli/src" python3 -m workflow_review prepare-review "/path/to/workflow.json" --json
   

4. Present the enumeration list before deeper review.
5. Review one workflow at a time across all 7 checklist categories.
6. Lead with findings ordered by severity, then finish with the overall assessment, top improvements, and remediation suggestions.

Review rules

• Do not skip embedded subworkflows.
• Prefer user-facing names over raw internal IDs.
• Use reference.md for the local review sequence and severity guidance.
• Keep the canonical review standard as the source of truth if there is any conflict.

Output sections

• Enumeration
• Critical issues
• High priority issues
• Medium priority issues
• Low priority issues
• Workflow-by-workflow notes
• Overall assessment
• Remediation suggestions