plugins/utils/skills/mention-wire/SKILL.md
Analyze codebase and inject @-mentions for traceability
npx skillsauth add jmagly/aiwg mention-wireInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Analyze 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 | @$AIWG_ROOT/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%)
+ @$AIWG_ROOT/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
data-ai
Report which research-corpus radar sidecars are overdue for refresh. Computes staleness (days since last refresh vs the cadence window) for every radar, sorted most-overdue-first. Runs via `aiwg corpus radar-status`.
data-ai
Aggregate research-corpus radar sidecars into a corpus or per-cluster freshness report — totals, overdue count, per-cluster / per-GRADE / per-trajectory breakdowns, an overdue table, and per-radar rationale snippets. Runs via `aiwg corpus radar-report`.
testing
Scaffold radar/freshness sidecars for research-corpus REFs. Pulls title/authors from the citation sidecar and GRADE from the analysis doc, defaults the refresh cadence from GRADE and the cluster from a corpus-local map, and stamps documentation/radar/REF-XXX-radar.md. Runs via `aiwg corpus radar-init`.
data-ai
Compute an entity's publication trajectory — per-year paper counts, topic drift, hot-streak detection (≥3 consecutive A-grade years), and career phase. Runs via `aiwg corpus profile-temporal`.