bsa-documentation-generator

Transform canonical service domain model JSON into architecture documentation.

3|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/SteveGJones/jack-tar-deckhand --skill bsa-documentation-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bsa-documentation-generator
Source: https://github.com/SteveGJones/jack-tar-deckhand/tree/main/.claude/skills/bsa-documentation-generator
Command: npx skills add https://github.com/SteveGJones/jack-tar-deckhand --skill bsa-documentation-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Canonical service domain models often live in JSON and are difficult for stakeholders to read; this skill transforms those JSON models into readable architecture documentation that stays in sync with the canonical model.

Core Features & Use Cases

  • Service Catalogue generation: extract services, owners, missions, types, and relationships for viewer-friendly documentation
  • AI Persona summaries, Interaction Matrices, and Dependency Tables: generate concise summaries and matrix tables to illustrate how components interact
  • Complete Architecture Pack: assemble all generated sections into a publishable documentation package for governance and engineering teams

Quick Start

Provide one or more canonical model JSON files from docs/architecture/bsa/canonical-models to generate the documentation

Frequently Asked Questions about bsa-documentation-generator

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

FAQPage Schema
How do I generate architecture documentation from a JSON model?

Generate architecture documentation by providing canonical service domain model JSON files to extract services, owners, and relationships into readable outputs like a service catalogue and interaction matrix.

What is a canonical service domain model used for in documentation?

A canonical service domain model serves as the single source of truth in JSON format, which is transformed into readable architecture documentation such as AI persona summaries and dependency tables for stakeholder review.

How do I create an interaction matrix and dependency table from JSON?

Create an interaction matrix and dependency table by processing your canonical model JSON, which automatically extracts component relationships and interactions to generate concise matrix tables for governance teams.

Can I assemble a complete architecture pack from JSON model updates?

Yes, you can assemble a complete architecture pack from JSON model updates by generating a Service Catalogue, Actor Directory, SOP Register, and Dependency Table into a publishable documentation package.

Does this documentation generation approach work without external dependencies?

Yes, this documentation generation approach works without external dependencies, requiring only canonical model JSON files from your architecture directory to produce the complete set of readable architecture documents.