.agents/memory/2026-02-23-astro-docs-migration-task-assignment.md

2026-02-23 Session Notes

Astro Docs Migration — Task Assignment

Docs-worker joined the astro-migration team and received task #2: setting up Astro Content Collections for the documentation system. The task builds on completed Task #1 (Base layout, Nav, Footer, global.css).

Task Scope

The docs-worker is responsible for creating six Astro components and config files:

1. content.config.ts — Glob-based content collection loader pointing at ../../docs, excluding docs/wip/
2. docs.css — Sidebar, prose, code block, and responsive layout styles using Signet CSS variables
3. Docs.astro layout — Sidebar + content grid with Base layout inheritance
4. Sidebar.astro component — Navigation sidebar that groups docs by section and sorts by order field
5. docs/index.astro — 301 redirect to /docs/quickstart
6. docs/[...slug].astro — Dynamic route rendering individual docs

Documentation Structure

26 total docs across 4 sections ordered for display:

• Getting Started (2): Quickstart, Configuration
• Core Concepts (6): Memory System, Pipeline, Skills, Memory Skills, Secrets, Hooks
• Reference (7): CLI, API, SDK, Daemon, Auth, Connectors, Harnesses
• Infrastructure (5): Architecture, Dashboard, Diagnostics, Analytics, Documents
• Project (5): Self-Hosting, Vision, README, Contributing, Roadmap, Agents

Frontmatter has already been added to all doc files (per task constraints).

Key Design Notes

Sidebar must group sections in fixed order: Getting Started → Core Concepts → Reference → Infrastructure → Project. Within each section, docs are sorted by order frontmatter field. Current page is highlighted. All styling uses Signet's existing CSS variable system (colors, fonts, spacing).