Reference specs

These pages mirror the source-of-truth specifications stored in docs/specs/ of the repository. They are the definitive contracts for the engine, the language server, the syntax highlighter, the studio SPA, the VS Code extension, the markdown fence renderer, and the agent / MCP plugin.

If you came here looking for a quick orientation, start with the user guide instead.

In this section

• PicoUML Language Baseline — PicoUML language baseline.
• Diagram Families Architecture Spec — Per-family compile contract and module layout.
• puml-studio SPA Specification — Local-first, WASM-first browser studio.
• puml-syntax Shared Syntax + Highlighting Specification — Token taxonomy across grammars and LSP semantic tokens.
• puml-lsp Specification — LSP capabilities, messages, and semantic-token legend.
• puml-vscode Extension Specification — First-party VS Code extension contract.
• puml-markdown Code Fence Renderer Specification — How `puml --from-markdown` extracts and renders fenced blocks.
• puml-agent-pack Codex / Claude Plugin + MCP Specification — Agent / MCP plugin surface for Codex, Claude, and friends.