bsa-cross-reference-index

Index personas, SOPs, services, and interactions from canonical-model JSON files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill builds a comprehensive cross-reference index across all canonical models in the ACID supply chain, enabling architects, governance reviewers, and integration teams to trace relationships and dependencies across personas, SOPs, services, and companies.

Core Features & Use Cases

  • Build a Persona Index across all models to reveal home nodes, host nodes, and ownership.
  • Build an SOP Index capturing ownership, references, and cross-model usage.
  • Build a Service Index to map services to models, levels, and interconnectedness.
  • Build an Interaction Index to catalog cross-company interactions and scenarios.
  • Build a Company Connectivity Matrix to visualize connections and interaction types.
  • Output a navigable cross-reference document to docs/architecture/bsa/generated/cross-reference-index.md.
  • Provide quick-lookups for common governance and impact-analysis queries.

Quick Start

Run the cross-reference generator to index all canonical-model JSON files and emit the master index at docs/architecture/bsa/generated/cross-reference-index.md.

Frequently Asked Questions about bsa-cross-reference-index

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

FAQPage Schema
How do I generate a cross-model reference index for architecture governance?

To generate a cross-model reference index, scan canonical-model JSON files to assemble persona, SOP, service, interaction, and company connectivity maps. It outputs a navigable markdown document to docs/architecture/bsa/generated/cross-reference-index.md.

What is a cross-model reference index used for in impact assessment?

A cross-model reference index is used to trace dependencies and relationships across personas, SOPs, services, and companies. It scaffolds a navigable map enabling architects to perform governance reviews and assess change impact across canonical models.

Can I map cross-company interactions using canonical model JSON files?

Yes, you can map cross-company interactions by scanning canonical-model JSON files to catalog interaction scenarios and build a company connectivity matrix. This matrix visualizes connections and interaction types for governance-ready documentation.

How do I build a persona and SOP index across multiple canonical models?

Build a persona and SOP index by scanning canonical-model JSON files to extract home nodes, host nodes, ownership, references, and cross-model usage. It assembles these elements into a navigable index for impact analysis.

Does generating a cross-reference index require any external dependencies?

Generating a cross-reference index requires no external dependencies. It operates independently to scan canonical-model JSON files and output the navigable markdown index directly into the specified architecture directory.