structured-docs-migration

Community

Migrate legacy docs to stable YAML artifacts.

AuthorPriNova
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Legacy prose-style documentation is brittle, hard to version, and incompatible with automated workflows. This skill migrates those artifacts into canonical structured YAML for agent-first ingestion, enabling reliable, schema-driven processing and elimination of deprecated Markdown generation in the final artifact set.

Core Features & Use Cases

  • Converts legacy prose docs under docs/agent/api and related mappings into stable, structured YAML artifacts using the resolved structured docs root.
  • Enforces the artifact write/update protocol: stable IDs, evidence, cross-links, and envelope conformance to shared schemas.
  • Supports end-to-end migration including mapping legacy inputs (AGENTS.md, REPO_INVENTORY.md, PROJECT_INTENT.md, ARCHITECTURE.md, DATA_FLOW.md, DATA_MODEL.md, INVARIANTS.md, DEPENDENCY_RULES.md, DESIGN_ISSUES.md, RISK_REGISTER.md, CHANGE_GUIDE.md, TESTING_STRATEGY.md, VALIDATION_BASELINE.md, CONTRACTS.md, adr/*.md, SCOPES.md) to structured artifacts and validating references.

Quick Start

Map legacy prose docs to canonical YAML artifacts under the resolved structured docs root using the migration workflow.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: structured-docs-migration
Download link: https://github.com/PriNova/pi-agent-codebase-workflows/archive/main.zip#structured-docs-migration

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 510,000+ vetted skills library on demand.