Awesome GitHub Site - Improve discovery, navigation, and search

[ashleyshaw]

Problem Statement

Current site has navigation and discovery friction that will worsen as content grows:

• Header navigation is cluttered and doesn't reflect site structure
• Multiple 404 errors exist on the site (slides don't work, broken links)
• Homepage structure is unclear and doesn't guide visitors logically
• Discovery of resources requires manual browsing without search or filtering

Issues to Fix

1. Cluttered header navigation — Simplify and reorganise to reflect nine section categories
2. 404 errors — Audit site and fix all broken links and non-functional features (e.g., slides)
3. Homepage structure — Restructure for logical flow: hero → overview → quick links → featured sections
4. Discovery friction — Add filtering, search, or tagged browsing on all catalogue pages
5. Padding and spacing — Fix inconsistent whitespace and visual balance issues
6. Logo and visual identity — Strengthen logo with appropriate iconography
7. Navigation clarity — Add breadcrumbs, clear section headers, and consistent visual hierarchy

Proposed Solution

• Header redesign: Collapse to essential navigation + dropdown for sections (Agents, Instructions, Skills, Hooks, Plugins, Workflows, Tools, Learning Hub, Getting Started)
• 404 audit: Crawl built site, identify all broken links, fix content and links
• Homepage restructure: Hero section → what is Awesome GitHub → why you're here → featured sections → call to action
• Discovery UI: Add tags, category filters, and optional search (static site compatible) on hub pages
• Design refinement: Audit and fix padding, spacing, alignment across all pages
• Visual identity: Update logo with stronger icon, ensure brand consistency

Acceptance Criteria

• Header navigation is decluttered and shows clear structure
• All 404 errors are identified and resolved
• Homepage has clearer logical structure (hero → value → navigation → featured)
• Discovery controls (filtering/search) are working on catalogue pages
• Design refinements for padding and spacing are complete
• Logo is updated with stronger icon
• Navigation hierarchy is clear and consistent across all pages
• Mobile responsiveness verified on homepage and navigation
• Documentation/changelog updated
• Correct labels/types applied

Testing Requirements

• Manual 404 audit on built site
• Navigation testing across all breakpoints
• Homepage usability testing
• Filtering/search functionality on catalogue pages
• Accessibility testing for navigation (keyboard, screen reader)

Alternatives Considered

• Static category browsing only (less discovery friction than current)
• Search plus category browsing (best user experience for large catalogues)
• Tag-based filtering (good compromise between simplicity and discovery)

Additional Context

This issue should be completed alongside the catalogue structure (issue #763) so all nine sections are discoverable. Footer remains unchanged per design requirements."

[linear-code]

LS-913