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

# Agent Plugins 1.0.0 Specification & DSOM Protocol Integration

> Master governance and architectural integration guide for adopting the open Agent Plugins 1.0.0 specification across DSOM. Deep State of Mind framework.

> **Entry Point 20:** This document defines the packaging, distribution, and runtime interoperability architecture for **Agent Plugins 1.0.0** within the Deep State of Mind (DSOM) framework.

***

## 🎯 Executive Summary & Context

**Agent Plugins 1.0.0** is an open, vendor-neutral directory specification governed by core maintainers from **Google (DeepMind / Cloud), Amazon, Microsoft, OpenAI, Cursor, and Vercel**. It eliminates packaging friction across disparate AI coding agents and IDEs by standardising how **Agent Skills** and **Model Context Protocol (MCP) servers** are bundled, discovered, and executed in a single portable directory.

Under the DSOM protocol, **Agent Plugins 1.0.0** serves as the universal distribution and packaging standard, seamlessly bridging DSOM's Sovereign Brain (`.agents/brain/`), Skills repository (`.agents/skills/`), and FastMCP Server (`tools/mcp/server.py`) across Google Antigravity, Google Jules, Claude Code, Cursor, and enterprise agent environments.

***

## 🏛️ The 5-Layer Agent Ecosystem Architecture

```mermaid theme={null}
flowchart TD
    Find["1. Find It: Agentic Resource Discovery (ARD)<br/><code>agenticresourcediscovery.org</code>"] --> Describe["2. Describe It: AI Catalog<br/><code>application/agent-plugins+json</code>"]
    Describe --> Package["3. Package It: Agent Plugins 1.0.0<br/><code>plugin.json</code> + <code>mcp.json</code> + <code>skills/</code>"]
    Package --> Run["4. Run It: FastMCP & Agent Skills<br/><code>tools/mcp/server.py</code> & <code>SKILL.md</code>"]
    Run --> Govern["5. Govern It: Deep State of Mind (DSOM)<br/>Spatial Memory + 10 Guardrails + OKF v0.2"]
```

1. **Find it, Agentic Resource Discovery (ARD):** Discovers available plugins and capabilities prior to invocation.
2. **Describe it, AI Catalog:** Indexes plugin descriptors and resource mappings.
3. **Package it, Agent Plugins 1.0.0:** Standardised directory layout, manifest (`plugin.json`), and MCP descriptor (`mcp.json`).
4. **Run it, MCP & Agent Skills:** Portable execution contracts across transports (`stdio`, `streamable-http`, `sse`).
5. **Govern it, DSOM Metacognition:** Tri-Phasic Mind cognitive continuity, 10 Custom Guardrails, and GitOps audit trail.

***

## 📐 Package Layout Standard (Rule 30)

Every DSOM-compliant Agent Plugin adheres to the fixed filesystem layout:

```text theme={null}
my-dsom-plugin/
├── plugin.json              # Required: Closed manifest (schema 1.0.0)
├── mcp.json                 # Optional: Explicit MCP server descriptors
├── skills/                  # Optional: Fixed directory for Agent Skills
│   └── summarize/
│       ├── SKILL.md         # Open Knowledge Format (OKF v0.2)
│       ├── scripts/         # Idempotent execution scripts
│       └── references/      # Progressive disclosure documentation
├── org.dsom.protocol/       # Optional: Client extension namespace
│   ├── guardrails.json      # DSOM custom validators configuration
│   └── hooks/               # Tri-Phasic interception hooks
├── LICENSE                  # GNU GPL v3.0 / SPDX identifier
└── CHANGELOG.md             # Semantic version ledger
```

***

## 📜 Manifest Contracts

### 1. `plugin.json` (Root Manifest)

The root manifest declares metadata and targeted schema version:

