Sort docs into types readers recognize

Steps

1. 1Label every existing page: learning-journey, task-recipe, information-lookup, or theory
2. 2Flag pages mixing modes; split at natural seams
3. 3Write one flagship tutorial covering the happy path end-to-end
4. 4Move edge-case handling into linked how-to recipes
5. 5Generate reference mechanically from source where possible
6. 6Add 'which page do I need?' router for newcomers

Common Pitfalls

• ▲Tutorials stuffed with tangents breaking flow
• ▲Reference prose explaining philosophy nobody asked

Commands

$ npx skills add aniruddhaadak80/skills --skill docs-systems-diataxis-audit

$ npx skills add aniruddhaadak80/skills --skill docs-systems-diataxis-audit -g

Tags