Skip to content

feat(openehr-specs): add subagents and commands (0.2.0)#1

Merged
sebastian-iancu merged 2 commits into
mainfrom
feat/agents-and-commands
Jun 5, 2026
Merged

feat(openehr-specs): add subagents and commands (0.2.0)#1
sebastian-iancu merged 2 commits into
mainfrom
feat/agents-and-commands

Conversation

@sebastian-iancu

Copy link
Copy Markdown
Member

Rounds the openehr-specs plugin out from skills-only into a full workflow toolkit. Bumps the plugin to 0.2.0 (synced across both plugin manifests and both marketplace entries).

Subagents (agents/)

Context-isolated, dispatched by Claude for heavy/multi-file/verification work that would otherwise bloat the main context. Each degrades gracefully when an optional dependency is absent.

Agent Purpose Optional deps
spec-reviewer Runs the full review check catalog across an entire spec document (master.adoc + chapters + manifest.json), returns a findings report specifications-XX (+ AA_GLOBAL)
xref-auditor Verifies every {openehr_*} attribute and <<anchor>> resolves; checks cross-spec deep-link anchors against the target's Markdown twin WebFetch
identifier-grounding Adversarially fact-checks every RM/AM/BASE class/attribute a draft names against the published spec; flags invented identifiers openehr-assistant MCP or WebFetch

Commands (commands/)

User-invoked actions, marked disable-model-invocation: true so they never auto-trigger or compete with the knowledge skills.

  • /openehr-specs:amend — add an amendment-record entry (version bump, anchors, Jira refs)
  • /openehr-specs:regen-classes — regenerate class tables/diagrams via bmm-publisher (Docker)
  • /openehr-specs:publish — build a local HTML preview via the AA_GLOBAL publisher

Each command/agent references its sibling knowledge skill rather than duplicating it.

Design notes

  • Component choice by nature of work: skills = knowledge; commands = user actions; subagents = context-heavy/adversarial. Documented as a convention in AGENTS.md.
  • Auto-discovery: agents//commands/ use the default locations (no manifest path declarations — the schema rejects a string agents, and minimal-manifest is preferred).

Validation

  • scripts/validate.py extended to validate agent/command frontmatter — passes.
  • claude plugin validate passes for both the marketplace and the plugin manifest.
  • Reinstalled locally: inventory shows 0.2.0, Agents (3), and the 3 commands discovered.
  • Docs updated: AGENTS.md (structure, component-choice convention, Component Dependencies), both READMEs, and CHANGELOG (0.2.0 entry).

🤖 Generated with Claude Code

sebastian-iancu and others added 2 commits June 5, 2026 12:08
Round out the plugin from skills-only into a full workflow toolkit.

Subagents (agents/) — context-isolated, dispatched by Claude:
- spec-reviewer: runs the review check catalog across a whole spec document
- xref-auditor: verifies {openehr_*} attributes and cross-spec anchors via the
  Markdown-twin of target specs
- identifier-grounding: adversarially fact-checks RM/AM/BASE identifiers in a
  draft against the published spec (openehr-assistant MCP or .md twin)

Commands (commands/, disable-model-invocation — user-only, no trigger
competition with the knowledge skills):
- /openehr-specs:amend, :regen-classes, :publish

Each agent/command references its sibling knowledge skill rather than
duplicating it. validate.py now validates agent/command frontmatter; AGENTS,
both READMEs, and CHANGELOG updated; version bumped to 0.2.0 across both
plugin manifests and both marketplace entries.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Replace absolute local paths in the cross-references guide with links into the openEHR
repository (master), with a note to prefer a local sibling checkout when present.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@sebastian-iancu sebastian-iancu merged commit 9094fa6 into main Jun 5, 2026
1 check passed
@sebastian-iancu sebastian-iancu deleted the feat/agents-and-commands branch June 5, 2026 15:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant