structured-docs-migration

To convert legacy Markdown documentation into structured YAML artifacts, you map prose-style inputs like ARCHITECTURE.md and DATA_FLOW.md to canonical structured counterparts. This process enforces stable IDs, cross-links, and schema validation for agent-first ingestion.

Structured documentation migration eliminates deprecated Markdown generation by converting brittle prose into canonical structured YAML. This schema-driven approach ensures reliable, automated processing and replaces inconsistent Markdown files with stable artifacts.

Validating schema references during a YAML documentation migration is handled by enforcing envelope conformance to shared artifact schemas. The migration workflow validates cross-links and evidence during upsert and compaction operations to ensure reference integrity.

You can migrate repository-level ADRs and scoped docs into structured YAML by applying the migration workflow to inputs like adr/*.md and SCOPES.md. It maps these legacy files to their artifact counterparts under the resolved structured docs root.

The structured documentation migration workflow supports upsert and compaction for YAML artifacts. It applies the artifact write/update protocol to ensure stable IDs, cross-links, and evidence conform to shared schemas during these operations.