Skip to content

openEHR Assistant Dev

Install id openehr-assistant-dev. Use it when you are adding guides, MCP tools, examples, or releases to the openEHR Assistant server or plugin.

/plugin install openehr-assistant-dev@cadasto

Add the marketplace first. Clinical modelling is openehr-assistant. The build fetches the README below from Cadasto/openehr-assistant-dev-plugin at the tag this catalog pins.

License: MIT Version Claude Code Cursor Keep a Changelog

Maintainer plugin for the openEHR Assistant ecosystem. It helps developers design, implement, test, document, and release new MCP tools, prompts, resources, guides, completion providers, and examples for the two sibling projects:

This is not an end-user clinical tool. For clinical modelling, archetype/template authoring, AQL, and CKM discovery, install the user-facing openehr-assistant-plugin instead. This plugin is for people building that tooling.

Table of Contents

Features

  • Guide & prompt authoring — scaffolds implementation guides and MCP prompts with the right header blocks, categories, and policy split.
  • MCP tool authoring — author/extend #[McpTool], resources, and completion providers with matching PHPUnit tests, run via the Docker dev container.
  • Example authoring — add curated worked examples in the openehr://examples/{aql|flat|structured|archetypes} namespace.
  • Release workflow — version bump, Keep-a-Changelog curation, manifest sync, and mcp ↔ plugin compatibility alignment.
  • Repo-aware — a session hook and a scout agent detect which target repo you're in and surface the applicable conventions and dev commands.

Installation

Claude Code — from the Cadasto marketplace:

/plugin marketplace add Cadasto/plugin-marketplace
/plugin install openehr-assistant-dev@cadasto

Or load a local working copy for a single session, while developing:

claude --plugin-dir /path/to/openehr-assistant-dev-plugin

Cursor — Add the plugin via Cursor's plugin flow (Git URL or local path). The repo includes a Cursor manifest at .cursor-plugin/plugin.json; skills, rules, agents, and hooks are shared with the Claude plugin.

Components

Skills

Skill Target repo Description
guide-prompt-authoring mcp Author implementation guides (resources/guides/) and MCP prompts (resources/prompts/ + src/Prompts/)
mcp-tool-authoring mcp Author/extend MCP tools, resources, and completion providers in src/, with PHPUnit tests, via the Docker dev container
example-authoring mcp Author curated worked examples in the openehr://examples/{kind}/{name} namespace
release-workflow both Version bump, CHANGELOG curation, manifest sync, and mcp ↔ plugin compatibility alignment

Agents

Agent Description
repo-conventions-scout Detects which target repo the workspace is (mcp / plugin / dev) and returns the applicable layout, conventions, and dev commands

Hooks

  • SessionStart — detects the target repo and prints the applicable dev commands plus the Docker-only reminder.

MCP wiring

This plugin does not bundle a .mcp.json. Maintainers test against a local MCP server (make up-dev exposes streamable-http on :8343, or use stdio), not the hosted production instance. Skill allowed-tools reference mcp__openehr-assistant__* tools; your host resolves them from whatever openEHR Assistant MCP server you already have configured (the user-facing plugin or a local dev instance).

To point at a local server, add an .mcp.json of your own:

{
  "mcpServers": {
    "openehr-assistant": { "type": "streamable-http", "url": "http://localhost:8343/" }
  }
}

Documentation

Doc Purpose
docs/install.md Install/update on Claude Code and Cursor
docs/testing.md Validation (scripts/validate.py) and local triggering tests
docs/versioning.md SemVer policy and release steps
docs/skill-authoring.md Skill/agent authoring conventions (the lean description pattern)

Contributing

See CONTRIBUTING.md for maintainer workflows and AGENTS.md for the full conventions used by AI assistants in this repo. Run ./scripts/validate.sh before opening a PR (it warns and skips if Python isn't installed; CI runs the full check). See CHANGELOG.md for release notes.

License

MIT License — Cadasto B.V.