Skip to content

/edikt:guideline:review

Review guideline language quality — checks whether team standards are specific, actionable, and written for consistent enforcement.

This is a scoped shortcut for running /edikt:gov:review targeting guidelines only.

Usage

bash
/edikt:guideline:review
/edikt:guideline:review guideline-api-response-casing

Arguments

ArgumentDescription
(none)Review all guidelines in docs/guidelines/
A guideline slug or filenameReview a specific guideline

What it checks

Each guideline directive is scored on four dimensions:

DimensionStrongVague
SpecificityNames exact patterns, formats, or locationsCould mean anything to different readers
ActionabilityOne clear action, no ambiguityNo actionable instruction
PhrasingActive voice with clear scopePassive or hedged language
TestabilityVerifiable by code review or toolingCannot be verified

When to run

  • After writing a new guideline, before it's compiled
  • Periodically — guidelines can accumulate vague language over time

What's next

Released under the Elastic License 2.0. Free to use, not for resale.