Analyze codebase relationships and inject @-mentions for traceability.
Analyzes codebase relationships and injects @-mentions into files for traceability. Use this to automatically link source code, tests, and requirements documents without manual editing.
/plugin marketplace add jmagly/ai-writing-guide/plugin install jmagly-utils-plugins-utils@jmagly/ai-writing-guideAnalyze codebase relationships and inject @-mentions for traceability.
/mention-wire # Analyze current directory
/mention-wire --dry-run # Show what would be added
/mention-wire --interactive # Approve each mention
/mention-wire --auto # Apply high-confidence mentions
/mention-wire --confidence 90 # Set confidence threshold
| Option | Default | Description |
|---|---|---|
| --target | . | Directory to analyze |
| --dry-run | false | Show proposed changes without applying |
| --interactive | false | Prompt for approval per file |
| --auto | false | Apply mentions above confidence threshold |
| --confidence | 80 | Minimum confidence % for auto mode |
Identify files and their types:
.ts, .js, .py, .go, etc.)*.test.*, *.spec.*, test_*).aiwg/**/*.md)docs/**/*.md)Detect relationships using heuristics:
| Pattern | Inferred @-mention | Confidence |
|---|---|---|
File in src/auth/ | @.aiwg/requirements/UC-*-auth*.md | 85% |
File named *test*.ts | @src/{corresponding-source}.ts | 92% |
Comment // UC-001 | @.aiwg/requirements/UC-001.md | 95% |
Comment // ADR-005 | @.aiwg/architecture/adrs/ADR-005*.md | 90% |
JSDoc @implements | Parse and validate | 98% |
| Import statement | @{imported-file} | 88% |
Output format:
src/services/auth/login.ts (confidence: 85%)
+ @.aiwg/requirements/UC-003-user-auth.md (name match)
+ @.aiwg/architecture/adrs/ADR-005-jwt-strategy.md (comment: "JWT")
test/integration/auth.test.ts (confidence: 92%)
+ @src/services/auth/login.ts (test-to-source)
+ @.aiwg/requirements/UC-003-user-auth.md (inherited from source)
Depending on mode:
--dry-run: Display only--interactive: Prompt per file--auto: Apply above thresholdAdd @-mentions to file header:
/**
* @file Authentication Service
* @implements @.aiwg/requirements/UC-003-user-auth.md
* @architecture @.aiwg/architecture/adrs/ADR-005-jwt-strategy.md
* @security @.aiwg/security/controls/authn-001.md
* @tests @test/integration/auth.test.ts
*/
Add to References section:
## References
- @.aiwg/requirements/user-stories.md - Functional requirements
- @.aiwg/architecture/software-architecture-doc.md - Architecture
# Preview what would be wired
/mention-wire --dry-run
# Wire with interactive approval
/mention-wire --interactive
# Auto-wire high confidence (>80%)
/mention-wire --auto
# Auto-wire with higher threshold
/mention-wire --auto --confidence 90
aiwg wire-mentions [--target <dir>] [--dry-run] [--interactive] [--auto]
/mention-validate - Validate @-mentions resolve/mention-lint - Lint @-mention style/mention-report - Generate traceability report/mention-conventions - Display conventionsWire @-mentions for: $ARGUMENTS