Spotlight — Blog https://spotlight-rules.com/blog/ An openly-governed, maintained build of the Spectral API linter — and the Spectral ruleset format as a standalone specification that stands on its own, apart from any one tool. en Fri, 14 Aug 2026 00:00:00 +0000 The 2012 move, one layer up https://spotlight-rules.com/2026/08/14/the-2012-move-again-one-layer-up/ https://spotlight-rules.com/2026/08/14/the-2012-move-again-one-layer-up/ Fri, 14 Aug 2026 00:00:00 +0000 Swagger was a config file for a code generator until a group of people decided it was a format. This is the same move, applied to the rules that govern the descriptions. Mapping every implementation of the format https://spotlight-rules.com/2026/08/07/mapping-every-implementation-of-the-format/ https://spotlight-rules.com/2026/08/07/mapping-every-implementation-of-the-format/ Fri, 07 Aug 2026 00:00:00 +0000 The tool is one implementation among many — a claim worth nothing without a published list. So here is the list, with the evidence for every entry and a rule that maintainer corrections get merged on sight. Why splitting the Spectral spec from the tooling is the priority https://spotlight-rules.com/2026/08/03/why-the-split-comes-first/ https://spotlight-rules.com/2026/08/03/why-the-split-comes-first/ Mon, 03 Aug 2026 00:00:00 +0000 The first move after forking was not fixing the tool. It was pulling the ruleset format out of the tool entirely — because whatever gets built first becomes the definition, and because "supports Spectral" currently means eight different things nobody has words for. Twenty-seven CI runs, and not one of them a test https://spotlight-rules.com/2026/08/03/twenty-seven-ci-runs-and-not-one-of-them-a-test/ https://spotlight-rules.com/2026/08/03/twenty-seven-ci-runs-and-not-one-of-them-a-test/ Mon, 03 Aug 2026 00:00:00 +0000 A day spent on the unglamorous half of forking something — security policy, package metadata, branch protection — which turned up the fact that no test had ever run here, that the one workflow which did run belonged to somebody else, and that three things already written down were wrong. A development strategy you can actually switch to https://spotlight-rules.com/2026/07/30/a-development-strategy-you-can-switch-to/ https://spotlight-rules.com/2026/07/30/a-development-strategy-you-can-switch-to/ Thu, 30 Jul 2026 00:00:00 +0000 Branching, releases, package management, README, and communication — proposed in public before any of it is built, because a fork nobody can switch to is worthless.