/mention-wire

namespace: aiwg
name: mention-wire
platforms: [all]
description: Analyze codebase and inject @-mentions for traceability

@-Mention Wiring

Analyze codebase relationships and inject @-mentions for traceability.

Research Foundation

• **REF-001**: BP-9 - Traceability from requirements to code to tests
• Claude Code 2.0.43: @-mention fixes for reliable nested loading

Usage

/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

Options

| 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 |

Process

1. Scan Directory

Identify files and their types:

• Source code (`.ts`, `.js`, `.py`, `.go`, etc.)
• Test files (`*.test.*`, `*.spec.*`, `test_*`)
• SDLC artifacts (`.aiwg/**/*.md`)
• Documentation (`docs/**/*.md`)

2. Analyze Relationships

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% |

3. Generate Suggestions

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)

4. Apply Changes

Depending on mode:

• `--dry-run`: Display only
• `--interactive`: Prompt per file
• `--auto`: Apply above threshold

Placement Rules

Code Files

Add @-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
 */

Markdown Files

Add to References section:

## References

- @.aiwg/requirements/user-stories.md - Functional requirements
- @.aiwg/architecture/software-architecture-doc.md - Architecture

Examples

# 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

CLI Equivalent

aiwg wire-mentions [--target <dir>] [--dry-run] [--interactive] [--auto]

Related Commands

• `/mention-validate` - Validate @-mentions resolve
• `/mention-lint` - Lint @-mention style
• `/mention-report` - Generate traceability report
• `/mention-conventions` - Display conventions

Wire @-mentions for: $ARGUMENTS