---
schema_version: 1
id: RAC-KTQ63DVDC014
type: requirement
---
# v0.2 Portfolio Stats

## Problem

RAC can currently validate and diff individual requirement files.

However, Product Managers typically manage portfolios of features rather than individual documents.

There is currently no way to understand the overall health, size, quality, or complexity of a collection of requirements.

## Requirements

[REQ-001] User can analyze a directory of requirement files
[REQ-002] Directory scanning is recursive by default
[REQ-003] User can view total feature count
[REQ-004] User can view total requirement count
[REQ-005] User can view total metric count
[REQ-006] User can view total risk count
[REQ-007] User can identify invalid files
[REQ-008] User can identify features missing metrics
[REQ-009] User can identify features missing risks
[REQ-010] User can view largest features by requirement count
[REQ-011] User can export results as JSON
[REQ-012] Valid files are analyzed even when invalid files exist

## Success Metrics

- Stats command executes against 100 files in under 5 seconds
- Stats command used against RAC roadmap repository
- JSON output successfully consumed by another script

## Risks

- Recursive scanning may impact performance
- Large repositories may produce noisy output
- Invalid files may skew statistics if not handled consistently
