Awesome GitHub Site - Phase 2 Full Website

[ashleyshaw]

Epic Summary

Expand the phase 1 GitHub Pages MVP into the full Awesome GitHub website with comprehensive resource catalogues, refined design, improved navigation, and team onboarding support. The site will serve as a unified reference hub for discovering and understanding LightSpeed's AI agents, instructions, skills, hooks, plugins, workflows, tools, and learning materials.

Vision

"One .GitHub to Rule Them All" — a centralised discovery platform that onboards teams into LightSpeed's extensible AI operations ecosystem, modelled on the structure of awesome-copilot.github.io.

Scope

Phase 2a: Homepage Redesign & Navigation Overhaul

• Fix cluttered header navigation
• Restructure homepage for clarity and logical flow
• Resolve existing 404 errors and broken links
• Fix padding and spacing inconsistencies
• Strengthen logo and visual identity
• Keep footer design (no changes)

Phase 2b: Core Resource Catalogue Sections

• /agents/ — AI agents and their capabilities
• /instructions/ — Role and instruction documents
• /skills/ — Reusable task automation skills
• /hooks/ — Pre-commit and workflow guardrails

Phase 2c: Additional Resource Sections

• /plugins/ — WordPress and development plugins
• /workflows/ — Portable agentic workflows
• /tools/ — Supporting utilities and helpers
• /learning-hub/ — Educational content and guides

Phase 2d: Onboarding & Launch Validation

• /getting-started/ — Team onboarding guide
• Full accessibility audit and fixes (WCAG AA)
• Content governance and consistency validation
• Final launch readiness review

Linked Stories/Tasks

• Awesome GitHub Site - Add resource catalogue and category browsing #763 Build resource catalogue structure with all nine section pages
• Awesome GitHub Site - Improve discovery, navigation, and search #764 Fix navigation, discovery, and fix existing 404s and broken slides
• Awesome GitHub Site - Document the full content model and governance #765 Document the full content model and governance for all new sections
• Awesome GitHub Site - Accessibility and launch validation for the full site #766 Complete accessibility and launch validation for the full site

Acceptance Criteria

• All nine section pages are created and deployed
• Homepage is restructured with clearer information architecture
• Header navigation is decluttered and functional
• All 404 errors and broken links are resolved
• Design refinements (padding, logo, spacing) are complete
• Content governance is documented and followed
• Site meets WCAG AA accessibility standards
• Footer remains unchanged
• Site is ready for team onboarding use

Timeline

Phase 2a: Homepage & navigation fixes (1-2 weeks)
Phase 2b: Core catalogue sections (2 weeks)
Phase 2c: Additional sections (2 weeks)
Phase 2d: Validation & launch (1 week)

Dependencies / Blockers

• Requires the phase 1 site to be live and stable ✓
• Must preserve the GitHub Pages custom domain and HTTPS setup from phase 1 ✓
• Pending: Finalised design system and colour palette for homepage refresh

Additional Context

This epic transforms the site from an MVP into a full-featured resource discovery and team onboarding platform. Reference architecture: awesome-copilot.github.io"

[linear-code]

LS-911