| name | azure-artifacts |
| description | Artifact template structures, H2 compliance rules, and documentation styling for agent outputs (Steps 1-7). USE FOR: generating any agent artifact, checking H2 structure compliance. DO NOT USE FOR: Azure resource configuration (use azure-defaults), Bicep/Terraform patterns (use bicep-patterns or terraform-patterns). |
| compatibility | Works with Claude Code, GitHub Copilot, VS Code, and any Agent Skills compatible tool. |
| license | MIT |
| metadata | {"author":"jonathan-vella","version":"2.0","category":"workflow-automation"} |
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.
Artifact Generation 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:
- Mark your step as complete in
## ✅ Workflow Progress
- Add artifact files to
## 📄 Generated Artifacts
- Update
Last Updated date and progress bar percentage
Placeholder Syntax
All templates use single-brace {placeholder-name} syntax:
- Lowercase, hyphen-separated:
{project-name}, {monthly-cost}
- No Mustache/Handlebars
{{double-braces}}
Automated Validation
npm run lint:artifact-templates
npm run lint:h2-sync
npm run validate:all
Quality Checklist
Reference Index
When generating a Step N artifact, read the corresponding template:
| Reference | When to Load |
|---|
references/01-requirements-template.md | Generating Step 1 requirements |
references/02-architecture-template.md | Generating Step 2 assessment or Step 3 cost estimate |
references/04-plan-template.md | Generating Step 4 plan, governance, or preflight |
references/05-code-template.md | Generating Step 5 implementation reference |
references/06-deploy-template.md | Generating Step 6 deployment summary |
references/07-docs-template.md | Generating Step 7 workload documentation |
references/styling-standards.md | Applying callouts, badges, emoji, navigation |
references/cost-estimate-sections.md | Cost estimate H2 structure and formatting rules |