Nizam design docs, ADRs, research, and architecture documentation
Find a file
nizam-admin 18b966b7e9 docs: initial knowledge base — ADRs, architecture docs, memory
21 design ADRs from infra-docs/design/nizam/, 7 reference docs,
9 nizam/ reference files, 3 memory/architecture docs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 04:56:15 -05:00
design docs: initial knowledge base — ADRs, architecture docs, memory 2026-05-11 04:56:15 -05:00
memory docs: initial knowledge base — ADRs, architecture docs, memory 2026-05-11 04:56:15 -05:00
reference docs: initial knowledge base — ADRs, architecture docs, memory 2026-05-11 04:56:15 -05:00
README.md docs: initial knowledge base — ADRs, architecture docs, memory 2026-05-11 04:56:15 -05:00

nizam-knowledge-base

Design docs, ADRs, architecture documentation, and operational memory for the Nizam platform.

Structure

design/          Architecture Decision Records (ADRs) and design specs
reference/       Reference documentation and operational guides
reference/nizam/ Nizam-specific operational reference (API, schemas, labels)
memory/          Distilled architecture notes and migration runbooks

Key Documents

Migration & Architecture

  • memory/nizam-aws-migration.md — Phase-by-phase AWS migration runbook
  • memory/nizam-architecture.md — Action Plane, Protocol Engine, component map
  • design/adr-nizam-product-aws-migration.md — Migration architecture decision
  • reference/nizam-aws-accounts.md — Account structure (SharedSvc / Prod)

Infrastructure

  • design/adr-nizam-dual-tailnet-access.md — Tailnet proxy pattern for nizam-prod
  • design/adr-nizam-prod-cluster-cni.md — EKS CNI decision
  • reference/nizam-infra-architecture.md — Infrastructure overview
  • reference/nizam-infra-cicd.md — CI/CD pipeline reference

Action Plane & Protocol Engine

  • memory/nizam-alignment.md — Nizam mission and design principles
  • design/adr-formula-registry-multi-tenant-wft-management.md — WFT management
  • reference/nizam-protocol-engine-preflight.md — Pre-flight types and enforcement
  • reference/nizam/workrequest-schema.md — WorkRequest schema
  • reference/nizam/label-taxonomy.md — Bead label taxonomy

Memory & Knowledge

  • design/adr-agent-memory-hindsight-vs-mem0-spike.md — Memory backend selection
  • design/adr-hindsight-llm-model-selection.md — LLM model selection for memory
  • design/adr-memory-retrieval-landscape-2026-04.md — Memory retrieval landscape

Identity & Auth

  • design/adr-nizam-keycloak-federation.md — Keycloak OIDC federation
  • reference/nizam-auth-keeper.md — Auth Keeper service reference