# Generate Demo Artifacts

> Generate the comprehensive demo markdown artifacts from the current codebase. Use before UAT to ensure test artifacts reflect the latest code.

- Skill: `oocx/generate-demo-artifacts` (Agent Skill)
- Install (CLI): `npx skillmds@latest add oocx/generate-demo-artifacts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oocx/generate-demo-artifacts/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: oocx (https://skillmd.com/u/oocx)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/oocx/generate-demo-artifacts

---


# 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

```bash
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)
   - `role-default.md` (role assignments without principal mapping)
3. Generates all documentation samples in `examples/comprehensive-demo/`:
   - `report.md` (default template)
   - `report-with-sensitive.md` (with `--show-sensitive`)
   - `report-summary.md` (summary template)
4. Verifies all outputs are valid markdown
5. 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-simple-diff.md (for GitHub UAT)...
[INFO] ✓ artifacts/comprehensive-demo-simple-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