Sidebar Reorg AGENTS

archived Visibility internal Owner erik@uvilo.com Approver _ Created _ Updated _

Purpose

Maintain and evolve the documentation site’s sidebar, project page generation, and non-Markdown file viewing system. The Sidebar Reorg generator produces INDEX.md files and file-view pages for every project.

Read First

State — current status and completed work
Spec — ideal end-state specification
Plan — implementation plan (partially executed)

Key Files

File	Purpose
`Sidebar_Reorg_State.md`	Current status
`Sidebar_Reorg_Spec.md`	Desired end-state for sidebar and project pages
`Sidebar_Reorg_Plan_Implementation.md`	Full implementation plan
`Sidebar_Reorg_Requirements.md`	Functional requirements
`Sidebar_Reorg_History.md`	Session history
`scripts/generate_view_pages.ts`	The generator script
`view_folder_config.json`	Generator configuration

Constraints

Curated human content goes in README.md (preserved on regeneration)
The generator runs from .internal/ using the Starlight content collection
Sidebar entries in .internal/astro.config.mjs must be updated manually for new files