Documentation Workflow

Last updated: 2026-07-29

Overview

The DDpro-Docs site uses a human-to-agent documentation pipeline. Aleks writes Markdown files and drops them in an escrow inbox. OMax reads, processes, and publishes them to the VitePress site.

Escrow inbox

All documentation requests go through:

/mnt/ddpro-data/DDpro-Ops/00-Inbox/

Drop a .md file there with YAML front matter (see template below). Then tell OMax: "escrow: filename.md"

Template

A ready-to-use template is at:

/mnt/ddpro-data/DDpro-Docs/Templates/escrow-doc-template.md

Example front matter:

---
action: publish
target: Reports/Daily/2026-07-29.md
---

Available actions

Action	What it does
publish	Copies the file body to target. Fails if target exists (asks Aleks)
replace	Overwrites target file with escrow content
new	Creates new doc + updates VitePress nav/sidebar if nav: true

Front matter fields

Field	Required	Description
action	yes	publish, replace, or new
target	yes	Path under /mnt/ddpro-data/DDpro-Docs/
title	no	Page title (used for new action)
nav	no	true/false — add to site nav bar (default: false)

How to write a daily report

1. Copy the template from DDpro-Docs/Templates/escrow-doc-template.md
2. Set action: publish, target: Reports/Daily/YYYY-MM-DD.md
3. Write your content below the front matter
4. Save to DDpro-Ops/00-Inbox/
5. Tell OMax: "OMax, escrow: filename.md"
6. OMax publishes it and tells you the deploy URL

How to create a new documentation page

1. Write your page with front matter:

   ---
   action: new
   target: MY-NEW-PAGE.md
   title: My New Page
   nav: true
   ---

2. Drop in escrow inbox
3. Tell OMax: "OMax, escrow: filename.md"
4. OMax creates the page, adds it to the site nav, and deploys

How to update an existing page

1. Write the full replacement content with front matter:

   ---
   action: replace
   target: APC-MACHINE.md
   ---

2. Drop in escrow inbox
3. Tell OMax: "OMax, escrow: filename.md"

Skill reference

The OMax skill for this workflow lives at:

/mnt/ddpro-data/DDpro-Env/skills/docs-publish/SKILL.md

Future: JOMax handoff

When JOMax (Joe's OpenCode agent) is set up, the same skill and escrow system will work for Joe. Joe drops a file, tells JOMax "escrow: filename.md", and JOMax publishes it. OMax handles deploy until JOMax gets its own wrangler credentials.