Skip to main content
command

cross-reference-manager — Claude Code command: features and setup

Audit and repair references between GitHub and Linear, find orphaned links, and export mapping reports. Useful when you need to check cross-platform link consistency.

Install into Claude Code · claude-code-templates All methods and platforms ↓
npx claude-code-templates@latest --command sync/cross-reference-manager
Open on GitHub

What cross-reference-manager does

The command manages references between GitHub and Linear. It can audit mappings, find orphaned links and mismatches, repair outdated references, remove invalid entries, and consolidate duplicates. Ask it to audit, repair, map, validate, or export.

Mapping data can live in .reference-mappings.json or reference state files. The command checks GitHub CLI availability and Linear MCP connectivity and authentication, then looks for sync and reference files. Backups, rollback, and logging are part of the described data-protection workflow. Link checks may fail if the required tools are unavailable.

What it helps with

  • find orphaned GitHub–Linear references
  • detect mismatched cross-platform links
  • repair outdated mappings and remove invalid entries
  • consolidate duplicate references
  • export mapping reports and backups

Example prompts for the agent

  • Audit the references between GitHub and Linear.
  • Repair broken mappings and consolidate duplicates.
  • Show the reference map and export a report.

How to install cross-reference-manager

1claude-code-templates

npx claude-code-templates@latest --command sync/cross-reference-manager

2Manually: put the files in place

.claude/commands/cross-reference-manager.md

Call it with /cross-reference-manager. For all projects use ~/.claude/commands/

Questions about cross-reference-manager

How do I install cross-reference-manager in Claude Code?

Run npx claude-code-templates@latest --command sync/cross-reference-manager. The command file is .claude/commands/cross-reference-manager.md.

What does cross-reference-manager do?

It audits and manages links between GitHub and Linear, identifies orphaned or inconsistent references, and can repair mappings. It can also display a reference map and export reports.

Which integrations does the command check?

It checks whether GitHub CLI is available and tests Linear MCP connectivity and authentication. It also searches for mapping and reference state files.

Source text

cross-reference-manager.md · MIT
---
allowed-tools: Read, Write, Edit, Bash
argument-hint: "[action] | audit | repair | map | validate | export"
description: Manage cross-platform reference links between GitHub and Linear with integrity checking
---

# Cross-Reference Manager

Manage comprehensive cross-platform reference links with integrity validation: **$ARGUMENTS**

## Current Reference State

- GitHub CLI: !`gh --version 2>/dev/null && echo "✓ Available" || echo "⚠ Not available"`
- Linear MCP: Check Linear MCP server connectivity and authentication
- Reference database: @.reference-mappings.json or reference state files
- Link integrity: !`find . -name "*sync*" -o -name "*reference*" | wc -l` mapping files found

## Task

Implement comprehensive cross-reference management for GitHub-Linear integration:

**Management Action**: Use $ARGUMENTS to specify audit, repair, mapping, validation, or export operations

**Reference Management Framework**:
1. **Reference Database** - Initialize mapping storage, track bidirectional links, maintain sync history
2. **Integrity Auditing** - Scan cross-references, identify orphaned links, detect mismatches, validate consistency
3. **Smart Repair** - Fix broken references, update outdated links, consolidate duplicates, remove invalid entries
4. **Mapping Visualization** - Display reference networks, show connection health, highlight problems, provide statistics
5. **Deep Validation** - Verify link functionality, test bidirectional navigation, check field consistency, ensure data integrity
6. **Export & Documentation** - Generate mapping reports, create backup files, provide import instructions, maintain audit trails

**Advanced Features**: Automated orphan detection, intelligent reference reconstruction, duplicate consolidation, comprehensive validation.

**Data Protection**: Backup before modifications, transaction-based operations, rollback capabilities, comprehensive logging.

**Output**: Complete reference management system with integrity reports, repair summaries, mapping visualizations, and comprehensive cross-platform link maintenance.

© davila7 · MIT · davila7/claude-code-templates

Similar slash commands

All slash commands for Git and GitHub →

From the same set740

The whole set →

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor