jester/knowledge-base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
9f9b88b662
knowledge-base/README.md

6.0 KiB
Raw Blame History

📚 ZeroLagHub Knowledge Base

Single source of truth for AI context across sessions

Last Updated: April 7, 2026
Repository: https://git.zerolaghub.com/jester/knowledge-base

🎯 Purpose

This repository provides persistent documentation that both Claude (architecture) and Ceàrd/GPT (implementation) can access across chat sessions without re-uploading files.

Base URL for raw files:

https://git.zerolaghub.com/jester/knowledge-base/raw/branch/main/

AI Role Split

AI Role Workspace
Claude Architecture, strategy, design decisions jester/knowledge-base
GPT (Ceàrd) Implementation, code, verification, session continuity jester/zlh-grind

Hard rule: GPT must not make architecture decisions. If architectural interpretation is required, stop and defer to Claude or canonical docs.

📁 Core Documents

Current (April 2026)

File Purpose Primary User
ZeroLagHub_Master_Bootstrap_Apr2026.md Platform overview, infrastructure, architecture rules, current state, pre-launch blockers Claude
ZeroLagHub_Cross_Project_Tracker.md Architectural boundaries, drift prevention, ADL Both
ZeroLagHub_Drift_Prevention_Card.md 30-second session starter, quick checks Both
ZeroLagHub_Infrastructure_Specifications.md Hardware specs, capacity constraints Both

Reference / Historical

File Notes
ZeroLagHub_Master_Bootstrap_Dec2025.md Superseded — kept for historical reference
ZeroLagHub_GPT_Implementation_Handover_Dec2025.md Superseded — GPT now uses zlh-grind for continuity
ZeroLagHub_Complete_Current_State_Dec7.md Historical snapshot
ZeroLagHub_Complete_Current_State_Jan2026.md Historical snapshot
ZeroLagHub_Quick_Status_Feb2026.md Historical snapshot
Session_Summaries/ Historical session notes

🚀 Session Start Instructions

For Claude (Strategic/Architecture Sessions)

Quick Start:

1. Read: ZeroLagHub_Master_Bootstrap_Apr2026.md (platform context)
2. Read: ZeroLagHub_Cross_Project_Tracker.md (architectural boundaries)
3. Reference: zlh-grind/INFRASTRUCTURE.md for current IPs/VMs

URLs to Fetch:

https://git.zerolaghub.com/jester/knowledge-base/raw/branch/main/ZeroLagHub_Master_Bootstrap_Apr2026.md
https://git.zerolaghub.com/jester/knowledge-base/raw/branch/main/ZeroLagHub_Cross_Project_Tracker.md

Session Start Template:

Read knowledge base:
1. https://git.zerolaghub.com/jester/knowledge-base/raw/branch/main/ZeroLagHub_Master_Bootstrap_Apr2026.md
2. https://git.zerolaghub.com/jester/knowledge-base/raw/branch/main/ZeroLagHub_Cross_Project_Tracker.md

Context: [What needs architectural guidance]
Decision: [What needs to be decided]

For Ceàrd/GPT (Implementation Sessions)

Quick Start:

1. Read: zlh-grind/SCRATCH/handover-apr-2026.md (current state)
2. Read: zlh-grind/OPEN_THREADS.md (active work)
3. Read: zlh-grind/INFRASTRUCTURE.md (IPs + VMs)

Session Start Template:

Read knowledge base:
1. https://git.zerolaghub.com/jester/zlh-grind/raw/branch/main/SCRATCH/handover-apr-2026.md
2. https://git.zerolaghub.com/jester/zlh-grind/raw/branch/main/OPEN_THREADS.md

Current task: [Specific implementation task]

🔒 Critical Governance

11 Locked Architectural Decisions (Cannot change without "Revisit decision X")

  1. DEC-001: Templates + Agent hybrid (not templates-only or agent-only)
  2. DEC-002: API orchestrates, Agent executes (not reversed)
  3. DEC-003: API owns DNS (Agent never creates DNS)
  4. DEC-004: Traefik + Velocity only (no HAProxy)
  5. DEC-005: MariaDB is source of truth (no flat files)
  6. DEC-006: Frontend → API only (no direct agent calls)
  7. DEC-007: Drift prevention mandatory (always enforced)
  8. DEC-008: Control plane uses IP env vars, not internal.zlh DNS in hot paths
  9. DEC-009: Redis never restored from backup — always start clean
  10. DEC-010: Vanilla Minecraft uses Fabric loader + FabricProxy-Lite (not vanilla JAR)
  11. DEC-011: Velocity forwarding mode = modern (not none)

Details: See ZeroLagHub_Cross_Project_Tracker.md → Architecture Decision Log section

🔄 Keeping Knowledge Base Updated

After Major Changes

Claude updates:

  • ZeroLagHub_Master_Bootstrap_Apr2026.md — after architecture decisions or major state changes
  • ZeroLagHub_Cross_Project_Tracker.md — after locking new decisions
  • Session_Summaries/ — after significant architectural sessions

GPT updates:

  • zlh-grind/OPEN_THREADS.md — after completing or discovering work
  • zlh-grind/SCRATCH/handover-*.md — session handovers
  • zlh-grind/INFRASTRUCTURE.md — if IPs/VMs change

🚨 Emergency Session Recovery

If session loses context:

  1. Paste this README URL:

    https://git.zerolaghub.com/jester/knowledge-base/raw/branch/main/README.md

  2. AI reads README, identifies needed files

  3. AI fetches role-specific documents

  4. Context restored in <2 minutes

⚡ Quick Reference URLs

# Claude bootstrap (session start)
https://git.zerolaghub.com/jester/knowledge-base/raw/branch/main/ZeroLagHub_Master_Bootstrap_Apr2026.md

# Drift prevention (both AIs)
https://git.zerolaghub.com/jester/knowledge-base/raw/branch/main/ZeroLagHub_Drift_Prevention_Card.md

# Boundaries (before any code changes)
https://git.zerolaghub.com/jester/knowledge-base/raw/branch/main/ZeroLagHub_Cross_Project_Tracker.md

# GPT current state
https://git.zerolaghub.com/jester/zlh-grind/raw/branch/main/SCRATCH/handover-apr-2026.md

# GPT active work
https://git.zerolaghub.com/jester/zlh-grind/raw/branch/main/OPEN_THREADS.md

# Infrastructure (VMs + IPs)
https://git.zerolaghub.com/jester/zlh-grind/raw/branch/main/INFRASTRUCTURE.md

Repository Owner: jester
Platform: ZeroLagHub
Purpose: Single source of truth for AI context
Status: Operational ✅