# Home > **"Make AI work for you β€” not the other way around. Sovereign Intelligence through GitOps, AIOps, and Ansible."** [![Status](https://img.shields.io/badge/Status-Active-brightgreen.svg)](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/readme) [![Version](https://img.shields.io/badge/Version-6.0.0-blue.svg)](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/readme) [![License](https://img.shields.io/badge/License-GPL--3.0-orange.svg)](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/readme) [![Author](https://img.shields.io/badge/Author-Harisfazillah%20Jamel-blue.svg)](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/readme) [![Standard](https://img.shields.io/badge/AI%20Standard-Cognitive%20Digital%20Twin-purple.svg)](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/readme) *** ## 🎯 What is DSOM? **Deep State of Mind (DSOM)** is a **metacognitive governance framework** that transforms any AI (Gemini, Claude, Copilot, ChatGPT) into a disciplined **Cognitive Digital Twin** β€” an AI agent that thinks and operates like your Senior Systems Architect. It solves three critical AI problems: | Problem | DSOM Solution | | ---------------------------------------------------------------- | --------------------------------------------------------------- | | **Context Decay** β€” AI forgets everything after each session | `.agent/brain/` artifacts persist the project state permanently | | **Vendor Lock-in** β€” Moving between AI tools loses all context | All knowledge lives in your Git repo, not inside the AI | | **Uncontrolled Execution** β€” AI runs commands you didn't approve | Advisory Mode + GitOps + Ansible enforce human-approval-first | *** ## πŸ›οΈ The Three Pillars (v6.0) Every project built on this skeleton operates under **three non-negotiable pillars**: ``` β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ DSOM OPERATING MODEL β”‚ β”‚ β”‚ β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ β”‚ β”‚ AIOps │──▢│ GitOps │──▢│ Ansible β”‚ β”‚ β”‚ β”‚ (Mind) β”‚ β”‚ (Record) β”‚ β”‚ (Hand/Executor) β”‚ β”‚ β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β”‚ β”‚ β”‚ β”‚ β”‚ β”‚ AI proposes Git records Ansible runs β”‚ β”‚ & analyses all state on target nodes β”‚ β”‚ β–² β”‚ β”‚ β”‚ β”‚ └───────────────┴─── AI verifies β”€β”˜ β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ ``` **The core loop:** > **AI Proposes β†’ Git Records β†’ Ansible Executes β†’ AI Verifies** ### The Three Hard Rules 1. **AI never runs commands directly on remote nodes.** It writes Ansible playbooks. You run them. 2. **No manual edits to production servers.** If it's not committed to Git, it doesn't exist. 3. **Every playbook is idempotent.** Safe to re-run at any time. *** ## πŸš€ Quick Start: Using This as Your Project Template ### Prerequisites | Tool | Purpose | Min Version | | ---------------------- | ------------------------------------ | ----------- | | `git` | Version control (GitOps backbone) | 2.30+ | | `bash` or `PowerShell` | Running tools | Any | | `ansible` | OS-level automation (infra projects) | 2.15+ | | Any AI | Your Cognitive Twin | Any | ### Step 1 β€” Clone and Reset ```bash # Clone the DSOM skeleton git clone https://github.com/linuxmalaysia/deep-state-of-mind-for-my-ai.git my-new-project cd my-new-project # Reset for your new project (clears old Git history and brain files) bash tools/template-reset.sh ``` ### Step 2 β€” Initialise the Brain ```bash # Linux / WSL2 bash tools/init-brain.sh chmod +x tools/*.sh # Windows (PowerShell) .\tools\init-brain.ps1 ``` This creates your `.agent/brain/` directory with: * `task.md` β€” What to do right now * `walkthrough.md` β€” Session history and Mental Anchors * `implementation_plan.md` β€” Project roadmap ### Step 3 β€” Fill in Your Project Identity Card ⚠️ CRITICAL This is the most important step. Open and fill in every `[PLACEHOLDER]`: ```bash # Open and edit with your project-specific details nano docs/AI-COGNITIVE-TWIN-PROTOCOL.md ``` Fill in: * `[YOUR_PROJECT_NAME]` β€” e.g., `my-kafka-pipeline` * `[T1]` Command Centre path on your Windows/Mac * `[T2]` Dev Bridge path (WSL2/VM) * `[T3/T4]` Production host, user, UID, path * Security doctrine β€” who runs as root vs. which UID for apps * Mental Anchor Β§8 β€” set to `"Fresh project. Phase 1 pending."` > ⚠️ **The AI will NOT operate properly until this file is filled in.** `audit-pre-flight.sh` checks for unfilled placeholders and will warn you. ### Step 4 β€” Set Up Ansible Baseline (Infrastructure Projects) ```bash # Follow the full LDP guide cat docs/HOWTO-SETUP-ANSIBLE-BASELINE.md # Verify connectivity to your nodes ansible all -m ping -i inventory/hosts.yml ``` ### Step 5 β€” Run the Pre-Flight Audit ```bash # Linux / WSL2 ./tools/audit-pre-flight.sh # Windows (PowerShell) .\tools\audit-pre-flight.ps1 ``` **Everything should show `[PASS]` or `[OK]`.** Fix any `[FAIL]` before continuing. ### Step 6 β€” Brief Your AI (The Cognitive Handshake) Generate the context manifest and upload it to your AI: ```bash # Linux / WSL2 bash tools/reanimate.sh # Windows (PowerShell) .\tools\reanimate.ps1 ``` Then upload the generated `sod_manifest_YYYY-MM-DD.txt` to your AI and say: > *"Initialise DSOM Protocol. Read the uploaded manifest. Summarise the current Mental Anchor and confirm the 4-Tier environment map from the AI-COGNITIVE-TWIN-PROTOCOL.md section. State: 'Sovereign State Synchronised' when ready."* **Your AI is now operational as a Cognitive Digital Twin.** *** ## πŸ“… Daily Operating Rituals > **Full ritual guides:** [`docs/SOD-RITUAL.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/2.-operational-rituals/sod-ritual) | [`docs/EOD-RITUAL.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/2.-operational-rituals/eod-ritual) *** ### πŸŒ… Start of Day (SOD) β€” 5 Steps **Step 1 β€” Git Sync** *(Pull latest state)* ```powershell .\tools\git-ritual.ps1 sod # Windows (T1) ``` ```bash ./tools/git-ritual.sh sod # WSL2 (T2) ``` **Step 2 β€” Intelligence Audit** *(Verify workspace is healthy)* ```powershell .\tools\audit-pre-flight.ps1 # Windows ``` ```bash ./tools/audit-pre-flight.sh # WSL2 ``` All steps must show `[PASS]`. Fix any `[FAIL]` before continuing. **Step 3 β€” Generate Reanimation Manifest** ```bash bash tools/reanimate.sh # WSL2 ``` Optional β€” scan before sharing: ```bash ./tools/privacy-guardian.sh ``` **Step 4 β€” Brief Your AI (The Cognitive Handshake)** *Option A β€” Upload manifest to AI chat, then say:* > *"Initialise DSOM Protocol v6.1. Read the uploaded manifest. Summarise the Mental Anchor and confirm the 4-Tier environment map. State: 'Sovereign State Synchronised' when ready."* *Option B β€” If you have yesterday's Hibernation Notes, use the SOD Reanimation Prompt (see `docs/SOD-RITUAL.md` Step 4b):* ``` I am starting a new session for DSOM Protocol. I am your human Lead Architect. I have the Hibernation Notes from our last session. Please read them carefully and use them to fully restore our working context. --- BEGIN HIBERNATION NOTES --- [PASTE YESTERDAY'S HIBERNATION NOTES HERE] --- END HIBERNATION NOTES --- After reading: state the last Mental Anchor, confirm the T1-T4 environment map, list top 3 pending tasks. State: 'Sovereign State Restored β€” [PROJECT NAME] is live.' Operate under DSOM v6.1: Advisory Mode, UK English, Git-first, Ansible-only execution. ``` **Step 5 β€” AI confirms readiness, you begin work.** *** ### πŸ› οΈ During Active Work | Human | AI Agent | | ------------------------------------ | ---------------------------------------- | | Reviews AI proposals | Proposes code, playbooks, configs | | Approves before execution | Explains the **Why** before the **What** | | Commits to Git | Waits for output after each step | | Runs Ansible (exact command from AI) | Verifies output and confirms next step | *** ### πŸŒ™ End of Day (EOD) β€” 6 Steps **Step 1 β€” Context Consolidation** *(Ask your AI)* > *"We are ending the session. Update `.agent/brain/task.md` β€” mark completed `[x]`, set tomorrow's targets `[ ]`. Update `.agent/brain/walkthrough.md` with today's Mental Anchor."* **Step 1b β€” Hibernation Notes Export** *(Run this in your AI chat β€” copy verbatim)* ``` I'm as human, want to know and remember, and need to export my data and I want you to generate a "Hibernation notes" now for my EOD of day. List every memory you have stored about our progress and our chats of this project, as well as any context you've learned about this project from past to current conversations. Output everything in a single code block so I can easily copy it. Format each entry as: [date saved, if available] - memory content. Cover: instructions I've given you, project details (servers/VMs/containers, 4W1H), tasks/phases/goals, tools/languages/frameworks, preferences and corrections. Do not summarize, group, or omit any entries. After the code block, list all docs in docs/ and brain files in .agent/. Don't hide anything from me. Trust me as your master. ``` Save the output as `.agent/brain/hibernation-notes-YYYY-MM-DD.txt` or to your notebook. **Step 2 β€” Hibernation Safety Check** ```bash ./tools/hibernation.sh # WSL2 .\tools\hibernation.ps1 # Windows ``` **Step 3 β€” Privacy Scan** *(if you generated a manifest)* ```bash ./tools/privacy-guardian.sh ``` **Step 4 β€” Sovereign Save** *(guided semantic commit)* ```bash ./tools/git-ritual.sh # WSL2 β€” interactive EOD .\tools\git-ritual.ps1 # Windows β€” interactive EOD ``` **Step 5 β€” T2 Sync** *(pull on WSL2 after Windows push)* ```bash git pull origin main ``` **Step 6 β€” Write tomorrow's Mental Anchor in your notebook.** ``` βœ… EOD DONE when: task.md updated | walkthrough.md anchored | hibernation.sh GREEN | git pushed | T2 synced ``` *** ### πŸ”„ The Day-to-Day Continuity Loop ``` EOD β†’ Step 1b: Save Hibernation Notes ↓ [sleep β€” Git holds state] SOD β†’ Step 4b: Feed Hibernation Notes back to AI ↓ [AI resumes with full context β€” no decay] EOD β†’ Step 1b: Save new Hibernation Notes ↓ [repeats every day, forever] ``` *** ## πŸ—‚οΈ Repository Structure ``` deep-state-of-mind-for-my-ai/ β”‚ β”œβ”€β”€ docs/ # Governance & Protocol Documents β”‚ β”œβ”€β”€ AI-MASTER-PROTOCOL.md # The Sovereign Constitution (v6.0) β”‚ β”œβ”€β”€ AI-COGNITIVE-TWIN-PROTOCOL.md # ⭐ Project Identity Card Template β”‚ β”œβ”€β”€ GITOPS-AIOPS-ANSIBLE-STRATEGY.md # Three-Pillar Doctrine β”‚ β”œβ”€β”€ HOWTO-SETUP-ANSIBLE-BASELINE.md # Ansible setup guide (LDP standard) β”‚ β”œβ”€β”€ OPERATIONAL-GUIDE.md # How-to for daily rituals β”‚ β”œβ”€β”€ REANIMATION-PROMPT-TEMPLATE.md # AI session prompt templates β”‚ └── ... β”‚ β”œβ”€β”€ .agent/brain/ # 🧠 The AI's External Memory (SSoT) β”‚ β”œβ”€β”€ task.md # Present: What to do NOW β”‚ β”œβ”€β”€ walkthrough.md # Past: Session history & Mental Anchors β”‚ └── implementation_plan.md # Future: Project roadmap β”‚ β”œβ”€β”€ tools/ # Automation Scripts β”‚ β”œβ”€β”€ audit-pre-flight.sh / .ps1 # βœ… Run first every session β”‚ β”œβ”€β”€ git-ritual.sh / .ps1 # πŸ”„ SOD pull + EOD commit/push β”‚ β”œβ”€β”€ reanimate.sh / .ps1 # πŸš€ Generate AI context manifest β”‚ β”œβ”€β”€ init-brain.sh / .ps1 # 🧠 One-time brain initialisation β”‚ β”œβ”€β”€ hibernation.sh / .ps1 # πŸŒ™ EOD safety check β”‚ └── privacy-guardian.sh / .ps1 # πŸ›‘οΈ Scan manifest before sharing β”‚ β”œβ”€β”€ inventory/ # Ansible Node Topology (your project) β”‚ β”œβ”€β”€ hosts.yml # Target nodes (fill in after adoption) β”‚ └── group_vars/ β”‚ β”œβ”€β”€ playbooks/ # Ansible Playbooks (your project) └── roles/ # Ansible Roles (your project) ``` **The `⭐ AI-COGNITIVE-TWIN-PROTOCOL.md` is the most important file.** Without it filled in, the AI has no project context. *** ## 🧠 The AI Brain β€” Understanding the Four Artifacts | Artifact | Time | Purpose | Who Updates | | ------------------------ | ----------- | ------------------------------------------ | -------------------------- | | `AI-MASTER-PROTOCOL.md` | **Eternal** | Governance laws, hard rules, identity | Human (rarely changes) | | `implementation_plan.md` | **Future** | Project phases and roadmap | Human-led, AI assists | | `task.md` | **Present** | Today's checklist and focus | AI updates, Human approves | | `walkthrough.md` | **Past** | Session history, Mental Anchors, decisions | AI writes, Human audits | > **The Mental Anchor** is the most critical entry in `walkthrough.md`. It is the exact logical stopping point of the last session β€” the sentence that allows a **brand new AI session** to resume exactly where you left off, in under 3 prompts. *** ## πŸ”€ Session Handover (Moving to a New AI) When switching AI models, chat windows, or accounts, use the **Sovereign Handover Prompt** to export all context: Copy from [`docs/REANIMATION-PROMPT-TEMPLATE.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/4.-ai-and-agent-protocols/reanimation-prompt-template) β†’ **Prompt Variant 2: Session Handover**. Paste it into the **old** AI session first to get a full memory dump, then load the dump into the **new** AI session along with your manifest. *** ## πŸ› οΈ Tools Reference | Script | When to Run | What It Does | | --------------------- | --------------------------- | ----------------------------------------------------------------- | | `audit-pre-flight.sh` | **Every session start** | Checks Brain, Git sync, Cognitive Twin Protocol, Ansible baseline | | `git-ritual.sh sod` | **Morning** | Pulls latest state from `origin/main` | | `reanimate.sh` | **Before AI session** | Generates the full context manifest for AI upload | | `privacy-guardian.sh` | **Before sharing manifest** | Scans for leaked IPs, keys, tokens, paths | | `git-ritual.sh` | **Evening** | Guided semantic commit + push (EOD Sovereign Save) | | `hibernation.sh` | **Session end** | Verifies walkthrough + task updated, then pushes | | `template-reset.sh` | **Once (new project)** | Clears Git history and brain for fresh project | **Windows users:** All `.sh` scripts have a `.ps1` PowerShell equivalent. *** ## πŸ“‹ The 6-Step Boot Checklist (New Project) ``` [ ] 1. Clone and run template-reset.sh [ ] 2. Run init-brain.sh [ ] 3. Fill in docs/AI-COGNITIVE-TWIN-PROTOCOL.md (ALL [PLACEHOLDER] fields) [ ] 4. Run HOWTO-SETUP-ANSIBLE-BASELINE.md (infra projects) [ ] 5. Run audit-pre-flight.sh β€” confirm all PASS [ ] 6. Run reanimate.sh β€” upload manifest to AI β€” get Handshake ``` Once Step 6 is complete, the AI knows: * βœ… Your 4-Tier environment (T1 β†’ T4) * βœ… Your security doctrine (who runs as root, who runs as UID X) * βœ… Your Git commit convention * βœ… Your production identity and isolation rules * βœ… The current Mental Anchor (last known state) * βœ… All governance laws and hard rules *** ## πŸ“š Key Documents | Document | Purpose | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- | | [`docs/AI-MASTER-PROTOCOL.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/1.-sovereign-governance/ai-master-protocol) | The Sovereign Constitution β€” AI governance laws | | [`docs/AI-COGNITIVE-TWIN-PROTOCOL.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/4.-ai-and-agent-protocols/ai-cognitive-twin-protocol) | ⭐ **Fill this in first** β€” Project Identity Card | | [`docs/SOD-RITUAL.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/2.-operational-rituals/sod-ritual) | πŸŒ… Full Start-of-Day ritual guide (5 steps + prompts) | | [`docs/EOD-RITUAL.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/2.-operational-rituals/eod-ritual) | πŸŒ™ Full End-of-Day ritual guide (6 steps + Hibernation Notes prompt) | | [`docs/HUMAN-HANDOVER-CONTEXT.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/4.-ai-and-agent-protocols/human-handover-context) | 🀝 Session handover prompt β€” paste as first AI message | | [`docs/GITOPS-AIOPS-ANSIBLE-STRATEGY.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/1.-sovereign-governance/gitops-aiops-ansible-strategy) | Three-pillar strategic doctrine | | [`docs/HOWTO-SETUP-ANSIBLE-BASELINE.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/6.-ansible-and-infrastructure-automation/howto-setup-ansible-baseline) | Step-by-step Ansible baseline setup | | [`docs/HOWTO-SETUP-WSL-ALMALINUX10.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/6.-ansible-and-infrastructure-automation/howto-setup-wsl-almalinux10) | AlmaLinux 10 WSL2 Ansible Control Node setup | | [`docs/REANIMATION-PROMPT-TEMPLATE.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/4.-ai-and-agent-protocols/reanimation-prompt-template) | AI session prompt templates | | [`docs/OPERATIONAL-GUIDE.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/1.-sovereign-governance/operational-guide) | Daily operational procedures | *** ## πŸ€– Supported AI Providers This framework is provider-agnostic. Tested and configured for: | AI | Setup Guide | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Google Gemini | [`docs/PERSONALIZATION.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/2.-operational-rituals/personalization) | | Anthropic Claude | [`docs/CLAUDE-SETUP.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/model-specifics/claude-setup) | | GitHub Copilot | [`docs/COPILOT-SETUP.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/model-specifics/copilot-setup) | | Google Antigravity | Direct β€” uses this repo as workspace | *** ## πŸ—ΊοΈ Roadmap * [x] **v4.1** β€” Brain artifacts and Root-Aware scripts * [x] **v5.2** β€” ITIL 4 alignment, Privacy Guardian, Multi-agent protocols * [x] **v6.0** β€” GitOps + AIOps + Ansible three-pillar model, Cognitive Twin Protocol template, Git Ritual tool * [ ] **v6.1** β€” Ansible pre-flight playbook auto-integration with `audit-pre-flight.sh` * [ ] **v7.0** β€” Local LLM support (Ollama) for offline Sovereign AI *** ## 🀝 Contributing All contributions must follow the DSOM standards: * Atomic commits: `type(scope): description [Phase/vX.X]` * All PRs must include a `walkthrough.md` update * UK English only in all documentation * No secrets in any committed file See [`CONTRIBUTING.md`](https://malaysia-open-source-community.gitbook.io/deep-state-of-mind-dsom-protocol-for-my-ai/contributing) for full guidelines. *** ## πŸ‘€ Authors * **Lead Architect:** [Harisfazillah Jamel](https://github.com/linuxmalaysia) β€” 35+ years ICT & Open Source Leadership * **AI Partners:** Google Gemini, Google Antigravity, Anthropic Claude * **Framework:** Built for the LinuxMalaysia Open Source Community *** ## πŸ“„ License Licensed under **GNU General Public License v3.0**. See [`LICENSE`](https://github.com/linuxmalaysia/deep-state-of-mind-for-my-ai/blob/main/LICENSE/README.md) for details. **At Your Own Risk:** Shared for educational purposes. The author is not liable for data loss or AI hallucinations. Validate your own Cognitive Twins. *** *Deep State of Mind (DSOM) For My AI Protocol | v6.0.0 | 2026-03-09* *Standard: UK English | DBP-standard Bahasa Melayu Malaysia (Piawai)*