| namespace | aiwg |
| name | mention-validate |
| platforms | ["all"] |
| description | Validate all @-mentions resolve to existing files |
Skill access pattern (post-kernel-pivot, 2026.5+)
Skill names referenced in this document are AIWG skills, not slash commands. Most are not kernel-listed and cannot be invoked as /skill-name by the platform. Reach them via:
aiwg discover "<capability>"
aiwg show skill <name>
Only kernel-listed skills (aiwg-doctor, aiwg-refresh, aiwg-status, aiwg-help, use, steward) are directly invokable as slash commands. See skill-discovery rule.
@-Mention Validation
Validate that all @-mentions in codebase resolve to existing files.
Usage
/mention-validate
/mention-validate --strict
/mention-validate --output report.md
Options
| Option | Default | Description |
|---|
| --target | . | Directory to validate |
| --strict | false | Exit with error on broken mentions |
| --output | stdout | Write report to file |
Process
- Scan all files for @-mention patterns
- Extract @-mention paths
- Resolve paths relative to repo root
- Report broken/valid mentions
Output Format
@-Mention Validation Report
===========================
✓ Valid Mentions: 42
✗ Broken Mentions: 3
Broken Mentions:
src/auth/login.ts:5
@.aiwg/requirements/UC-999.md → NOT FOUND
.aiwg/architecture/sad.md:23
@.aiwg/requirements/NFR-PERF-005.md → NOT FOUND
test/integration/api.test.ts:12
@$AIWG_ROOT/src/services/api-old.ts → NOT FOUND (deleted?)
Summary: 3 broken mentions in 3 files
Exit Codes
| Code | Meaning |
|---|
| 0 | All mentions valid |
| 1 | Broken mentions found (with --strict) |
CLI Equivalent
aiwg validate-mentions [--target <dir>] [--strict]
Related Commands
mention-wire - Add @-mentions
mention-lint - Lint @-mention style
mention-report - Generate traceability report
Validate @-mentions for: $ARGUMENTS
References
- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/README.md — aiwg-utils addon overview
- @$AIWG_ROOT/docs/cli-reference.md — CLI reference for validate-mentions command
- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md — Verify before reporting validity
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/README.md — SDLC artifact paths validated by this skill