generate-demo-artifacts

name	generate-demo-artifacts
description	Generate the comprehensive demo markdown artifacts from the current codebase. Use before UAT to ensure test artifacts reflect the latest code.
compatibility	Requires .NET SDK and access to the repository workspace.

Generate Demo Artifacts

Purpose

Regenerate all demo markdown artifacts using the current code. This ensures UAT tests validate the actual behavior of the tool, not stale output.

Hard Rules

Must

• Use the stable wrapper script: scripts/generate-demo-artifacts.sh
• Script will handle building, generating artifacts, and verification automatically
• Always allow this script — it only reads input files and writes artifacts, no dangerous operations

Must Not

• Modify the input plan.json or demo-principals.json files
• Run individual dotnet commands instead of the wrapper script
• Skip verification of generated output

Actions

Generate All Demo Artifacts

scripts/generate-demo-artifacts.sh

This single command:

1. Builds the project in Release configuration
2. Generates all artifacts in /artifacts/ (used for UAT):
   • comprehensive-demo.md (inline-diff format, for Azure DevOps UAT)
   • comprehensive-demo-simple-diff.md (simple diff format, for GitHub UAT)
   • role.md (role assignments with principal mapping)