lat-md-knowledge-graph

lat.md Knowledge Graph

Purpose

Turn durable project knowledge into linked markdown files that agents can search, cite, and keep synchronized with code.

When to Use

• One root instruction file is too large or hides domain decisions.
• Agents repeatedly rediscover the same architecture or business rules.
• Test intent needs explicit specs linked to test code.
• A custom harness needs persistent memory outside conversation history.

Design Pattern

1. Create a repo-local knowledge directory such as lat.md/ or docs/knowledge/.
2. Split pages by durable concepts: architecture, domain rules, workflows, interfaces, test specs, and operational constraints.
3. Link concepts with [[wiki links]].
4. Link knowledge pages to source symbols or files.
5. Add code backlinks such as comments or metadata where the code implements a documented rule.
6. Add a check that fails on broken links, missing backlinks, stale indexes, or test specs without code mentions.

ctx Fit

Use this alongside ctx's LLM-wiki when a project needs its own local memory graph. ctx recommends skills/MCPs/agents from its catalog; the repo-local graph stores project-specific facts that should not live in the global catalog.

Quality Bar

• Page titles and section anchors are stable.
• Links resolve both ways where needed.
• Code backlinks are narrow and reviewable.
• Checks run in CI before merge.
• Sensitive facts stay out unless the repo already allows them.
• The graph explains current behavior, not a speculative roadmap.