TeamWiki stack decision
TeamWiki stack decision
Section titled “TeamWiki stack decision”Context
Section titled “Context”TeamWiki needs a modern static knowledge site, GitHub-native contribution flow, generated AI indexes, and utilities that are comfortable for Python-oriented contributors to maintain.
Decision
Section titled “Decision”Use Astro Starlight for the static site layer. Use Python for build-time knowledge-processing utilities such as frontmatter validation, browse data generation, and AI index generation.
Consequences
Section titled “Consequences”The deployed site remains static and can run on Cloudflare Pages, GitHub Pages, or any static host. Python runs only during local development and CI, so it does not add a production backend.
Reuse Notes
Section titled “Reuse Notes”When adding new knowledge metadata, update the Python validation schema first, regenerate browse data and AI indexes, then adjust Astro pages only if display behavior changes.