optimize-docs

To optimize documentation structure, analyze content scope and usefulness to identify opportunities for reducing verbosity, splitting large documents, and correcting structural issues across project directories. The process provides actionable recommendations for streamlining content.

Splitting large feature-specs and architecture documents involves analyzing content scope to propose dividing extensive files into focused topics. This removes redundancy and improves accessibility by ensuring each document covers a single, clear subject area.

Identifying obsolete material in feature-designs and architecture docs requires analyzing content relevance against current project scopes. The analysis flags outdated content and returns actionable recommendations for removing obsolete material to keep documentation accurate.

Checking documentation alignment with framework-core ADR and DES templates is supported during the analysis phase. The process enforces alignment with these templates and returns recommendations for correcting structural deviations.

Documentation optimization works across all docs or a specific topic, file, or directory within feature-specs, feature-designs, architecture, and design scopes. It analyzes the targeted scope to generate a prioritized plan for improving document clarity and structure.