organizar-documentacao

Organizing legacy Markdown documentation is done by normalizing files into a Diátaxis-aligned structure, creating domain indexes and changelogs to build a coherent, navigable map within the ./docs folder.

Git change detection for documentation works through read-only Git inspection to identify relevant repository updates, guiding the reorganization of domain pages and root indexes to reflect new or moved content.

Automating documentation maintenance based on Git history involves auditing repository changes and applying templates and scaffolding to align new domains with the documentation map.

Restructuring an existing docs folder with Diátaxis normalizes legacy Markdown into domain pages and updates root indexes while preserving content through a lightweight, production-grade workflow.

This documentation indexing approach does not modify your Git repository directly; it restricts all edits to read-only Git analysis and document normalization to safely reorganize content.

Diátaxis should not be used when your documentation cannot be normalized into its four domain categories, as this skill enforces a lightweight, production-grade workflow strictly aligned with that specific framework.