Skip to main content

System Architecture

GOTCHA framework, tool manifest, agent system documentation.

AAOS — ALAI Agent Operating System

Executive Summary AAOS is the enforcement runtime for the ALAI agent system. It turns optional pr...

Overview

System Architecture Overview This book documents the GOTCHA framework, tool manifest, and agent s...

GOTCHA Framework

Last Verified: 2026-02-17 | Owner: John GOTCHA Framework Ovaj sistem koristi GOTCHA — 6-layer a...

Tool Manifest

Last Verified: 2026-02-17 | Owner: John Tools Manifest CHECK THIS BEFORE CREATING NEW TOOLS. If...

Agent System Guide

Last Verified: 2026-02-17 | Owner: John Agent System Guide — Consolidated Last Updated: 2026-02...

Agent Laws

Last Verified: 2026-02-17 | Owner: John Zakoni Agenata — BasicAS Group Svaki agent u sistemu MO...

GOTCHA Framework & System Handbook

John — System Handbook (On-Demand Reference) Load this when you need infrastructure details, CLI ...

Agent System Guide (Consolidated)

Agent System Guide — Consolidated Last Updated: 2026-02-10 Consolidated From: 7 original document...

Infrastructure Overview

Runbook: Local Infrastructure Platform: Mac Studio M3 Ultra, 96GB RAM, macOS Services: Docker con...

AI Model & RAG Architecture

AI Model & RAG Architecture Pregled svih AI modela i RAG (Retrieval-Augmented Generation) kompon...

Petter Graff Architecture — 90-Day Roadmap

System Architecture — After Petter Graff Roadmap Datum: 2026-02-23  |  MC Tasks: #1840–#1852  |  ...

Chain Runner Architecture (Pi Agent Patterns)

Chain Runner Architecture MC Task #1902 — Pi Agent Patterns Author: Petter Graff (Software Archit...

ALAI Orchestration Architecture — Virtual Companies + Pi Agent Pipeline

ALAI Orchestration Architecture — Virtual Companies + Pi Agent Pipeline System Overview ALAI kori...

Virtual Company System — Deep Analysis & Improvements

