docs/tools/HOWTO-INIT-BRAIN.md
Standard: DSOM For My AI Protocol v6.1 | Foundations Tools:init-brain.ps1,init-brain.sh,playbooks/dsom/init-brain.ymlPlatforms: Windows Native (T1), Linux/WSL2 (T2)
1. Purpose
init-brain is the Day Zero Initializer for any DSOM-compliant repository. It creates the physical directory structure and the foundational Markdown artifacts required for an AI to store and retrieve persistent project state.
Use it to:
- Initialise the
.agents/brain/directory at the repository root. - Create the 4 core artifacts:
task.md,walkthrough.md,implementation_plan.md, and theDSOM_TEMPLATE.md. - Restore missing brain state files if they were accidentally deleted.
- Bootstrapping a fresh “External Memory” for your Cognitive Twin.
tools/init-brain.ps1(Windows)tools/init-brain.sh(Linux/WSL2)playbooks/dsom/init-brain.yml(Ansible)
2. Prerequisites
3. Usage
3.1 Standard Initialization
3.2 Ansible Provisioning
4. Manifest Items Created
The tool deploys the following structures safely (it will not overwrite existing files):5. Integration with the Daily Rituals
This is a one-time setup tool. Once the brain is initialized, you should switch to usingaudit-pre-flight at the start of every session to ensure these artifacts remain healthy.
6. Related Documents
Standard: DSOM For My AI Protocol v6.1 | Harisfazillah Jamel | LinuxMalaysia Document Version: v1.0 | Created: 2026-04-08
Deep State of Mind (DSOM) For My AI Protocol | Harisfazillah Jamel (LinuxMalaysia) | 2026-07-04 Standard: UK English | DBP-standard Bahasa Melayu Malaysia (Piawai) | GNU General Public License v3.0