Navigation

How I Rebuilt a Personal Knowledge Base with Claude + Astro

Turning scattered Markdown, project notes, and research into a searchable, versioned knowledge system that can evolve over time.

Peach stone architecture and a sunlit archway

The hard part of a knowledge base is not putting files somewhere. It is keeping information findable, understandable, and reusable over time. I prefer to treat a knowledge base as a software system rather than an endlessly growing notes folder.

Move from folder thinking to a content model

Astro Content Collections work well as a static knowledge layer. Markdown remains the source format, but a schema requires every item to carry consistent metadata such as title, description, date, and tags. Navigation, search, RSS, archives, and related-content logic can then be derived from the same source of truth.

What Claude should and should not do

I use the model to help structure material, fill missing context, and identify duplication. I do not treat it as a source of facts. Primary material, citations, and important conclusions remain traceable to their original source of truth.

AI can reduce the cost of organizing information, but it cannot replace provenance.

A minimal workflow

  1. Put all source material in Git first so every change is reversible.
  2. Use schemas to constrain metadata instead of relying on naming habits.
  3. Let AI propose summaries and tags, then confirm them with a human or deterministic rules.
  4. Generate search indexes, RSS, sitemaps, and archives at build time.
  5. Add a database or server runtime only when a real interactive requirement appears.

Find published articles and project notes

Or explore a topic