Skip to content

dokugent criteria

Manage evaluation rules for agent outputs using success conditions, failure flags, and metrics.


How to Use

Interactive Wizard

dokugent criteria

Launches a step-by-step input flow for: - ✅ Success Conditions - ❌ Failure Conditions - 📊 Evaluation Metrics

Writes to a timestamped folder and symlinks it as active.

Instant Scaffold (--t)

dokugent criteria --t

Creates a blank criteria.md with section headings only. Skips the wizard. Will not overwrite if file already exists.


Flags and Parameters

Flag Description
--t Writes a blank criteria.md with just headings
--edit Opens criteria.md in your $EDITOR
--show Prints raw contents of criteria.md
--check Validates required sections + token count
--trace Prints formatted criteria view w/ validation

Criteria Commands

Trace

dokugent criteria --trace

Prints criteria.md in a sectioned format with: - Token estimate - Structural checks - Markdown section labels

Edit

dokugent criteria --edit

Opens the current criteria.md file in your terminal editor.

Show

dokugent criteria --show

Prints the full raw contents of the active criteria.md.

Check

dokugent criteria --check

Validates that required sections exist and contain at least one bullet: - Success Conditions - Failure Conditions - Evaluation Metrics

Also estimates total token count.


criteria.md Template

# CRITERIA.md

## Success Conditions
-

## Failure Conditions
-

## Evaluation Metrics
-

Folder Layout

.dokugent/data/criteria/
├── happybot@2025-05-24_19-15-55-492/
│   └── criteria.md
└── criteria → happybot@2025-05-24_19-15-55-492/