```json theme={null}
{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "deep-state-of-mind",
  "version": "10.4.0",
  "description": "Deep State of Mind (DSOM) Sovereign AI Agent Cognitive Architecture, Open Knowledge Format (OKF), and Model Context Protocol (MCP) toolset.",
  "author": {
    "name": "Harisfazillah Jamel (LinuxMalaysia)",
    "email": "linuxmalaysia@gmail.com",
    "url": "https://github.com/linuxmalaysia"
  },
  "homepage": "https://linuxmalaysia.github.io/deep-state-of-mind-for-my-ai/",
  "repository": "https://github.com/linuxmalaysia/deep-state-of-mind-for-my-ai",
  "license": "GPL-3.0-or-later",
  "keywords": [
    "dsom",
    "ai-agents",
    "mcp",
    "agent-skills",
    "agent-plugins"
  ],
  "extensions": {
    "org.dsom.protocol": {
      "tri_phasic_mind": true,
      "okf_version": "0.2"
    }
  }
}
```

### 2. `mcp.json` (MCP Configuration)

Maps Model Context Protocol servers explicitly without guesswork:

```json theme={null}
{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
  "mcpServers": {
    "dsom-knowledge-server": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "pyyaml",
        "python",
        "${PLUGIN_ROOT}/tools/mcp/server.py"
      ],
      "env": {
        "DSOM_PALACE_ROOT": "${PLUGIN_ROOT}",
        "DSOM_STORAGE_DIR": "${PLUGIN_DATA}/storage"
      },
      "cwd": "${PLUGIN_ROOT}"
    }
  }
}
```

***

## 🛡️ Variable Expansion & Path Containment

The specification defines two strict environment variables that conformant clients MUST provide to plugin subprocesses:

1. **`${PLUGIN_ROOT}`**: Absolute path to the resolved plugin root. Used for referencing bundled binaries, Python scripts (`tools/mcp/server.py`), and documentation palaces.
2. **`${PLUGIN_DATA}`**: Client-managed persistent directory dedicated to that installed plugin instance. Used for virtual environments, local SQLite caches, and generated artifacts.

> \[!CAUTION]
> **Path Containment Invariant (§4.1):** All relative paths defined in `mcp.json` or plugin configurations MUST resolve strictly within `${PLUGIN_ROOT}` or `${PLUGIN_DATA}`. Any attempt to traverse upward (`../`) outside the root boundary will cause compliant clients to reject the component.

***

## 🛠️ Step-by-Step: Packaging a DSOM Skill as an Agent Plugin

1. **Create the Plugin Directory**:
   ```bash theme={null}
   mkdir -p plugins/my-ops-plugin/skills/sys-audit
   ```
2. **Write `plugin.json`**:
   ```json theme={null}
   {
     "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
     "name": "my-ops-plugin"
   }
   ```
3. **Add OKF v0.2 `SKILL.md`**:
   Place your standard DSOM skill inside `skills/sys-audit/SKILL.md`.
4. **Attach MCP Server (Optional)**:
   Add `mcp.json` declaring any auxiliary stdio or streamable HTTP tools.
5. **Verify with DSOM Guardrails**:
   ```bash theme={null}
   uv run python tools/install_git_guardrails.py
   uv run pytest tests/test_agent_plugins_spec.py
   ```

***

## 📚 Related Governance & References

* [`docs/governance/DSOM-MCP-ARCHITECTURE.md`](file:///d:/Users/LinuxMalaysia/Projects/deep-state-of-mind-for-my-ai/docs/governance/DSOM-MCP-ARCHITECTURE), FastMCP Server Reference.
* [`docs/governance/AI-GUARDRAILS-MASTER-GUIDE.md`](file:///d:/Users/LinuxMalaysia/Projects/deep-state-of-mind-for-my-ai/docs/governance/AI-GUARDRAILS-MASTER-GUIDE.md), Pre-Commit & Runtime Interception.
* [Agent Plugins 1.0.0 Specification](https://agent-plugins.org/specification), Normative Standard.

***

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


## Related topics

- [Agent Plugin Packager](/skills/agent-plugin-packager.md)
- [Google Jules & Google Antigravity Collaborative Sync](/skills/jules-antigravity-sync.md)
- [DSOM Token Efficiency & Integration Report](/governance/dsom-token-efficiency-report.md)
- [NOSS Integration Guide: Adopting National Standards into DSOM](/governance/noss-integration-guide.md)
- [Mintlify One-Way Docs Sync & Safety Guards Specification](/governance/mintlify-one-way-sync-pipeline.md)