MDA — Compile One Doc into SKILL/AGENTS/CLAUDE

Main

• Treat .mda as the single source of truth, then compile drop-in docs for multiple runtimes instead of duplicating content by hand.

• Use mda validate and the target schemas as a CI gate so published SKILL/AGENTS/CLAUDE artifacts stay structurally correct.

• Use integrity digests (--integrity) and mda integrity verify when you need tamper-evident docs in agent supply chains.

Source-backed notes

• README describes .mda as a Markdown superset that compiles into SKILL.md, AGENTS.md, MCP-SERVER.md, and CLAUDE.md outputs.
• CLI manual states the npm package is @markdown-ai/cli and the installed binary/command is mda.
• CLI manual shows a minimal flow: mda init → mda validate → mda compile --integrity → mda integrity verify.

FAQ

• What command does the CLI install?: The CLI manual says @markdown-ai/cli installs one command: mda.
• Can I run it without installing?: Yes — CLI manual shows npx @markdown-ai/cli --help as a no-install entry point.
• What should I verify in CI?: Validate both the .mda source and emitted targets, then run mda integrity verify for integrity checks.