Astro First for AI-Managed Sites
Why this proof of concept starts with Astro instead of a more opinionated digital-garden generator.
This site starts with Astro because the primary experiment is not only publishing a blog. The experiment is whether a repository can act as the durable source of truth for a site that AI agents can inspect, edit, validate, and deploy with low ceremony.
Static Markdown remains the default because articles and evergreen notes do not need a database or server runtime. Astro adds structure around that source material through content collections, typed frontmatter, predictable routing, and the option to introduce small interactive pieces later.
Quartz remains an important reference point. Backlinks, graph views, search, and wiki-style notes are useful ideas. The tradeoff is that Astro gives this project a more general application shape while still preserving a static publishing core.
For now, the site should prove the basics:
- Markdown files are the source of truth.
- Frontmatter is validated before deploy.
- Production output is static.
- AI-facing indexes are generated from the same content as the human-facing pages.
- Dynamic features are introduced only when they clearly improve the site.