Skip to content

LlmWikis knowledge page

LLM Wiki Structure

An LLM Wiki should separate orientation, ownership, organization context, product context, architecture, operations, decisions, policies, agent rules, and onboarding. The structure below is intentionally boring: predictable paths are what make the wiki useful to agents.

Recommended folder structure

llm-wiki/
  README.md
  INDEX.md
  GOVERNANCE.md
  TRUST_MODEL.md
  CONTRIBUTING.md
  CHANGELOG.md
  organization/
    MISSION.md
    PRINCIPLES.md
    TEAMS.md
    GLOSSARY.md
  products/
    PRODUCT_OVERVIEW.md
    ROADMAP.md
    CUSTOMER_SEGMENTS.md
    FEATURE_INVENTORY.md
  architecture/
    SYSTEM_OVERVIEW.md
    SERVICES.md
    DATA_FLOWS.md
    DEPENDENCIES.md
    ARCHITECTURE_DECISIONS.md
  operations/
    RUNBOOKS.md
    INCIDENTS.md
    RELEASE_PROCESS.md
    SUPPORT_PROCESS.md
  decisions/
    DECISION_LOG.md
    OPEN_QUESTIONS.md
    TRADEOFFS.md
  policies/
    SECURITY.md
    PRIVACY.md
    DATA_HANDLING.md
    AI_USAGE_POLICY.md
  agent/
    AGENT_INSTRUCTIONS.md
    RETRIEVAL_GUIDE.md
    UPDATE_RULES.md
    CITATION_RULES.md
    SAFETY_BOUNDARIES.md
  onboarding/
    HUMAN_ONBOARDING.md
    AGENT_ONBOARDING.md
    QUICK_START.md

Why these folders exist

Folder Job Agent behavior
organization/ Mission, principles, teams, glossary, and shared language. Use for orientation and term disambiguation.
products/ Product overview, roadmap, customer segments, and feature inventory. Use to understand customer-facing context before implementation claims.
architecture/ System overview, services, data flows, dependencies, and architecture decisions. Use before suggesting technical changes.
operations/ Runbooks, incidents, release process, and support process. Summarize and check; do not execute protected actions.
decisions/ Decision log, open questions, tradeoffs, and supersession notes. Preserve uncertainty and rejected options.
policies/ Security, privacy, data handling, and AI usage policy. Treat as high-authority; require human review for edits.
agent/ Agent instructions, retrieval, update, citation, and safety rules. Read before editing; follow permission boundaries.
onboarding/ Quick starts for people and agents. Use for first-session context, not as full authority.