skills.rest
SteveGJones
SteveGJonesCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

canonical-model-manager

Create, validate, and incrementally update canonical service domain model JSON.

3|Updated Mar 29, 2026
Search Tags:#architecture#validation#governance#modeling#json-schema#canonical-model#ai-personas
One-click install
npx skills add https://github.com/SteveGJones/jack-tar-deckhand --skill canonical-model-manager
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: canonical-model-manager
Source: https://github.com/SteveGJones/jack-tar-deckhand/tree/main/.claude/skills/canonical-model-manager
Command: npx skills add https://github.com/SteveGJones/jack-tar-deckhand --skill canonical-model-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The canonical service domain model acts as the single source of truth for services, AI Personas, actors, interactions, governance, and measurements across architectural artifacts, ensuring consistency and traceability.

Core Features & Use Cases

  • Create, validate, and incrementally update the canonical service domain model JSON for both single-company and multi-company collaboration formats.
  • Validate model integrity against the defined schema, merge discovery outputs, and support targeted incremental updates (add-service, add-persona, add-interaction, etc.).
  • Provide governance-friendly outputs that feed into diagrams, governance reviews, and cross-model validation workflows.

Quick Start

Provide discovery results to the canonical-model-manager to generate or update the canonical service domain model JSON.

Frequently Asked Questions about canonical-model-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a canonical service domain model JSON for multi-company architecture?▼

The canonical service domain model acts as a single source of truth for services, AI Personas, actors, interactions, and governance. It ensures consistency and traceability across all architectural artifacts by applying a strict schema and versioning rules.

How do I add AI personas to an existing canonical model incrementally?▼

You can incrementally add AI personas to the canonical model using targeted update commands like add-persona. The manager applies strict ID conventions and schema validation to ensure the new actors integrate cleanly without breaking existing model integrity.

Does the canonical model manager validate JSON schema integrity for architectural artifacts?▼

The manager validates the canonical model against a strict JSON schema and enforces versioning rules. It is designed specifically for both single-company and collaborative multi-company formats, ensuring domain consistency across architectural artifacts.

What is the best way to merge discovery outputs into a canonical service domain model?▼

The best way to merge discovery outputs is to feed them directly into the canonical model manager. It validates the incoming data against the schema and incrementally updates the JSON, maintaining strict ID conventions and governance-friendly outputs for architectural reviews.

Related Skills

Explore More Software Engineering Skills→
SteveGJonesSteveGJones
3

bsa-documentation-generator

Transform canonical service domain model JSON into architecture documentation.

Community
Advanced
SteveGJonesSteveGJones
3

bsa-pipeline-orchestrator

Coordinate the end-to-end BSA pipeline across canonical models into a complete architecture package.

Community
Advanced
want2betwant2bet

state-machine-transition

Adds states and transitions to Bob The Skull's finite state machine with entry/exit actions, timeouts, and events.

Community
Advanced
useblocksuseblocks
24

pharaoh-tailor-review

Validate .pharaoh tailoring files against YAML schemas and cross-file references.

Official
Advanced