Document FinOps Require Period
document-finops-require-period
info
experience: consistencyexperience: governance
spec: document
FinOps should declare a period.
A FinOps artifact should declare a period (e.g. monthly, annual) for the budget and costs.
Rule definition
The full Spotlight rule — drop it into a ruleset (.spotlight.yaml / .spectral.yaml) and run it with any Spotlight tool.
document-finops-require-period:
title: Document FinOps Require Period
reference: https://spotlight-rules.com/spec/rules/finops/document-finops-require-period/
description: A FinOps artifact should declare a period (e.g. monthly, annual)
for the budget and costs.
message: FinOps should declare a period.
given: $
severity: info
then:
field: period
function: truthy
tags:
- format:finops
- spec:document
- experience:consistency
- experience:governance
prompt: "You are editing a FinOps document to satisfy the Spotlight API
governance rule 'document-finops-require-period' (Document FinOps Require
Period). Requirement: A FinOps artifact should declare a period (e.g.
monthly, annual) for the budget and costs. To fix: Ensure `period` is
present and non-empty at each matching location. Make the smallest change
that satisfies the rule, leave all unrelated content, key order, comments,
and formatting unchanged, and keep the document valid FinOps. Return only
the complete corrected document, with no commentary."
AI fix prompt — send this to Claude, Gemini, or ChatGPT with your artifact to auto-fix this rule
You are editing a FinOps document to satisfy the Spotlight API governance rule 'document-finops-require-period' (Document FinOps Require Period). Requirement: A FinOps artifact should declare a period (e.g. monthly, annual) for the budget and costs. To fix: Ensure `period` is present and non-empty at each matching location. Make the smallest change that satisfies the rule, leave all unrelated content, key order, comments, and formatting unchanged, and keep the document valid FinOps. Return only the complete corrected document, with no commentary.
| Artifact | FinOps |
|---|---|
| Applies at (given) | $ |
| Severity | info — educational by default; raise to warn/error to enforce |
| Reference | https://spotlight-rules.com/spec/rules/finops/document-finops-require-period/ |