| 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:
- Builds the project in Release configuration
- Generates all artifacts in
/artifacts/ (used for UAT):
comprehensive-demo.md (inline-diff format, for Azure DevOps UAT)comprehensive-demo-standard-diff.md (standard diff format, for GitHub UAT)role.md (role assignments with principal mapping)role-default.md (role assignments without principal mapping)
- Generates all documentation samples in
examples/comprehensive-demo/:
report.md (default template)report-with-sensitive.md (with --show-sensitive)report-summary.md (summary template)
- Verifies all outputs are valid markdown
- Reports success or failure with clear error messages
Expected Output
[INFO] Building project (Release configuration)...
[INFO] Generating artifacts/comprehensive-demo.md (inline-diff, for Azure DevOps UAT)...
[INFO] ✓ artifacts/comprehensive-demo.md generated successfully (inline-diff)
[INFO] Generating artifacts/comprehensive-demo-standard-diff.md (for GitHub UAT)...
[INFO] ✓ artifacts/comprehensive-demo-standard-diff.md generated successfully
[INFO] Generating artifacts/role.md (role assignments with principal mapping)...
[INFO] ✓ artifacts/role.md generated successfully
[INFO] Generating artifacts/role-default.md (role assignments without principal mapping)...
[INFO] ✓ artifacts/role-default.md generated successfully
[INFO] Generating examples/comprehensive-demo/report.md (default template)...
[INFO] ✓ examples/comprehensive-demo/report.md generated successfully
[INFO] Generating examples/comprehensive-demo/report-with-sensitive.md (with --show-sensitive)...
[INFO] ✓ examples/comprehensive-demo/report-with-sensitive.md generated successfully
[INFO] Generating examples/comprehensive-demo/report-summary.md (summary template)...
[INFO] ✓ examples/comprehensive-demo/report-summary.md generated successfully
[INFO] All demo artifacts generated successfully
When to Use
- Before running UAT (to ensure artifacts match current code)
- After making changes to templates or rendering logic
- After updating the comprehensive demo plan.json
- When setting up a new development environment
