AI Context for Developers

When building systems that integrate with Authoritative Data, you can give AI assistants (like Claude Code) complete knowledge of the ADM data model. This helps AI tools write correct Cypher queries, understand node relationships, and follow ADM business rules.

Quick Start

Option 1: Claude Code Plugin (Recommended)

Add the UTA marketplace (once per machine):

/plugin marketplace add united-talent-agency/adm-context-plugin

Install the plugin in your project:

/plugin install adm-context@uta-adm-tools

The plugin auto-activates on ADM-related queries and loads the complete data model context.

Plugin Commands

Once installed, you can use these commands:

Command	Description
/adm-context:adm	Fetch and load the ADM context
/adm-context:adm update	Check for updates and download if newer
/adm-context:adm info	Show local version and latest release info

Option 2: Manual Installation

Run this command in your project directory to download the ADM briefing document:

mkdir -p .claude && gh release download --repo united-talent-agency/adm-site --pattern "UTA_DATA_MODEL_BRIEFING.md" --dir .claude --clobber && mv .claude/UTA_DATA_MODEL_BRIEFING.md .claude/adm-context.md

Then add this line to your project's CLAUDE.md file:

When working with UTA Authoritative Data, read .claude/adm-context.md for the complete data model.

Prerequisites

You need the GitHub CLI (gh) installed and authenticated with access to the united-talent-agency organization.

What's Included

The ADM briefing document (~350KB) contains:

Section	Description
Introduction	Goals, architecture, Neo4j setup
Terminology	Key entity definitions (Party, Role, Client, Buyer, etc.)
Core Concepts	Client groups, music clients, events, venues, terms
Node Types	All 35+ node types with properties and labels
Relationships	All 50+ relationship types with business rules
Cypher Examples	Common query patterns

Using with Claude Code

Once ADM context is loaded, you can ask Claude to:

Write Cypher queries:

Write a Cypher query to find all active clients represented as Musicians
with their responsible agents

Understand the data model:

How is a client's external team (managers, attorneys, etc.) modeled in ADM?

Follow business rules:

What happens when I need to change a client's display name?

Build integrations:

I need to sync buyer contacts from our CRM to ADM.
What nodes and relationships should I create?

Keeping Context Updated

The ADM context file is automatically regenerated and released whenever the data model changes. To make updating easy, add this script to your package.json:

{
  "scripts": {
    "adm:update": "mkdir -p .claude && gh release download --repo united-talent-agency/adm-site --pattern \"UTA_DATA_MODEL_BRIEFING.md\" --dir .claude --clobber && mv .claude/UTA_DATA_MODEL_BRIEFING.md .claude/adm-context.md"
  }
}

Then run npm run adm:update to download the latest version.

Troubleshooting

Context not loading?

• Ensure gh CLI is installed and authenticated
• Check that .claude/ directory exists and is writable
• Verify you have access to the united-talent-agency organization

Stale context?

• Run npm run adm:update to download the latest version
• Check the "Generated" date at the top of the briefing document

Resources

• ADM Documentation - Full interactive documentation
• GitHub Repository - Source code and releases
• ADM Context Plugin - Claude Code plugin