HOWTO: init-brain — Cognitive Infrastructure Bootstrap
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 the DSOM_TEMPLATE.md.
- Restore missing brain state files if they were accidentally deleted.
- Bootstrapping a fresh "External Memory" for your Cognitive Twin.
Location:
- tools/init-brain.ps1 (Windows)
- tools/init-brain.sh (Linux/WSL2)
- playbooks/dsom/init-brain.yml (Ansible)
2. Prerequisites
| Requirement | Minimum | Notes |
|---|---|---|
| Git | init |
The repository must be a Git repo (.git exists). |
| OS | Any | Works on standard shells. |
3. Usage
3.1 Standard Initialization
# Windows (T1)
.\tools\init-brain.ps1
# WSL2 / Linux (T2)
bash tools/init-brain.sh
3.2 Ansible Provisioning
ansible-playbook playbooks/dsom/init-brain.yml
4. Manifest Items Created
The tool deploys the following structures safely (it will not overwrite existing files):
| Artifact | Purpose |
|---|---|
.agents/brain/ |
The hidden AI context directory. |
task.md |
The AI's TODO list. |
walkthrough.md |
The session history and Mental Anchor log. |
implementation_plan.md |
The roadmap and design goals. |
DSOM_TEMPLATE.md |
Standardised format for deep walkthrough sections. |
5. Integration with the Daily Rituals
This is a one-time setup tool. Once the brain is initialized, you should switch to using audit-pre-flight at the start of every session to ensure these artifacts remain healthy.
6. Related Documents
| Document | Purpose |
|---|---|
governance/OPERATIONAL-GUIDE.md |
How the brain files are used in practice. |
HOWTO-AUDIT-PRE-FLIGHT.md |
Verification tool for these artifacts. |
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