Validate @-mention style and fix common issues.
Find and fix @-mention style issues like wrong case, invalid IDs, missing prefixes, and broken paths. Use `--fix` to auto-correct common problems.
/plugin marketplace add jmagly/ai-writing-guide/plugin install jmagly-utils-plugins-utils@jmagly/ai-writing-guideValidate @-mention style and fix common issues.
/mention-lint # Lint current directory
/mention-lint --fix # Auto-fix fixable issues
/mention-lint --strict # Exit with error on any issue
/mention-lint --rules ML001,ML005 # Run specific rules only
| Option | Default | Description |
|---|---|---|
| --target | . | Directory to lint |
| --fix | false | Auto-fix fixable issues |
| --strict | false | Exit with error on any issue |
| --rules | all | Comma-separated rule IDs |
| Rule | Description | Severity | Auto-fix |
|---|---|---|---|
| ML001 | @-mention path does not exist | error | no |
| ML002 | @-mention uses wrong case | warning | yes |
| ML003 | Missing required prefix (.aiwg/, src/, test/) | warning | yes |
| ML004 | Uses deprecated path pattern | warning | yes |
| ML005 | Invalid ID format (UC-NNN, ADR-NNN) | warning | yes |
| ML006 | Duplicate @-mentions in same file | info | yes |
| ML007 | @-mention in wrong section | info | no |
| ML008 | Orphan @-mention (no back-reference) | info | no |
| ML009 | Circular @-mention chain | warning | no |
| ML010 | @-mention exceeds max depth (>3 hops) | warning | no |
src/services/auth/login.ts
L3: ML005 @.aiwg/requirements/UC-3-auth.md should be UC-003 (auto-fixable)
L5: ML001 @.aiwg/architecture/adrs/ADR-999.md does not exist
test/integration/auth.test.ts
L2: ML003 @auth/login.ts should be @src/auth/login.ts (auto-fixable)
.aiwg/architecture/software-architecture-doc.md
L45: ML008 References @.aiwg/requirements/UC-005.md but no back-reference
Summary: 4 issues (1 error, 2 warnings, 1 info)
3 auto-fixable (run with --fix)
Error: @.aiwg/requirements/UC-999.md → file not found
Not auto-fixable. Remove reference or create file.
Warning: @.aiwg/Requirements/UC-001.md should be @.aiwg/requirements/UC-001.md
Fix: Correct case to match filesystem
Warning: @auth/login.ts should be @src/auth/login.ts
Fix: Add appropriate prefix
Warning: @requirements/UC-001.md should be @.aiwg/requirements/UC-001.md
Fix: Update to current pattern
Warning: UC-3 should be UC-003 (3-digit format)
Warning: ADR-5-auth should be ADR-005-auth
Fix: Zero-pad numeric IDs
Info: @.aiwg/requirements/UC-001.md appears 3 times
Fix: Remove duplicates, keep first occurrence
aiwg mention-lint [--target <dir>] [--fix] [--strict]
/mention-wire - Add @-mentions/mention-validate - Validate @-mentions exist/mention-conventions - Display conventionsLint @-mentions for: $ARGUMENTS