RABS Master Manual Scaffold
Architecture & Operational Intelligence Manual
Master Document Scaffold (v0.2)
0. Front Matter
0.1 Title Page
0.2 Birth Certificate of Reginald Atticus Benedict Singleton III
0.3 How to Read This Manual
0.4 About Disability South West (DSW)
0.5 Purpose of RABS
0.6 Glossary of Core Terms
0.7 Four Primitives Ontology
- Templates
- Instances
- Sources
- Intents
0.8 Workshed / Loom / Ribbon Map
0.9 Versioning & Edition History
1. System Overview & Philosophy
1A. Philosophy
1A.1 The Human Problem RABS Solves
1A.2 Why Existing Solutions Failed
1A.3 Why a POC Was Necessary
1A.4 Evolution of the Architecture
1A.5 The Nature of Operational Truth
1A.6 Time as a First-Class Citizen
1A.7 Principles of Intent-Driven Systems
1A.8 What Makes RABS Unique
1A.9 Guiding Principles
1B. Intended Design
1B.1 System-Wide Requirements
1B.2 Architectural Goals
1B.3 Module Interaction Overview
1B.4 Data & Compliance Requirements
1C. What It Became (Technical Reality)
1C.1 Real Architecture Diagram
1C.2 Logical/Physical Components
1C.3 Technology Stack
1C.4 Cross-System Data Flows
1D. User Manual
1D.1 System Overview for Operators
1D.2 How Modules Fit Together
1D.3 Where the Intelligence Comes From
2. Brainframe (Cognitive Layer)
2A. Philosophy
2A.1 Why Cognition Is Required
2A.2 What an LLLM Cannot Do Alone
2A.3 Role of Memory and Context
2A.4 Importance of Safety & Grounding
2B. Intended Design
2B.1 Prime Directives
2B.2 Private Journal
2B.3 Context Buckets
2B.5 Relevance Engine
2B.6 Prompt Assembly Engine
2B.7 Central LLM Gateway
2B.8 Cognitive Loop Workflow
2C. What It Became (Technical Reality)
2C.1 Full Cognitive Architecture
2C.2 Event Logs
2C.3 Memory Embedding
2C.4 Context Selection Algorithms
2C.5 Prompt Tiers
2C.6 Error/Fallback Models
2C.7 Observed Behaviour
2D. User Manual
2D.1 How Reggie Thinks
2D.2 How Staff Send Tasks
2D.3 How Reggie Interprets Action
2D.4 Understanding Reggie's Outputs
2D.5 Troubleshooting
3. Operational Intelligence Layer (Workshed, Loom, Ribbon)
3A. Philosophy
3A.1 Why Operational Truth Needs Structure
3A.2 Persistent vs. Dated Intent
3A.4 The Loom & Ribbon
3A.5 Why It Solves Auditing
3A.6 Why It Enables AI Reasoning
3B. Intended Design
3B.1 The Four Primitives
3B.2 Template Engine
3B.3 Intent Engine
3B.4 Instance Generation
3B.5 Loom Window
3B.6 Constraint Policies
3B.7 Ribbon Truth
3B.8 Required Use Cases
3C. What It Became (Technical Reality)
3C.1 Data Schemas
3C.2 Intent Pipeline
3C.3 Loom Engine Logic
3C.4 Rethreading
3C.5 Constraint Validators
3C.6 Conflict Resolution
3C.7 Frozen Instance Commit
3C.8 History Reconstruction
3D. User Manual
3D.1 Managing Programs (Templates)
3D.2 Updating the Calendar (Intents)
3D.3 Viewing Active Weeks
3D.4 Reviewing History
3D.5 Billing & Attendance Integration
4. DataHub (Boards, Workflow, Tasks)
4A. Philosophy
4B. Intended Design
4C. Technical Reality
4D. User Manual
5. Communications Layer (Email, SMS, Voice, Chat)
5A. Philosophy
5B. Intended Design
5C. Technical Reality
5D. User Manual
6. HR Systems
6A. Philosophy
6B. Intended Design
6C. Technical Reality
6D. User Manual
7. Settings Registry & Governance
7A. Philosophy
7B. Intended Design
7C. Technical Reality
7D. User Manual
8. Development & Deployment
8A. Philosophy
8B. Intended Design
8C. Technical Reality
8D. Deployment/User Manual
9. Backup & Disaster Recovery
9A. Philosophy
9B. Intended Design
9C. Technical Reality
9D. User Manual
10. Appendices (Lore Section)
10.1 POC Archaeology
10.2 Late-Night Breakthroughs
10.3 Emergencies & Failures
10.4 The Discovery of the Loom
10.5 Recovery of the Lost Docs
10.7 The First Braided Ribbon
10.8 Full Birth Certificate Text
10.9 Notes for Future AI Historians
10.10 Developer Jokes, Swearing & Chaos
10.11 Changing the Universe with Context Buckets
10.12 Reginald's First Words