azure-artifacts

Azure Artifacts Skill

Single source of truth for artifact template structures and styling. Per-step H2 definitions live in references/ — load only the step you are generating.

Rules

Mandatory Compliance

Rule	Requirement
Template skeleton	Read step template from references/ and replicate
Exact text	Use H2 text from templates verbatim
Exact order	Required H2s appear in the order listed
Anchor rule	Extra sections allowed ONLY after last required H2
No omissions	Every H2 listed must appear in output
Attribution	> Generated by {agent} agent | {YYYY-MM-DD}

DO / DON'T

• DO: Read the step-specific template before generating
• DO: Copy H2 text character-for-character (including emoji)
• DO: Save all output to agent-output/{project}/
• DON'T: Reorder H2 headings from the listed sequence
• DON'T: Use placeholder text like "TBD" or "Insert here"
• DON'T: Add custom H2 sections BEFORE the last required H2

Mandatory: Project README

Every project in agent-output/{project}/ MUST have a README.md.

After saving step artifact(s), update the README:

1. Mark your step as complete in ## ✅ Workflow Progress
2. Add artifact files to ## 📄 Generated Artifacts
3. Update Last Updated date and progress bar percentage

Steps

Artifact generation flow (per Step N):

1. Read template — load the matching references/0N-*-template.md for the step you are generating
2. Copy H2 skeleton — replicate every required H2 in the listed order, character-for-character
3. Fill content — replace {placeholder} tokens; never use "TBD" or "Insert here"
4. Add attribution — > Generated by {agent} agent | {YYYY-MM-DD}
5. Save to agent-output/{project}/ with the prescribed filename
6. Update README — mark step complete, list artifacts, refresh Last Updated date
7. Delegate validation — do not invoke npm run lint:artifact-templates, npm run lint:h2-sync, or markdownlint-cli2 directly against agent-output/**. The lefthook artifact-validation pre-commit hook (which wraps these scripts) and the 10-Challenger review own the artifact contract. See agent-authoring.instructions.md.