ALAI Virtual Company System — Deep Analysis & Improvements Date: 2026-03-21 Team: Petter Graff (A...

Virtual Company Architecture — Overview & Board Evaluation

Overview ALAI operates a multi-company virtual organization where 16 specialized AI agent teams h...

AI Factory Map

AI Factory Map Last Updated: 2026-05-27 (AI Factory / P2P reliability update) Purpose: Single-pag...

Mehanik Phase 2 — Pre-Dispatch Gate System

Mehanik Phase 2 — Pre-Dispatch Gate System Status: LIVE since 2026-04-25 (MC #9231 deploy) Refere...

AI Factory v2 — Phase 0 Backbone

AI Factory v2 — Phase 0 Backbone Author: ALAI Version: 2026-04-27 Status: COMPLETE Executive Sum...

AI Factory v2 — Phase 1 Token Economics

AI Factory v2 — Phase 1 Token Economics Created: 2026-04-27 Phase: Phase 1 (Token Economics Wiri...

AI Factory v2 — Phase 2 Capability Cleanup

AI Factory v2 — Phase 2 Capability Cleanup Author: ALAI Date: 2026-04-28 Status: Complete Parent ...

youtube-learning v2 — FORGE Pipeline

# youtube-learning v2 — FORGE Pipeline **Status:** Active (side-by-side with v1) **Author:** A...

AI Factory Pipeline — Gate Matrix & Dispatch Flow

ALAI AI Factory Pipeline — Gate Matrix & Dispatch Flow Status: Spec for MC #10536 (parent #10612 ...

AI Factory Pipeline — Gate Matrix & Dispatch Flow

ALAI AI Factory Pipeline — Gate Matrix & Dispatch Flow Status: Spec for MC #10536 (parent #10612 ...

AI Factory Pipeline — Gate Matrix & Dispatch Flow

ALAI AI Factory Pipeline — Gate Matrix & Dispatch Flow Status: Spec for MC #10536 (parent #10612 ...

AI Factory Audit 2026-05-14 — Connection Map

AI Factory Audit 2026-05-14 — Connection Map Audited: 2026-05-14, 8 zones (5 core + 3 follow-up) ...

ADR-026 pi-orchestrator reactivation (supersedes ADR-025) — 2026-05-14

Why This Matters On 2026-05-14 at 10:14:41, pi-orchestrator successfully picked up and claimed ta...

pi-orch Mini-Verifier — local-LLM closure gate (MC #100608)

pi-orch Mini-Verifier — Local-LLM Closure Gate MC: #100608 | Owner: AgentForge | Status: WARN_MO...

Evidence-SSoT Phase 0 — Knowledge Propagation Infrastructure (2026-05-15)

Evidence-SSoT Phase 0 — Knowledge Propagation Infrastructure (2026-05-15) Problem (CEO trigger 20...

Reality Anchor Doctrine v1

$(cat /tmp/evidence-100822/page-content.md | jq -Rs .)

Reality Anchor Doctrine v1 (Final)

Reality Anchor Doctrine v1 Published: 2026-05-15 Authority: CEO directive 2026-05-15 → Petter Gra...

LightRAG Tuning — cosine_threshold 0.5, related_chunk_number 10

LightRAG Tuning — cosine_threshold 0.5, related_chunk_number 10 (2026-05-12) Status: LIVE Date S...

ZAKON Phase A FU-1: Evidence Field Migration (approver → agent)

ZAKON Phase A FU-1: Evidence Field Migration (approver → agent) MC: #100390 (Subtask 3) Date: 20...

Opus Cost Guard Hook (2026-05-17)

Opus Cost Guard Hook (2026-05-17) MC: #101140 (AI Factory T-3 Priority 2) Parent: Reality Anchor...

Schema Stub Gate + Claim Schema Injector (MC #101065)

Schema Stub Gate + Claim Schema Injector (MC #101065) MC: #101065 (Deterministic Session Compile...

mc.js Force Approval Queue (MC #100818)

mc.js Force Approval Queue (MC #100818) MC: #100818 (Reality Anchor P1.1 — Remove --force bypass...

4 Deterministic Probes (MCs #101133-#101136)

4 Deterministic Probes (MCs #101133-#101136) Parent MC: #101065 (Deterministic Session Compiler ...

Attack J Security Fix (MC #101149)

Attack J Security Fix (MC #101149) MC: #101149 (Attack J — evidence-ledger writer identity spoof...

John+AI Factory Unified Fix - 2026-05-17 Session

John + AI Factory Unified Fix — 2026-05-17 Session Date: 2026-05-17 Session ID: (recorded in ses...

Claude Code Multi-Session Isolation

Claude Code Multi-Session Isolation**Status:** Production (all 7 P0 resources verified SAFE) **D...

Multi-Session Isolation — Phase 3 P1 Sweep

Phase 3 — P1 Isolation Sweep + P2 Mini-Probe Log**Owner:** CodeCraft (Petter Graff lead)**Date:**...

Multi-Session Isolation — T10-quad Validation

T10-quad Validation Report — Phase 3 P1 Isolation Sweep**Owner:** Proveo (Angie Jones)**Date:** 2...

ALAI AI System — Operating Picture 2026-05-18 (CEO Audit)

ALAI AI System — Operating Picture 2026-05-18 Date: 2026-05-18 Architect: Petter Graff Status: VA...

Cost Ceiling Doctrine — UserPromptSubmit Main-Session Gate

Cost Ceiling Doctrine — UserPromptSubmit Main-Session Gate Status: DRAFT — Awaiting Skillforge Bo...

Reality Anchor — Probe Daemons and Watchdog

Reality Anchor — Probe Daemons and Watchdog Status: DRAFT (MC #101450, 2026-05-19) Author: FlowFo...

ALAI AI System — v2.0 Operating Picture & Master Roadmap

ALAI AI System — v2.0 Operating Picture & Master Roadmap Date: 2026-05-19 Architect: Petter Graff...

Claude Builder Durable Runner Triage

Claude Builder Durable Runner Triage Date: 2026-05-19 MC: #101542 Verdict durable-runner.db is he...

ZAKON 12 RAG Context Injection Hook

ZAKON 12 RAG Context Injection Hook MC: #101494 Task: [MC-B05] ZAKON #12 PreToolUse[Task] hook wi...

Email MC Linkage Fix

Email MC Linkage Fix MC: #101510 Task: [MC-C1-1] Fix email→MC linkage daemon Book: System Archite...

Discover JS Routing Subcommand

Discover JS Routing Subcommand MC: #101511 Task: [MC-C1-2] discover.js routing subcommand — fix f...

PI Orchestrator Route Expand

PI Orchestrator Route Expand MC: #101512 Task: [MC-C4-1] PI-orchestrator route_eligibility expand...

MC Backlog TTL Policy

MC Backlog TTL Policy MC: #101513 Task: [MC-C2-1] MC backlog TTL policy + auto-pause/auto-close B...

Session Spend Ladder

Session Spend Ladder MC: #101526 Task: [MC-C2-2] Session-spend ladder Book: System Architecture C...

Skill Registry Rebuild

Skill Registry Rebuild MC: #101527 Task: [MC-C3-2] Skill registry rebuild — 96 dirs vs 1 row Book...

MCP Cleanup 2026 05

MCP Cleanup 2026 05 MC: #101528 Task: [MC-C3-3] MCP cleanup — 5 dormant servers Book: System Arch...

CEO Daily Digest

CEO Daily Digest MC: #101529 Task: [MC-C5-1] CEO escalation hook + Slack digest Book: System Arch...

Specialist Mapping Cleanup 2026 05

Specialist Mapping Cleanup 2026 05 MC: #101540 Task: [MC-C1-3] specialist-mapping cleanup — 13 or...

TLDR Daemon Verify

TLDR Daemon Verify MC: #101541 Task: [MC-C1-4] TLDR daemon verify path + reload Book: System Arch...

Cost Guard Grace Period Fix

Cost Guard Grace Period Fix MC: #101467 Task: [T-A-02b-r1] Cost guard polish — RunAtLoad grace Bo...

Reality Anchor P3

Reality Anchor P3 MC: #100885 Task: P3.2 integration test task Book: System Architecture Canonica...

FORGE Route Gate MC101641

FORGE Route Gate MC101641 MC #101641 implements forge-route-gate.sh, a Claude Code PreToolUse:Tas...

FORGE Dispatch Wrapper MC101640

FORGE Dispatch Wrapper MC101640 MC #101640 provides forge-dispatch.js, a local FORGE dispatcher f...

MEMORY.md compact index contract — MC #101645

MC #101645 — MEMORY.md compact index contract Status: implemented locally with deterministic line...

MC #101646 — Memory/vector store decommission sweep

MC #101646 — Memory/vector store decommission sweep Verdict: PARTIAL/BLOCKED. Safe cleanup comple...

MC 101647 — AutoCoder archive + durable executor HTTP consolidation

MC #101647 — AutoCoder archive + durable executor HTTP consolidation Verdict: PASS_WITH_SCOPE_NOT...

MC 101648 Agent Mapping Cleanup

MC 101648 Agent Mapping Cleanup Verdict: PASS Date: 2026-05-21 Task: [P3-2] Delete 23-32 unmapped...

MC 101649 Tools Directory Governance

MC 101649 Tools Directory Governance Verdict: PARTIAL / BLOCKED Date: 2026-05-21 Task: [P3-3] Too...

Killswitch Gate — PreToolUse + UserPromptSubmit

Killswitch Gate — PreToolUse + UserPromptSubmit Comprehensive token burn prevention via fa...

ALAI 4-Team Restructure — Dispatch Flow, FORGE Routing, MEMORY.md Contract

ALAI 4-Team Restructure — Dispatch Flow, FORGE Routing, MEMORY.md Contract MC task: #101653 Statu...

JSONL Evidence Ledger Schema — Anti-Hallucination V2

JSONL Evidence Ledger Schema — Anti-Hallucination V2 Component: JSONL append-only evidence ledger...

ALAI Companies × Products × File-System Catalog v1.0-draft

ALAI Companies × Products × File-System Catalog Status: v1 draft, observed state 2026-05-23 Sourc...

ADR-027 — P2P Agent Mesh Activation

ADR — P2P Agent Communication Pattern Evaluation MC: #101959 Author: John Date: 2026-05-24 Source...

Agentic Engineering → ALAI AI Factory Roadmap (2026-05-26)

Agentic Engineering → ALAI AI Factory Roadmap Date: 2026-05-26 Source video: https://www.youtube....

AI Factory Workflow — AI Factory MVP smoke workflow docs-only validation

AI Factory Workflow — AI Factory MVP smoke workflow docs-only validation Created: 2026-05-26T13:5...

AI Factory V2 — Workflow Templates and Status Pages

AI Factory V2 — Workflow Templates and Status Pages Standard internal templates for AI Factory wo...

AI Factory V2 — P2P Verifier Metrics and Quality Report

AI Factory V2 WP3 — P2P Verifier Metrics and Quality Report Generated: 2026-05-26T15:28:35.483Z S...

AI Factory V2 — Screen-Recordable Internal Demo Scenario

AI Factory V2 — Screen-Recordable Internal Demo Scenario Purpose: show the CEO thesis as an inter...

Company Mesh Auto-Responder Reliability Repair — MC 102104

MC #102104 — Company Mesh responder reliability repair Generated: 2026-05-26 Owner: john Scope: r...

AI Factory Workflow — AI Factory V3 internal productization: operator console for intake, workflow status, evidence packages, and P2P quality metrics

AI Factory Workflow — AI Factory V3 internal productization: operator console for intake, workflo...

AI Factory V3 Operator Console Plan — MC 102226

AI Factory V3 — Internal Operator Console Plan Generated: 2026-05-26 Parent MC: #102225 Plan/spec...

AI Factory V3 Operator Console — Implementation Status

AI Factory V3 Operator Console — Implementation Status Generated: 2026-05-26 Parent MC: #102225 P...

Disk & Memory Health Alarms — What Fires, Where It Lands, How to Test

Disk & Memory Health Alarms — What Fires, Where It Lands, How to Test Why This System Exists On 2...

SEO Readiness Portal — Real Audit Engine (2026-06-02)

SEO Readiness Portal — Real Audit Engine (2026-06-02) Status: DEPLOYED to production Scope: MC...

System Remediation 2026-06-04 (Library, Companies, Hooks, Agents)

System Remediation — 2026-06-04 (Library, Companies, Hooks, Agents) Author: John (AI Director) · ...

P2P Pairing Skills — CC sender + peer responder (MC #102988)

ALAI Company Mesh — P2P Pairing Skills (CC sender + peer responder) Built: MC #102988 (responder ...

Diff-only reviewer context contract (token discipline)

Diff-only reviewer context contract (token discipline) Book: System Architecture Status: Implemen...

Hook-file existence guard (settings.json ↔ disk integrity) — MC #103640

Hook-file existence guard (settings.json ↔ disk integrity) Book: System Architecture Status: Impl...

Cost logger over-count fix (cumulative re-sum) — MC #103671

Cost logger over-count fix (cumulative re-sum → idempotent per-session) Book: System Architecture...

LumisCare entity scrub (CareSafety/VCC/VCU/vivacare → LumisCare) — MC #103616

LumisCare entity scrub — CareSafetyInnovations/VCC/VCU/vivacare → LumisCare Book: System Architec...

Email-Reactor fail-closed fix — classifier failure / partner mail no longer auto-archived (MC #103815)

Incident / Root Cause ~/system/daemons/email-agent.js was FAIL-OPEN. When Ollama classification f...

RAG Flywheel Source-Priority and Curated Seed

RAG Flywheel Source-Priority and Curated Seed MC Task: #103899 Status: Complete, Proveo-validate...

ALAI Self-Healing Architecture

ALAI Self-Healing Architecture Document Date: 2026-06-19 Coverage Audit: MC #103940 light...

MC #104005 — GOTCHA Gate Degating (Code/System Tasks)

MC #104005 — GOTCHA Gate Degating for Code/System Tasks Date: 2026-06-19 Parent: #104003 (AI-Syst...

P0.7 Intake Classifier Decision — null-route backfill (MC 104025) 2026-06-21

SummaryP0.7 intake-classifier (MC #104025) ran a deterministic dry-run on 237 null-route open tas...

P0.7 Intake Classifier — null-route decision (MC 104025) 2026-06-21

DecisionNo bulk-apply. 237 null-route tasks, 140 = email noise, 8 auto-routeable. Lever exhausted...

Anthropic Outage Resilience — 529 Auto-Fallback Runbook

Anthropic Outage Resilience — 529 Auto-Fallback Runbook MC: #104217 T5 Owner: Skillforge Date: 20...