Artifact Formatting Compliance

Structural formatting checks for cookbook artifacts. Each artifact type (principle, guideline, ingredient, recipe, cookbook) has its own set of checks defining the required sections, ordering, and content rules. These checks are the authoritative spec that /lint-artifact and /approve-artifact evaluate against.

Architecture

/lint-artifact  →  Formatting Checks  →  Conventions  →  Frontmatter Standard
/approve-artifact     (this category)      (introduction/conventions.md)
  • Formatting checks define required structure per artifact type
  • Conventions define the shared frontmatter and cross-referencing rules all artifacts share
  • Checks here govern the artifact's markdown structure, not the code it describes

Sub-Categories

Category File Checks Scope
Principle Formatting principle-formatting.md 7 Required structure for principle artifacts
Guideline Formatting guideline-formatting.md 8 Required structure for guideline artifacts
Ingredient Formatting ingredient-formatting.md 16 Required structure for ingredient artifacts
Recipe Formatting recipe-formatting.md 14 Required structure for recipe artifacts (compositions)
Cookbook Formatting cookbook-formatting.md 10 Required structure for cookbook manifests (JSON)
version
1.2.0
status
draft
tags
compliance, artifact-formatting, index
author
Mike Fullerton
modified
2026-04-05

Change History

Version Date Author Summary
1.2.0 2026-04-06 Mike Fullerton Rename concoction to cookbook
1.1.0 2026-04-05 Mike Fullerton Add ingredient and concoction formatting categories
1.0.0 2026-04-04 Mike Fullerton Initial creation