Agent skill
mention-report
Generate traceability report from @-mentions
Install this agent skill to your Project
npx add-skill https://github.com/jmagly/aiwg/tree/main/agentic/code/addons/aiwg-utils/skills/mention-report
SKILL.md
@-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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
research-document
Generate summaries and literature notes from research papers
research-archive
Package research artifacts for long-term archival
research-cite
Format citations and generate bibliographies
induct-research
Induct research sources into a research repository. Point at an issue, a single file, a directory of papers, or a URI and the skill reads, annotates, and files structured induction tasks — one per source. Similar to address-issues but for research corpora instead of code backlogs.
research-provenance
Query provenance chains and artifact relationships
research-quality
Assess source quality using GRADE methodology
Didn't find tool you were looking for?