[User Story] docs-05: Restructure Core Docs Site Information Architecture

[djm81]

User Story

As a SpecFact user, I want the core docs site (docs.specfact.io) to have a clear progressive navigation from beginner to advanced, so I can quickly find platform and module system guidance without getting lost in a flat list of 50+ guides.

OpenSpec Change

• Change folder: openspec/changes/docs-05-core-site-ia-restructure/
• Parent Feature: [Feature] Documentation & Discrepancy Remediation #356 (Documentation & Discrepancy Remediation)
• Priority: P0 (foundational)

Scope

• Restructure core docs sidebar from 5 flat sections to 6 focused sections: Getting Started, Core CLI, Module System, Architecture, Reference, Migration
• Create new directories: docs/core-cli/, docs/module-system/, docs/migration/
• Write 4 new core CLI reference pages (init, module, upgrade, quickstart)
• Update sidebar navigation in _layouts/default.html
• Rewrite landing page and getting-started
• Add jekyll-redirect-from entries for all moved URLs
• Delete marketing/internal docs

Source Plan

specfact-cli-internal/docs/internal/implementation/2026-03-23-docs-refactoring-beginner-to-enterprise-plan.md