Wiki Overview

This wiki is the persistent documentation and synthesis layer for TazLab knowledge work.

Purpose

The goal is to give both humans and agents a stable, organized place to accumulate knowledge over time instead of rediscovering it from raw documents on every query.

Current State

  • The wiki is now substantially populated across all planned sections.
  • The operational schema for agents is defined in ../AGENTS.md.
  • Seed pages define the TazLab system map, repository map, and knowledge-layer model.
  • The wiki is split into two trunks: the TazLab operational trunk and the software/technology reference trunk.
  • A Hugo publication adapter under publish/ renders the wiki via PaperMod, with wiki/homepage.md as the front door and wiki/index.md as the internal directory.
  • Sources, entities, concepts, topics, details, references, analyses, operations, and contexts directories are all populated with content.

Structure

The wiki is organized into the following directories:

  • wiki/sources/ — source summaries for blog posts and research
  • wiki/entities/ — durable pages for systems, repositories, and actors
  • wiki/concepts/ — conceptual and architectural cross-cutting pages
  • wiki/topics/ — larger synthesis pages organized by subject area
  • wiki/details/ — deep dives into specific components, configurations, and workflows
  • wiki/references/ — annotated configuration examples and code snippets
  • wiki/analyses/ — reusable investigations, comparisons, and drift notes
  • wiki/operations/ — practical runbooks and command references
  • wiki/contexts/ — pre-built operational contexts for common tasks

TazLab Positioning

This repository is meant to complement, not replace, other TazLab knowledge layers:

  • AGENTS.ctx/memory/ for active present-state memory and chronology
  • mnemosyne for semantic retrieval
  • wiki.tazlab.net for durable, browsable, interlinked documentation and synthesis

Seed Pages

Current Coverage

The wiki has comprehensive coverage across the following areas:

  • Entity hubs under wiki/entities/ for each main TazLab system, repository, and actor
  • Topic synthesis pages under wiki/topics/ covering cluster delivery, Flux DAG, secret flow, CRISP program structure, Tailscale networking, mnemosyne architecture, agent contexts, and technology reference
  • Deep-dive details under wiki/details/ with component-specific documentation for cert-manager, Traefik, External Secrets, mnemosyne, TazPod internals, Tailscale integration, and ephemeral-castle infrastructure
  • References under wiki/references/ with annotated configuration examples for Flux, TazPod, Tailscale, and ephemeral-castle
  • Operations runbooks under wiki/operations/ for troubleshooting and command references
  • Analyses under wiki/analyses/ capturing topology drift and cross-cutting investigations
  • Sources under wiki/sources/ summarizing blog posts and technical research
  • Agent contexts under wiki/contexts/ providing pre-built operational contexts