Aiwg mention-report

Generate traceability report from @-mentions

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/agentic/code/addons/aiwg-utils/skills/mention-report" ~/.claude/skills/jmagly-aiwg-mention-report-fc37e7 && rm -rf "$T"

manifest: agentic/code/addons/aiwg-utils/skills/mention-report/SKILL.md

source content

@-Mention Traceability Report

Generate traceability report showing relationships between artifacts.

Usage

/mention-report                      # Markdown report to stdout
/mention-report --format json        # JSON format
/mention-report --format csv         # CSV for spreadsheets
/mention-report --output .aiwg/reports/traceability.md

Options

Option	Default	Description
--target	.	Directory to analyze
--format	md	Output format: md, json, csv
--output	stdout	Write to file

Report Sections

Requirements Coverage

## Requirements Coverage

| Requirement | Implemented | Tested | Documented |
|-------------|-------------|--------|------------|
| UC-001 | ✓ src/auth/ | ✓ test/auth/ | ✓ docs/ |
| UC-002 | ✓ src/api/ | ✗ | ✗ |
| UC-003 | ✗ | ✗ | ✗ |

Coverage: 67% implemented, 33% tested, 33% documented

Architecture Traceability

## Architecture Traceability

| ADR | Referenced By | Implementation |
|-----|---------------|----------------|
| ADR-001 | 3 files | src/db/ |
| ADR-002 | 5 files | src/auth/, src/api/ |
| ADR-003 | 1 file | src/cache/ |

Security Controls

## Security Control Coverage

| Control | Implementation | Verification |
|---------|----------------|--------------|
| AUTHN-001 | src/auth/middleware.ts | test/security/ |
| AUTHZ-001 | src/auth/permissions.ts | ✗ |

Dependency Graph

## Dependency Graph

UC-001 (User Authentication)
├── ADR-005-jwt-strategy.md
├── src/services/auth/
│   ├── login.ts
│   ├── logout.ts
│   └── refresh.ts
├── test/integration/auth/
└── docs/api/auth.md

JSON Format

{
  "generated": "2025-01-15T10:30:00Z",
  "summary": {
    "total_mentions": 142,
    "requirements": { "total": 15, "covered": 12 },
    "adrs": { "total": 8, "referenced": 6 }
  },
  "traceability": [
    {
      "artifact": ".aiwg/requirements/UC-001.md",
      "type": "requirement",
      "referenced_by": ["src/auth/login.ts", "test/auth/login.test.ts"],
      "coverage": { "implemented": true, "tested": true, "documented": true }
    }
  ]
}

CLI Equivalent

aiwg mention-report [--format md|json|csv] [--output <file>]

Related Commands

```
/mention-wire
```
- Add @-mentions
```
/mention-validate
```
- Validate @-mentions
```
/check-traceability
```
- Full traceability verification

Generate report 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 mention-report command
@$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md — Scan codebase before reporting
@$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/README.md — SDLC artifact structure for traceability reporting