mention-validate · diff
git:20260430.6d8a12e to git:20260511.8e98ff6
16 added, 3 removed. Audit A to A.
---
namespace: aiwg
name: mention-validate
platforms: [all]
description: Validate all @-mentions resolve to existing files
---
+ <!-- AIWG-SKILL-CALLOUT -->
+ > **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:
+ >
+ > ```bash
+ > 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](../../../addons/aiwg-utils/rules/skill-discovery.md).
+
+
# @-Mention Validation
Validate that all @-mentions in codebase resolve to existing files.
## Usage
```bash
/mention-validate # Validate current directory
/mention-validate --strict # Fail on any broken mention
/mention-validate --output report.md # Write report to file
```
## Options
| Option | Default | Description |
|--------|---------|-------------|
| --target | . | Directory to validate |
| --strict | false | Exit with error on broken mentions |
| --output | stdout | Write report to file |
## Process
1. **Scan** all files for @-mention patterns
2. **Extract** @-mention paths
3. **Resolve** paths relative to repo root
4. **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
```bash
aiwg validate-mentions [--target <dir>] [--strict]
```
## Related Commands
- - `/mention-wire` - Add @-mentions
- - `/mention-lint` - Lint @-mention style
- - `/mention-report` - Generate traceability report
+ - `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