Python knowledge index generator
Python knowledge index generator
Section titled “Python knowledge index generator”Use Case
Section titled “Use Case”Use the Python utility when you add or edit Markdown entries under src/content/docs/knowledge/.
The MVP utility uses the Python standard library for the sample schema. Run it with Python 3.11 or newer.
Workflow
Section titled “Workflow”python3 scripts/teamwiki.py validatepython3 scripts/teamwiki.py generatePitfalls
Section titled “Pitfalls”Do not edit generated files by hand unless you are debugging. Regenerate src/data/browse.json, public/ai/index.json, public/ai/chunks.jsonl, and public/llms.txt from source Markdown.
Reuse Notes
Section titled “Reuse Notes”CI should run the Python generation step before the Astro build so generated browse pages and AI artifacts stay fresh.