> ## 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.

# OpenWiki Knowledge Graph Compiler Skill

> Procedural SOP for executing the native Python OpenWiki Emulator to compile, update, and maintain codebase knowledge graphs within DSOM.

**Purpose**: To guide AI Agents (Antigravity, Google Jules, Cursor, Claude) in maintaining and compiling OpenWiki-compliant knowledge graphs over the Sovereign Markdown Palace (`docs/`) and `.agents/brain/` using the native Python emulator (`tools/openwiki_emulator.py`).

***

## Operational Workflow for AI Agents

### 1. Execution Protocol (Zero External Binaries)

AI agents maintain `./openwiki/` using the **Native Python OpenWiki Emulator** (Rule 16 & Rule 27 Mandate):

```bash theme={null}
# Execute native OpenWiki Emulator via uv
uv run --with pyyaml python tools/openwiki_emulator.py
```

***

### 2. Standard Maintenance Procedures

#### A. Initializing or Updating Knowledge Graph

Run when initializing a new DSOM project or updating an existing wiki:

```bash theme={null}
uv run --with pyyaml python tools/openwiki_emulator.py
```

#### B. Incremental Deep State Update (EOD Ritual)

Execute during EOD consolidation to compile session walkthroughs into `./openwiki/`:

```bash theme={null}
uv run --with pyyaml python tools/openwiki_emulator.py
```

***

### 3. AI Fallback Synthesis Protocol & OKF Compliance

When drafting or updating `./openwiki/` documentation:

1. **Skeleton Analysis:** Read `./openwiki/_skeleton.md` to inspect the planned page tree, subsystem rankings, and evidence links.
2. **Autonomous Page Drafting:** The AI agent (Gemini / Antigravity) directly drafts all planned `.md` pages under `./openwiki/` using project context and OKF YAML frontmatter.
3. **OKF Frontmatter Compliance & Signature:** Execute `uv run --with pyyaml python tools/apply_okf_frontmatter.py ./openwiki/` to validate and apply OKF v0.1 YAML frontmatter headers across all generated OpenWiki concept pages, followed by `python .agents/skills/dsom-signature-injector/scripts/inject.py ./openwiki/` to append signature footers.
4. **Regression Verification:** Run unit test assertions (`uv run --with pyyaml python -m unittest tests/test_openwiki_emulator.py tests/test_openwiki_update_workflow.py tests/test_okf_frontmatter_bom_reorder.py`).

***

## Quality Gates & Security Rules

1. **Rule 16 (`uv` Mandate & Node.js Isolation):** All Python dependencies must be run via `uv run`.
2. **Rule 24 (Credential Protection):** Never commit API keys into local files.
3. **Rule 27 (Native OpenWiki Emulator Mandate):** Maintain `./openwiki/` directly via `tools/openwiki_emulator.py`, eliminating external Node.js binaries and API rate limit dependencies.

***

*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

- [How-To: Operate the OpenWiki Emulator](/how-to/use-openwiki-emulator.md)
- [🛠️ HOWTO: Operating OpenWiki & Native Python Zero-Binary Emulator](/tools/howto-openwiki.md)
- [🌐 OpenWiki Integration Blueprint & Native Python Emulator Architecture](/governance/openwiki-integration-guide.md)
- [Tutorial: Getting Started with DSOM Tools](/tutorials/getting-started.md)
- [Automation & Script Audit Ledger](/governance/automation-audit-list.md)