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:
- openehr-assistant-mcp — the openEHR Assistant MCP server.
- openehr-assistant-plugin — the user-facing Claude Code + Cursor plugin.
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.
- 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↔plugincompatibility 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.
Claude Code
claude plugin add cadasto/openehr-assistant-dev-pluginCursor — 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.
Install from a local path while developing:
claude plugin add /path/to/openehr-assistant-dev-plugin| 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 |
| Agent | Description |
|---|---|
repo-conventions-scout |
Detects which target repo the workspace is (mcp / plugin / dev) and returns the applicable layout, conventions, and dev commands |
- SessionStart — detects the target repo and prints the applicable dev commands plus the Docker-only reminder.
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, e.g.:
{
"mcpServers": {
"openehr-assistant": { "type": "streamable-http", "url": "http://localhost:8343/" }
}
}| 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) |
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.
MIT License — Cadasto B.V.