> ## Documentation Index
> Fetch the complete documentation index at: https://harisfazillah.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# DSOM Policy Adopter

> Automatically ingests an external research paper or policy document (PDF/Markdown) and formally integrates it into the DSOM framework governance and cor...

**Purpose**: To seamlessly ingest external architectural or governance documents and integrate them into the DSOM repository strictly adhering to the Triple-Ledger Synchronization Mandate and Core Rules.

## Prerequisites

* The user has provided an absolute path to a document (e.g., PDF or Markdown).
* If the document is a PDF, the AI should use the view\_file or pdf-text-extractor tool to read the contents first.

## Execution Workflow

1. **Ingest & Extract**
   * Read the provided document in its entirety.
   * Extract the core architectural principles, rules, and actionable constraints that apply to the DSOM ecosystem.
   * **Contextual Tailoring**: Actively filter and modify the extracted constraints to fit the specific architecture of the current project (e.g., mapping remote execution steps to local T1 Windows / T2 WSL2 node configurations, removing irrelevant technology references).

2. **Draft Governance Document**
   * Create a dedicated, highly-structured Markdown file in the `docs/governance/` directory.
   * Run `uv run python tools/apply_okf_frontmatter.py docs/governance/` to enforce strict OKF v0.1 YAML frontmatter schema compliance (with `okf_version`, `type: documentation`, `title`, `timestamp`, `topics`).
   * Format the document strictly following the Generative Engine Optimisation (GEO) standard: Authoritative tone, verifiable statistics/quotes, H2 user-centric headings, and 200-400 word chunks.

3. **Core Engine Injection (AGENTS.md)**
   * Distill the most critical, actionable constraints from the new policy.
   * Inject these constraints directly as a new numbered Core Rule into `.agents/AGENTS.md`. Be extremely precise; do not bloat the file.

4. **Dual Documentation Sync & Signature**
   * **Rule 13 (Signature)**: Run `python .agents/skills/dsom-signature-injector/scripts/inject.py docs/governance/` to inject standard DSOM ownership, timestamp, and GPL v3.0 license signatures for each changed file.
   * **Rule 14 (Dual Sync)**: Explicitly map the new governance document into BOTH `SUMMARY.md` and `mkdocs.yml` under the appropriate category to prevent orphaned documentation.

5. **Triple-Ledger Synchronization**
   * **README.md**: Add a link to the new `docs/governance/` file in the "Key Documents" table with a short emoji-prefixed description.
   * **CHANGELOG.md**: Add an entry under `## [Unreleased]` describing the new governance policy and rule addition.
   * **HISTORY.md**: Append a new entry to the universal ledger detailing the architectural integration and the exact files modified.

6. **Defensive GitOps (Commit & Push)**
   * Run `git pull --rebase origin main` to ensure sync.
   * Add all changed files: `git add docs/governance/... .agents/AGENTS.md README.md CHANGELOG.md HISTORY.md SUMMARY.md mkdocs.yml`
   * Commit with an atomic, conventional commit message (e.g., `docs(governance): adopt [Policy Name]`).
   * Push to all active remotes (e.g., GitHub and GitLab).

7. **Closure & Walkthrough**
   * Report the successful adoption to the user, highlighting the exact architectural changes made.

***

*Deep State of Mind (DSOM) For My AI Protocol | Harisfazillah Jamel (LinuxMalaysia) | 2026-08-20*
*Standard: UK English | DBP-standard Bahasa Melayu Malaysia (Piawai) | GNU General Public License v3.0*


## Related topics

- [AI Skill Architecture: Progressive Disclosure & Semantic Routing](/governance/ai-skill-architecture.md)
- [Security Policy - Deep State of Mind (DSOM)](/security.md)
- [📖 DSOM Operational Guide (Level 3 - Specialised Tasks)](/governance/operational-guide.md)
- [Python uv Environment Guide](/governance/python-uv-environment-guide.md)
- [The Deep State of Mind (DSOM) Framework: Defense-in-Depth Architecture](/governance/dsom-architecture-analysis.md)