Validate control-tags
validate control-tags - Validate @control tags against OSCAL catalog
Validates that all @control and @controls tags in feature files reference valid control IDs from the OSCAL catalog.
This ensures: - Control IDs use correct format (e.g., ac-2, au-3(1)) - Control IDs exist in the OSCAL catalog - Evidence collection can find these controls during assessment
The validation: - Discovers all Gherkin feature files in the repository - Extracts all @control: and @controls: tags - Loads the OSCAL catalog from templates/specs/risk-catalog/ - Checks that each control ID exists in the catalog - Reports invalid or missing control IDs with file locations
Notes
Expected Output:
Displays invalid or missing control IDs with file locations (path:line). Groups errors by control ID. Exit code 0 if all tags valid, 1 if invalid tags found.
Examples
See Also
Tutorials | How-to Guides | Explanation | Reference
You are here: Reference — information-oriented technical descriptions of the system.