enhance-cross-file

Parse Arguments

const args = '$ARGUMENTS'.split(' ').filter(Boolean);
const targetPath = args.find(a => !a.startsWith('--')) || '.';

Purpose

• Tools used in prompt body but not declared in frontmatter
• Agent references that don't exist
• Duplicate instructions across files (maintenance burden)
• Contradictory rules (ALWAYS vs NEVER conflicts)
• Orphaned agents not referenced by any workflow
• Skill tool mismatches (allowed-tools vs actual usage)

Workflow

1. Run Analyzer - Execute the JavaScript analyzer to get findings:
   bash

   node -e "const a = require('./lib/enhance/cross-file-analyzer.js'); console.log(JSON.stringify(a.analyze('.'), null, 2));"

   For a specific path:

   a.analyze('./plugins/enhance')

2. Parse Results - The analyzer returns JSON with

   summary

   and

   findings

3. Report - Return findings grouped by category

lib/enhance/cross-file-analyzer.js

Detection Patterns

1. Tool Consistency (MEDIUM Certainty)

tools:

# Frontmatter declares:
tools: Read, Grep

# But body uses:
Use Write({ file_path: "/out" })  # <- Not declared!

allowed-tools

2. Workflow Consistency (MEDIUM Certainty)

subagent_type: "plugin:agent-name"

3. Instruction Consistency (MEDIUM Certainty)

Output Format

## Cross-File Analysis

**Files Analyzed**: {agents} agents, {skills} skills, {commands} commands

### Tool Consistency ({n})
| Agent | Issue | Fix |
|-------|-------|-----|
| exploration-agent | Uses Write but not in tools list | Add Write to frontmatter |

### Workflow Issues ({n})
| Source | Issue | Fix |
|--------|-------|-----|
| workflow.md | References nonexistent agent | Check spelling or create agent |

### Instruction Consistency ({n})
| Instruction | Files | Fix |
|-------------|-------|-----|
| "NEVER push --force" | 4 files | Extract to CLAUDE.md |

Constraints

• All patterns are MEDIUM certainty (require context)
• No auto-fix (cross-file changes need human review)
• Skip content inside

  <bad-example>

  ,

  <bad_example>

  ,

  <badexample>

  tags
• Skip content inside code blocks with "bad" in info string
• Entry point agents (orchestrator, validator, discoverer) are not orphaned

Pattern Statistics