docmd-docs

name	docmd-docs
description	Maintain the claude-mem-sync public documentation site built with docmd.

docmd docs maintenance

Use this skill when changing public documentation in docs-site/.

Layout

• Source Markdown lives in docs-site/docs.
• Site config is docs-site/docmd.config.json.
• Static assets live in docs-site/assets.
• Every public page must be registered in navigation[]; the sidebar is config-driven.

Commands

cd docs-site
npm run check
npm run build

Use npm run dev for local preview. Cloudflare Pages Option A: build command npm run build, output directory _site, root directory docs-site. Fallback Option B: build locally and upload docs-site/_site.

Content standard

• Markdown only: no MDX, JSX, or raw component tags.
• Prefer task-first pages with Motivation, Design, Data model or contract, worked example, gotchas, and limits.
• Use Mermaid for workflows and KaTeX for formulas where it clarifies the concept.
• Use docmd containers: ::: callout, ::: tabs, ::: steps, ::: collapsible, ::: grids, ::: grid, and ::: card.
• Never use ::: button.
• Use Lucide icon names in navigation and container icon: options.

Plugins and search

The site enables search with semantic indexing, git metadata, SEO, sitemap, Mermaid, Math, LLM output, and analytics disabled. Keep .docmd-search/config.json committed, but do not commit generated search batches unless project policy changes.

Branding and footer

Primary color is #0d9488. Keep assets/custom.css in sync with brand variables and keep the official docs URL as https://doc.claude-mem-sync.padosoft.com.

Gotchas

• docs-site/scripts/check-no-raw-html.mjs blocks JSX-style capitalized tags.
• If a page is missing from navigation[], it is not part of the intended public sidebar.
• Verify generated _site/index.html, llms.txt, sitemap.xml, and semantic search artifacts after dependency updates.