docs/tools/HOWTO-DSOM-ONBOARD.md
Standard: DSOM For My AI Protocol v6.1 | External Adoption Tools:dsom-onboard.ps1,dsom-onboard.sh,onboard-dsom.ymlPlatforms: Windows Native (T1), Linux/WSL2 (T2)
1. Purpose
dsom-onboard is the Architectural Grafting Tool. It allows you to take any existing Git repository and “Onboard” it into the Deep State of Mind framework. It automates the complex process of injecting the .agents/brain/, playbooks/dsom/, and tools/ ecosystems into a foreign project without causing file collisions or git history corruption.
Use it to:
- Convert a normal project into a DSOM-compliant repository.
- Safe-import the DSOM orchestration fleet into a brand new project.
- Ensure “Zero-Debt” adoption by utilizing temporary Git branch isolation.
- Automatically merge core governance docs (Identity, Master Protocol, etc.) into the target.
tools/dsom-onboard.ps1(Windows)tools/dsom-onboard.sh(Linux/WSL2)playbooks/dsom/onboard-dsom.yml(Ansible)
2. Prerequisites
3. Usage
3.1 Bootstrap Execution
You do NOT need to manually download the DSOM repository to use this. You only need the bootstrap script:4. Operation Workflow (The 4 Steps)
The tool performs a non-destructive multi-phase integration:- Dependency Check: Verifies Git, WSL, and Ansible are present.
- Branch Isolation: Creates a new branch (e.g.,
dsom-onboarding-YYYY-MM-DD). - Payload Download: Fetches the latest
onboard-dsom.ymldirectly from the main DSOM GitHub. - Ansible Fusion: Executes the playbook to physically copy and rename files into your target repo.
5. Collision Handling
[!NOTE]
If your target repository already has a file with the same name as a DSOM file (e.g.,README.md), the tool will not overwrite it. Instead, it renames the incoming DSOM file to include the today’s timestamp so you can manually reconcile the contents.
6. Finalizing the Adoption
After the script finishes, you must perform the following Git manual steps:- Review the changes using
git status. - Commit the incoming framework:
git add . && git commit -m 'chore(dsom): onboard framework architecture'. - Merge the onboarding branch into your
mainbranch. - Run
init-brainto finalize the cognitive infrastructure.
7. 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