Case study: dev quality loop

This repository dogfoods definitively via .definitively/programs/dev-quality-loop.yml — a workflow that runs moon quality gates and LLM fix loops until the build passes or the run fails.

Overview

stateDiagram-v2
  direction LR
  idle --> lint: start
  lint --> doctor: success
  lint --> fix_lint: failure
  lint --> fix_lint: partial
  fix_lint --> lint: success
  fix_lint --> fix_lint: failure
  fix_lint --> fix_lint: retry
  doctor --> test: success
  test --> coverage: success
  coverage --> docs: success
  docs --> build: success
  build --> commit: success
  commit --> done: success

Each fix_* state runs an LLM node with a dedicated prompt file, then loops back to retry the gate.

CLI gate nodes

Each gate is a moon task:

moon_lint:
  kind: cli
  command: ["moon", "run", "definitively:lint"]
  timeout_ms: 300000
  outcome:
    success:
      - exit_code: 0
    failure:
      - exit_code: {neq: 0}
    partial:
      - exit_code: 0

LLM fix nodes

Fix nodes share a YAML anchor for cursor-agent command and outcome rules:

command: &cursor_agent
  - cursor-agent
  - agent
  - --force
  - --workspace
  - "."
  - --print
  - --output-format
  - stream-json
  - --
outcome: &llm_outcome
  success:
    - jq: '.status == "ok"'
    - signal: fix_complete
  failure:
    - timeout: true
    - signal: refused

Running it

From the definitively repo root (with moon and cursor-agent on PATH):

definitively run "$PWD/.definitively/programs/dev-quality-loop.yml"

Try it: Visualize the full graph — definitively visualize .definitively/programs/dev-quality-loop.yml.