Aiwg mention-validate

Name: mention-validate
Author: jmagly

Validate all @-mentions resolve to existing files

install

source · Clone the upstream repo

git clone https://github.com/jmagly/aiwg

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agents/skills/mention-validate" ~/.claude/skills/jmagly-aiwg-mention-validate && rm -rf "$T"

manifest: .agents/skills/mention-validate/SKILL.md

source content

@-Mention Validation

Validate that all @-mentions in codebase resolve to existing files.

Usage

/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

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